Add groupby and column APIs to html docs, and add rst templates

The Sphinx templates help with better styling of methods/attrs

Author: rgommers

spec/API_specification/column_object.rst

@@ -0,0 +1,23 @@
+.. _column-object:
+
+Column object
+=============
+
+A conforming implementation of the dataframe API standard must provide and
+support a column object having the following attributes and methods.
+
+-------------------------------------------------
+
+Methods
+-------
+TODO
+
+..
+  NOTE: please keep the methods in alphabetical order
+
+    .. currentmodule:: dataframe_api
+
+    .. autosummary::
+       :toctree: generated
+   :template: property.rst
+

spec/API_specification/groupby_object.rst

@@ -0,0 +1,31 @@
+.. _groupby-object:
+
+Groupby object
+==============
+
+A conforming implementation of the dataframe API standard must provide and
+support a groupby object having the following attributes and methods.
+
+-------------------------------------------------
+
+Methods
+-------
+..
+  NOTE: please keep the methods in alphabetical order
+
+.. currentmodule:: dataframe_api
+
+.. autosummary::
+   :toctree: generated
+   :template: property.rst
+
+   GroupBy.all
+   GroupBy.any
+   GroupBy.max
+   GroupBy.min
+   GroupBy.mean
+   GroupBy.median
+   GroupBy.prod
+   GroupBy.std
+   GroupBy.sum
+   GroupBy.var

spec/API_specification/index.rst

@@ -5,6 +5,8 @@ API specification
 
 .. toctree::
    :caption: API specification
-   :maxdepth: 1
+   :maxdepth: 3
 
    dataframe_object
+   column_object
+   groupby_object

spec/_templates/attribute.rst

@@ -0,0 +1,5 @@
+.. currentmodule:: {{ module }}
+
+{{ name.split('.')[-1] | underline }}
+
+.. autodata:: {{ name }}

spec/_templates/method.rst

@@ -0,0 +1,5 @@
+.. currentmodule:: {{ module }}
+
+{{ name.split('.')[-1] | underline }}
+
+.. autofunction:: {{ name }}

spec/_templates/property.rst

@@ -0,0 +1,5 @@
+.. currentmodule:: {{ module }}
+
+{{ name.split('.')[-1] | underline }}
+
+.. auto{{ objtype }}:: {{ objname }}