Documentation for the code scaffolding

docs/api.rst

@@ -0,0 +1,13 @@
+API Documentation
+=================
+
+.. py:module:: elasticsearch
+
+.. autoclass:: Elasticsearch
+
+.. autoclass:: Transport
+
+.. autoclass:: ConnectionPool
+
+.. autoclass:: Connection
+

docs/conf.py

@@ -27,6 +27,8 @@ import sys, os
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest']
 
+autoclass_content = "init"
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 

docs/index.rst

@@ -1,6 +1,11 @@
 Python Elasticsearch Client
 ===========================
 
+Official low-level client for Elasticsearch. It's goal is to provide common
+ground for all Elasticsearch-related code in Python; because of this it tries
+to be opinion-free and very extendable.
+
+
 Example Usage
 -------------
 
@@ -45,11 +50,13 @@ Example Usage
     Got 1 Hits:
     2010-10-10T10:10:10 kimchy: Elasticsearch: cool. bonsai cool.
     
-Contents:
+Contents
+--------
 
 .. toctree::
    :maxdepth: 2
 
+   api
 
 License
 -------