Adding updates to index, other docs

These updates are to get the manuals compiling and showing on the main
pages.

There is still some signigicant work to do with updating references and
such, but it's already well on its way.

api/astrodata.rst

@@ -0,0 +1,82 @@
+astrodata package
+=================
+
+.. automodule:: astrodata
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+astrodata.core module
+---------------------
+
+.. automodule:: astrodata.core
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.factory module
+------------------------
+
+.. automodule:: astrodata.factory
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.fits module
+---------------------
+
+.. automodule:: astrodata.fits
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.nddata module
+-----------------------
+
+.. automodule:: astrodata.nddata
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.provenance module
+---------------------------
+
+.. automodule:: astrodata.provenance
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.testing module
+------------------------
+
+.. automodule:: astrodata.testing
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.utils module
+----------------------
+
+.. automodule:: astrodata.utils
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.version module
+------------------------
+
+.. automodule:: astrodata.version
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+astrodata.wcs module
+--------------------
+
+.. automodule:: astrodata.wcs
+   :members:
+   :undoc-members:
+   :show-inheritance:

docs/api_short.rst

@@ -0,0 +1,13 @@
+Common API for Users
+====================
+
+This package contains the common API for users of the AstroData system. It
+provides a single interface to the data, regardless of the format in which it
+is stored.
+
+If you would like a more extensive description of the astrodata package as a
+user, see the |UserGuide|. If you are interested in developing with AstroData,
+see the |DeveloperGuide|.
+
+.. automodapi:: astrodata
+    :no-inheritance-diagram:

docs/index.rst

@@ -7,8 +7,9 @@ This is the documentation for astrodata.
    :maxdepth: 2
    :caption: Contents:
 
-.. automodapi:: astrodata
-   :no-inheritance-diagram:
+   manuals/index
+   api_short
+
 
 Indices and tables
 ==================

docs/manuals/api.rst

@@ -8,4 +8,3 @@ Reference API
    :maxdepth: 1
 
    api/astrodata
-   api/gemini_instruments