docs: improve docs relating to app db, setup thereof

docs/narr/install/pkg.rst

@@ -8,9 +8,15 @@ To install the :term:`package` into your :term:`virtual environment`:
 
    pip install WuttJamaican
 
-Please also see
-:doc:`packaging:guides/installing-using-pip-and-virtual-environments`
-in upstream docs.
+Note that the above is only for basic config/app system and CLI.  If
+you also want an :term:`app database` then add the 'db' extra:
+
+.. code-block:: sh
+
+   pip install WuttJamaican[db]
+
+For more general info see
+:doc:`packaging:guides/installing-using-pip-and-virtual-environments`.
 
 
 Sanity Check

docs/narr/install/prereqs.rst

@@ -8,11 +8,7 @@ Wuttjamaican requires Python, and optionally a database of some sort.
 Python
 ------
 
-Currently at least Python 3.6 is required, however:
-
-As of writing only Python 3.8 and newer are supported by the official
-Python team, so that is strongly recommended.  It is likely that will
-soon become the minimum requirement for WuttJamaican as well.
+Currently at least Python 3.8 is required.
 
 Also note, Python 3.11 is the newest version being tested so far.
 
@@ -22,15 +18,8 @@ See also https://endoflife.date/python
 Database
 --------
 
-There is not yet much logic in WuttJamaican which pertains to the
-:term:`app database` so we will not document much about that here
-either.
+If you need an :term:`app database` then you will also need the
+backend and/or libraries to support that.
 
-For now just know that in a production environment, PostgreSQL is
-recommended for the DB backend.  So install that if you want to be
-certain of a good experience.
-
-But technically speaking, anything supported by `SQLAlchemy`_ should
-work.  See also :doc:`/narr/config/table`.
-
-.. _SQLAlchemy: https://www.sqlalchemy.org
+The recommendation is to use PostgreSQL but this is further documented
+elsewhere; see :ref:`create-appdb`.

docs/narr/install/quickstart.rst

@@ -30,7 +30,8 @@ Make and activate a new :term:`virtual environment` for your project:
    python3 -m venv poser
    source poser/bin/activate
 
-Make a new e.g. ``poser`` database in PostgreSQL (or MySQL).
+Make a new e.g. ``poser`` database in PostgreSQL (or MySQL).  Nothing
+special here but for instructions see :ref:`create-appdb`.
 
 Install and run `cookiecutter <https://cookiecutter.readthedocs.io/>`_
 with `wuttaweb template
@@ -75,7 +76,7 @@ the package with:
 
 .. code-block:: sh
 
-   pip install wuttjamaican
+   pip install WuttJamaican[db]
 
 Create a :term:`config file`, e.g. ``my.conf``:
 
@@ -125,6 +126,7 @@ For more info see:
 * :func:`~wuttjamaican.conf.make_config()`
 * :class:`~wuttjamaican.conf.WuttaConfig` and especially
   :meth:`~wuttjamaican.conf.WuttaConfig.get()`
+* :class:`~wuttjamaican.app.AppHandler`
 
 
 .. _db-setup:
@@ -134,20 +136,9 @@ Database Setup
 
 You should already have the package installed (see previous section).
 
-You also must install some package(s) for the particular database
-backend you wish to use.  PostgreSQL is recommended although MySQL
-etc. should also work.  For instance:
-
-.. code-block:: sh
-
-   # postgres
-   pip install psycopg2
-
-   # mysql
-   pip install mysql-connector-python
-
 Next you must create the database, as well as any user account needed,
-within the DB backend.
+within the DB backend.  This is pretty routine but for instructions
+see :ref:`create-appdb`.
 
 Now add the DB info to your :term:`config file` (e.g. ``my.conf`` as
 shown above).  Contents for this will look something like (using
@@ -163,8 +154,6 @@ shown above).  Contents for this will look something like (using
    # mysql
    default.url = mysql+mysqlconnector://USERNAME:PASSWORD@localhost/poserdb
 
-See :doc:`/narr/db/app` for more about that.
-
 You also must add some Alembic config, needed for DB schema
 migrations:
 
@@ -178,8 +167,17 @@ With config file updated you can run the Alembic command to migrate schema:
 
 .. code-block:: sh
 
-   cd /path/to/env
-   bin/alembic -c /path/to/my.conf upgrade heads
+   alembic -c /path/to/my.conf upgrade heads
 
 Now you should have all the tables required for a WuttJamaican
 :term:`app database`.
+
+If you wish to store :term:`config settings <config setting>` in the
+DB, don't forget to add to your config file (see also
+:ref:`where-config-settings-come-from`):
+
+.. code-block:: ini
+
+   [wutta.config]
+   usedb = true
+   preferdb = true