tweaks to look and feel of autodoc

nicolaskruchten · nicolaskruchten · commit 2dc791eba924 · 2019-11-10T13:56:23.000-05:00
diff --git a/apidoc/_static/plotly-style.css b/apidoc/_static/plotly-style.css
@@ -11,3 +11,19 @@
 .body {
     font-family: "Open Sans", sans-serif;
 }
+.navbar-brand img {
+    height: 30px;
+    margin-top: 4px;
+}
+
+.navbar .container {
+    padding-top: 8px;
+}
+
+a {
+    color: #2391fe !important;
+}
+
+code {
+    color: #2391fe !important;
+}
diff --git a/apidoc/figure_factory.rst b/apidoc/figure_factory.rst
@@ -1,6 +1,6 @@
 .. _ff:
 
-Figure Factory
+`plotly.figure_factory`: helper methods for building specific complex charts
 ==============
 
 .. currentmodule:: plotly.figure_factory
@@ -23,6 +23,6 @@ Figure Factory
    create_streamline
    create_table
    create_ternary_contour
-   create_trisurf           
+   create_trisurf
    create_violin
 
diff --git a/apidoc/graph_objects.rst b/apidoc/graph_objects.rst
@@ -1,6 +1,6 @@
 .. _graph-objects:
 
-Graph objects: figures, traces and layout
+`plotly.graph_objects`: low-level interface to figures, traces and layout
 =========================================
 
 .. currentmodule:: plotly.graph_objects
@@ -11,12 +11,14 @@ Graph objects: figures, traces and layout
 
    >>> import plotly.graph_objects as go
 
-.. toctree::
-   :maxdepth: 1
-   :caption: Figure:
+Figure
+------
 
-   figure.rst
+.. autosummary::
+   :toctree: generated/
+   :template: trace.rst
 
+   Figure
 
 Layout
 ------
diff --git a/apidoc/index.rst b/apidoc/index.rst
@@ -3,7 +3,7 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-plotly API reference
+Python API reference for `plotly`
 ====================
 
 This is the reference of plotly's API. Also see `plotly's documentation website <https://plot.ly/python>`_.
@@ -12,11 +12,11 @@ Submodules
 ----------
 
 
-* :ref:`Plotly express <px>`
-* :ref:`Graph objects: figures, traces and layout <graph-objects>`
-* :ref:`Subplots <subplots>`
-* :ref:`Figure Factory <ff>`
-* :ref:`I/O <io>`
+* :ref:`Plotly Express: high-level interface for data visualization <px>`
+* :ref:`Graph Objects: low-level interface to figures, traces and layout <graph-objects>`
+* :ref:`Subplots: helper function for layout out multi-plot figures <subplots>`
+* :ref:`Figure Factories: helper methods for building specific complex charts <ff>`
+* :ref:`I/O: low-level interface for displaying, reading and writing figures <io>`
 
 Full reference list
 -------------------
diff --git a/apidoc/io.rst b/apidoc/io.rst
@@ -1,6 +1,6 @@
 .. _io:
 
-I/O
+`plotly.io`: low-level interface for displaying, reading and writing figures
 ==============
 
 .. currentmodule:: plotly.io
diff --git a/apidoc/px.rst b/apidoc/px.rst
@@ -1,6 +1,6 @@
 .. _px:
 
-Plotly express: `plotly.express`
+`plotly.express`: high-level interface for data visualization
 ================================
 
 The `plotly.express <https://plot.ly/python/plotly-express/>`_ module is
diff --git a/apidoc/subplots.rst b/apidoc/subplots.rst
@@ -1,6 +1,6 @@
 .. _subplots:
 
-Subplots: `plotly.subplots`
+`plotly.subplots`: helper function for layout out multi-plot figures
 ===========================
 
 .. currentmodule:: plotly.subplots
