docs: rearrange API docs per conventions used elsewhere

e.g. in WuttaSync..this convention is better i think..?

docs/api/index.rst

@@ -1,12 +0,0 @@
-
-Package API
-===========
-
-This is the "raw" API documentation for the ``wuttjamaican`` package.  It hopefully
-contains all pertinent info regarding available functions, classes and their
-attributes and method signatures etc.
-
-.. toctree::
-   :maxdepth: 2
-
-   wuttjamaican/index

docs/api/wuttjamaican/index.rst

@@ -1,33 +0,0 @@
-
-``wuttjamaican``
-================
-
-.. automodule:: wuttjamaican
-
-.. toctree::
-   :maxdepth: 1
-
-   app
-   auth
-   cli
-   cli.base
-   cli.make_uuid
-   conf
-   db
-   db.conf
-   db.model
-   db.model.auth
-   db.model.base
-   db.model.upgrades
-   db.sess
-   db.util
-   email
-   email.handler
-   email.message
-   enum
-   exc
-   install
-   people
-   progress
-   testing
-   util

docs/index.rst

@@ -30,24 +30,54 @@ Features
 
 See also these projects which build on WuttJamaican:
 
-* :doc:`wutta-continuum:index`
+* `WuttaWeb <https://rattailproject.org/docs/wuttaweb/>`_ - web app
-* `WuttaWeb <https://rattailproject.org/docs/wuttaweb/>`_
+  framework
+* `WuttaSync <https://rattailproject.org/docs/wuttasync/>`_ - data
+  import/export and real-time sync
+* :doc:`wutta-continuum:index` - data versioning with
+  SQLAchemy-Continuum
 
 
 Contents
 --------
 
 .. toctree::
-   :maxdepth: 3
+   :maxdepth: 2
+   :caption: Documentation
 
    glossary
-   narr/index
+   narr/install/index
-   api/index
+   narr/config/index
+   narr/cli/index
+   narr/handlers/index
+   narr/providers/index
+   narr/db/index
 
+.. toctree::
+   :maxdepth: 1
+   :caption: API
 
-Indices and tables
+   api/wuttjamaican.app
-==================
+   api/wuttjamaican.auth
-
+   api/wuttjamaican.cli
-* :ref:`genindex`
+   api/wuttjamaican.cli.base
-* :ref:`modindex`
+   api/wuttjamaican.cli.make_uuid
-* :ref:`search`
+   api/wuttjamaican.conf
+   api/wuttjamaican.db
+   api/wuttjamaican.db.conf
+   api/wuttjamaican.db.model
+   api/wuttjamaican.db.model.auth
+   api/wuttjamaican.db.model.base
+   api/wuttjamaican.db.model.upgrades
+   api/wuttjamaican.db.sess
+   api/wuttjamaican.db.util
+   api/wuttjamaican.email
+   api/wuttjamaican.email.handler
+   api/wuttjamaican.email.message
+   api/wuttjamaican.enum
+   api/wuttjamaican.exc
+   api/wuttjamaican.install
+   api/wuttjamaican.people
+   api/wuttjamaican.progress
+   api/wuttjamaican.testing
+   api/wuttjamaican.util

docs/narr/index.rst

@@ -1,13 +0,0 @@
-
-Documentation
-=============
-
-.. toctree::
-   :maxdepth: 2
-
-   install/index
-   config/index
-   cli/index
-   handlers/index
-   providers/index
-   db/index