diff --git a/docs/api/index.rst b/docs/api/index.rst
new file mode 100644
index 0000000..336a1f2
--- /dev/null
+++ b/docs/api/index.rst
@@ -0,0 +1,12 @@
+
+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
diff --git a/docs/api/wuttjamaican.app.rst b/docs/api/wuttjamaican/app.rst
similarity index 100%
rename from docs/api/wuttjamaican.app.rst
rename to docs/api/wuttjamaican/app.rst
diff --git a/docs/api/wuttjamaican.auth.rst b/docs/api/wuttjamaican/auth.rst
similarity index 100%
rename from docs/api/wuttjamaican.auth.rst
rename to docs/api/wuttjamaican/auth.rst
diff --git a/docs/api/wuttjamaican.cli.base.rst b/docs/api/wuttjamaican/cli.base.rst
similarity index 100%
rename from docs/api/wuttjamaican.cli.base.rst
rename to docs/api/wuttjamaican/cli.base.rst
diff --git a/docs/api/wuttjamaican.cli.make_uuid.rst b/docs/api/wuttjamaican/cli.make_uuid.rst
similarity index 100%
rename from docs/api/wuttjamaican.cli.make_uuid.rst
rename to docs/api/wuttjamaican/cli.make_uuid.rst
diff --git a/docs/api/wuttjamaican.cli.rst b/docs/api/wuttjamaican/cli.rst
similarity index 100%
rename from docs/api/wuttjamaican.cli.rst
rename to docs/api/wuttjamaican/cli.rst
diff --git a/docs/api/wuttjamaican.conf.rst b/docs/api/wuttjamaican/conf.rst
similarity index 100%
rename from docs/api/wuttjamaican.conf.rst
rename to docs/api/wuttjamaican/conf.rst
diff --git a/docs/api/wuttjamaican.db.conf.rst b/docs/api/wuttjamaican/db.conf.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.conf.rst
rename to docs/api/wuttjamaican/db.conf.rst
diff --git a/docs/api/wuttjamaican.db.model.auth.rst b/docs/api/wuttjamaican/db.model.auth.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.model.auth.rst
rename to docs/api/wuttjamaican/db.model.auth.rst
diff --git a/docs/api/wuttjamaican.db.model.base.rst b/docs/api/wuttjamaican/db.model.base.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.model.base.rst
rename to docs/api/wuttjamaican/db.model.base.rst
diff --git a/docs/api/wuttjamaican.db.model.rst b/docs/api/wuttjamaican/db.model.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.model.rst
rename to docs/api/wuttjamaican/db.model.rst
diff --git a/docs/api/wuttjamaican.db.model.upgrades.rst b/docs/api/wuttjamaican/db.model.upgrades.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.model.upgrades.rst
rename to docs/api/wuttjamaican/db.model.upgrades.rst
diff --git a/docs/api/wuttjamaican.db.rst b/docs/api/wuttjamaican/db.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.rst
rename to docs/api/wuttjamaican/db.rst
diff --git a/docs/api/wuttjamaican.db.sess.rst b/docs/api/wuttjamaican/db.sess.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.sess.rst
rename to docs/api/wuttjamaican/db.sess.rst
diff --git a/docs/api/wuttjamaican.db.util.rst b/docs/api/wuttjamaican/db.util.rst
similarity index 100%
rename from docs/api/wuttjamaican.db.util.rst
rename to docs/api/wuttjamaican/db.util.rst
diff --git a/docs/api/wuttjamaican.email.handler.rst b/docs/api/wuttjamaican/email.handler.rst
similarity index 100%
rename from docs/api/wuttjamaican.email.handler.rst
rename to docs/api/wuttjamaican/email.handler.rst
diff --git a/docs/api/wuttjamaican.email.message.rst b/docs/api/wuttjamaican/email.message.rst
similarity index 100%
rename from docs/api/wuttjamaican.email.message.rst
rename to docs/api/wuttjamaican/email.message.rst
diff --git a/docs/api/wuttjamaican.email.rst b/docs/api/wuttjamaican/email.rst
similarity index 100%
rename from docs/api/wuttjamaican.email.rst
rename to docs/api/wuttjamaican/email.rst
diff --git a/docs/api/wuttjamaican.enum.rst b/docs/api/wuttjamaican/enum.rst
similarity index 100%
rename from docs/api/wuttjamaican.enum.rst
rename to docs/api/wuttjamaican/enum.rst
diff --git a/docs/api/wuttjamaican.exc.rst b/docs/api/wuttjamaican/exc.rst
similarity index 100%
rename from docs/api/wuttjamaican.exc.rst
rename to docs/api/wuttjamaican/exc.rst
diff --git a/docs/api/wuttjamaican/index.rst b/docs/api/wuttjamaican/index.rst
new file mode 100644
index 0000000..1f8456b
--- /dev/null
+++ b/docs/api/wuttjamaican/index.rst
@@ -0,0 +1,33 @@
+
+``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
diff --git a/docs/api/wuttjamaican.install.rst b/docs/api/wuttjamaican/install.rst
similarity index 100%
rename from docs/api/wuttjamaican.install.rst
rename to docs/api/wuttjamaican/install.rst
diff --git a/docs/api/wuttjamaican.people.rst b/docs/api/wuttjamaican/people.rst
similarity index 100%
rename from docs/api/wuttjamaican.people.rst
rename to docs/api/wuttjamaican/people.rst
diff --git a/docs/api/wuttjamaican.progress.rst b/docs/api/wuttjamaican/progress.rst
similarity index 100%
rename from docs/api/wuttjamaican.progress.rst
rename to docs/api/wuttjamaican/progress.rst
diff --git a/docs/api/wuttjamaican.testing.rst b/docs/api/wuttjamaican/testing.rst
similarity index 100%
rename from docs/api/wuttjamaican.testing.rst
rename to docs/api/wuttjamaican/testing.rst
diff --git a/docs/api/wuttjamaican.util.rst b/docs/api/wuttjamaican/util.rst
similarity index 100%
rename from docs/api/wuttjamaican.util.rst
rename to docs/api/wuttjamaican/util.rst
diff --git a/docs/index.rst b/docs/index.rst
index 78f11aa..1e9e36b 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -30,54 +30,24 @@ Features
 
 See also these projects which build on WuttJamaican:
 
-* `WuttaWeb <https://rattailproject.org/docs/wuttaweb/>`_ - web app
-  framework
-* `WuttaSync <https://rattailproject.org/docs/wuttasync/>`_ - data
-  import/export and real-time sync
-* :doc:`wutta-continuum:index` - data versioning with
-  SQLAchemy-Continuum
+* :doc:`wutta-continuum:index`
+* `WuttaWeb <https://rattailproject.org/docs/wuttaweb/>`_
 
 
 Contents
 --------
 
 .. toctree::
-   :maxdepth: 2
-   :caption: Documentation
+   :maxdepth: 3
 
    glossary
-   narr/install/index
-   narr/config/index
-   narr/cli/index
-   narr/handlers/index
-   narr/providers/index
-   narr/db/index
+   narr/index
+   api/index
 
-.. toctree::
-   :maxdepth: 1
-   :caption: API
 
-   api/wuttjamaican.app
-   api/wuttjamaican.auth
-   api/wuttjamaican.cli
-   api/wuttjamaican.cli.base
-   api/wuttjamaican.cli.make_uuid
-   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
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/docs/narr/index.rst b/docs/narr/index.rst
new file mode 100644
index 0000000..47624eb
--- /dev/null
+++ b/docs/narr/index.rst
@@ -0,0 +1,13 @@
+
+Documentation
+=============
+
+.. toctree::
+   :maxdepth: 2
+
+   install/index
+   config/index
+   cli/index
+   handlers/index
+   providers/index
+   db/index
diff --git a/src/wuttjamaican/db/model/__init__.py b/src/wuttjamaican/db/model/__init__.py
index b0c5255..d623775 100644
--- a/src/wuttjamaican/db/model/__init__.py
+++ b/src/wuttjamaican/db/model/__init__.py
@@ -25,14 +25,9 @@ Data Models
 
 This is the default :term:`app model` module.
 
-This namespace exposes the following:
+The ``wuttjamaican.db.model`` namespace contains 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`
@@ -42,6 +37,7 @@ And the :term:`data models <data model>`:
 * :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