documentation reorg

Author: miguelgrinberg

docs/api.rst

@@ -8,35 +8,21 @@ The :ref:`Asynchronous API <async_api>` classes are documented separately.
 
 .. py:module:: elasticsearch_dsl
 
-Search
-------
-
 .. autoclass:: Search
    :members:
 
 .. autoclass:: MultiSearch
    :members:
 
-Document
---------
-
 .. autoclass:: Document
    :members:
 
-Index
------
-
 .. autoclass:: Index
    :members:
 
-Faceted Search
---------------
-
 .. autoclass:: FacetedSearch
    :members:
 
-Update By Query 
-----------------
 .. autoclass:: UpdateByQuery
   :members:
 

docs/async_api.rst

@@ -1,16 +1,13 @@
 .. _async_api:
 
-Asynchronous API 
-================
+Asynchronous API Documentation
+==============================
 
 Below please find the documentation for the asychronous classes of ``elasticsearch_dsl``.
 
 .. py:module:: elasticsearch_dsl
    :no-index:
 
-Search
-------
-
 .. autoclass:: AsyncSearch
    :inherited-members:
    :members:
@@ -19,30 +16,18 @@ Search
    :inherited-members:
    :members:
 
-Document
---------
-
 .. autoclass:: AsyncDocument
    :inherited-members:
    :members:
 
-Index
------
-
 .. autoclass:: AsyncIndex
    :inherited-members:
    :members:
 
-Faceted Search
---------------
-
 .. autoclass:: AsyncFacetedSearch
    :inherited-members:
    :members:
 
-Update By Query 
-----------------
-
 .. autoclass:: AsyncUpdateByQuery
    :inherited-members:
    :members:

docs/howtos.rst

@@ -0,0 +1,11 @@
+How-To Guides
+=============
+
+.. toctree::
+   :maxdepth: 2
+
+   search_dsl
+   persistence
+   faceted_search
+   update_by_query
+   asyncio