building docs from docstrings

Author: gvwilson

mkdocs.yml

@@ -1,8 +1,25 @@
 site_name: "Plotly.py Docs"
 docs_dir: pages
 site_dir: docs
+
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            docstring_style: google
+            show_source: false
+            show_root_heading: true
+            show_root_toc_entry: true
+            merge_init_into_class: true
+
 nav:
 - Home: index.md
+- API Reference:
+  - plotly: reference/plotly.md
+  - plotly.graph_objects: reference/graph_objects.md
+  - plotly.express: reference/express.md
 - Project:
   - license.md
   - conduct.md

pages/reference/express.md

@@ -0,0 +1,3 @@
+# Plotly Express
+
+::: plotly.express

pages/reference/graph_objects.md

@@ -0,0 +1,3 @@
+# Graph Objects
+
+::: plotly.graph_objects

pages/reference/plotly.md

@@ -0,0 +1,3 @@
+# Plotly API Reference
+
+::: plotly