Add API reference documentation

Author: SylvainCorlay

.gitignore

@@ -52,6 +52,7 @@ coverage.xml
 
 # Sphinx documentation
 docs/_build/
+docs/source/_generate/
 
 # PyBuilder
 target/

docs/source/api_documentation.rst

@@ -1,4 +1,22 @@
 API Reference Documentation
 ---------------------------
 
-.. automodule:: traittypes
+The ``SciType`` trait type is the base trait type for all Scipy trait types.
+
+It complements the ``traitlets.TraitType`` with a special API to register custom
+validators.
+
+.. autoclass:: traittypes.traittypes.SciType
+   :members:
+
+The ``Array`` trait type holds a numpy Array.
+
+.. autoclass:: traittypes.traittypes.Array
+
+The ``DataFrame`` trait type holds a pandas DataFrame.
+
+.. autoclass:: traittypes.traittypes.DataFrame
+
+The ``Series`` trait type holds a pandas Series.
+
+.. autoclass:: traittypes.traittypes.Series

docs/source/index.rst

@@ -6,6 +6,4 @@ traittypes: Trait Types for Scientific Python
 
    introduction
    usage
-
-..
    api_documentation

traittypes/traittypes.py

@@ -5,7 +5,7 @@
 
 class SciType(TraitType):
 
-    """A base traittype for numpy arrays, pandas dataframes and series."""
+    """A base trait type for numpy arrays, pandas dataframes and series."""
 
     def valid(self, *validators):
         """
@@ -24,7 +24,8 @@ def valid(self, *validators):
         Example
         -------
 
-        .. code-block:: python
+        .. code:: python
+
             # Test with a shape constraint
             def shape(*dimensions):
                 def validator(trait, value):