Fix last warnings, and include Column in the same way as DataFrame

Author: rgommers

spec/API_specification/column_object.rst

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

spec/API_specification/dataframe_api/column_object.py

@@ -1,2 +1,13 @@
+__all__ = ['Column']
+
+
 class Column:
+    """
+    Column object
+
+    Note that this column object is not meant to be instantiated directly by
+    users of the library implementing the dataframe API standard. Rather, use
+    constructor functions or an already-created dataframe object retrieved via
+
+    """
     pass

spec/API_specification/dataframe_api/dataframe_object.py

@@ -14,7 +14,7 @@ class DataFrame:
     """
     DataFrame object
 
-    Note that this DataFrame object is not meant to be instantiated directly by
+    Note that this dataframe object is not meant to be instantiated directly by
     users of the library implementing the dataframe API standard. Rather, use
     constructor functions or an already-created dataframe object retrieved via
     
@@ -31,6 +31,8 @@ class DataFrame:
     In-place operators must not be supported. All operations on the dataframe
     object are out-of-place.
 
+    **Methods and Attributes**
+
     """
     @property
     def dataframe(self) -> object:

spec/API_specification/index.rst

@@ -4,7 +4,6 @@ API specification
 .. currentmodule:: dataframe_api
 
 .. toctree::
-   :caption: API specification
    :maxdepth: 3
 
    dataframe_object