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

src/wuttjamaican/db/model/__init__.py

@@ -25,9 +25,14 @@ Data Models
 
 This is the default :term:`app model` module.
 
-The ``wuttjamaican.db.model`` namespace contains the following:
+This namespace exposes the following:
 
 * :class:`~wuttjamaican.db.model.base.Base`
+* :func:`~wuttjamaican.db.util.uuid_column()`
+* :func:`~wuttjamaican.db.util.uuid_fk_column()`
+
+And the :term:`data models <data model>`:
+
 * :class:`~wuttjamaican.db.model.base.Setting`
 * :class:`~wuttjamaican.db.model.base.Person`
 * :class:`~wuttjamaican.db.model.auth.Role`
@@ -37,7 +42,6 @@ The ``wuttjamaican.db.model`` namespace contains the following:
 * :class:`~wuttjamaican.db.model.upgrades.Upgrade`
 """
 
-# TODO: remove these
 from wuttjamaican.db.util import uuid_column, uuid_fk_column
 
 from .base import Base, Setting, Person