added subplots + a few sentences

emmanuelle · emmanuelle · commit c600541fc220 · 2019-10-08T23:00:19.000-04:00
diff --git a/apidoc/graph_objects.rst b/apidoc/graph_objects.rst
@@ -3,6 +3,13 @@ Graph objects: figures, traces and layout
 
 .. currentmodule:: plotly.graph_objects
 
+:mod:`plotly.graph_objects` contains the building blocks of plotly :class:`Figure`: traces
+(:class:`Scatter`, :class:`Bar`, ...) and :class:`Layout`
+::
+
+   >>> import plotly.graph_objects as go
+
+
 Classes
 
 .. autosummary::
diff --git a/apidoc/index.rst b/apidoc/index.rst
@@ -3,15 +3,18 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to plotly's documentation!
-==================================
+plotly API reference
+====================
+
+This is the reference of plotly's API. Also see `plotly's documentation website <https://plot.ly/python>`_.
 
 .. toctree::
    :maxdepth: 2
    :caption: Contents:
 
    px.rst
    graph_objects.rst
+   subplots.rst
    figure_factory.rst
    io.rst
    colors.rst
diff --git a/apidoc/px.rst b/apidoc/px.rst
@@ -1,5 +1,10 @@
-Plotly express
-==============
+Plotly express: `plotly.express`
+================================
+
+The `plotly.express <https://plot.ly/python/plotly-express/>`_ module is
+plotly's high-level API for rapid figure generation. ::
+
+   >>> import plotly.express as px
 
 .. currentmodule:: plotly.express
 
diff --git a/apidoc/subplots.rst b/apidoc/subplots.rst
@@ -0,0 +1,12 @@
+Subplots: `plotly.subplots`
+===========================
+
+.. currentmodule:: plotly.subplots
+
+.. autosummary::
+
+    make_subplots
+
+
+.. autofunction:: plotly.subplots.make_subplots
+
