More docs! w/ some emphasis on "reports" section

docs/base/cron.rst

@@ -0,0 +1,11 @@
+
+Scheduled Tasks
+===============
+
+TODO
+
+
+Luigi
+-----
+
+TODO

docs/base/email.rst

@@ -1,53 +0,0 @@
-
-Sending Email
-=============
-
-TODO
-
-
-Postfix Setup
--------------
-
-TODO
-
-
-Types of Emails
----------------
-
-TODO
-
-
-Configuring SMTP
-----------------
-
-TODO
-
-
-Configuring Recipients etc.
----------------------------
-
-TODO
-
-
-Customizing Templates
----------------------
-
-TODO
-
-
-How to programmatically send email
-----------------------------------
-
-TODO
-
-
-Nod to email via error logging
-------------------------------
-
-TODO
-
-
-Handling Email Bounces
-----------------------
-
-TODO

docs/base/email/bounces.rst

@@ -0,0 +1,6 @@
+
+========================
+ Handling Email Bounces
+========================
+
+TODO

docs/base/email/code.rst

@@ -0,0 +1,5 @@
+
+Programmatically Sending Email
+------------------------------
+
+TODO

docs/base/email/config.rst

@@ -0,0 +1,16 @@
+
+Rattail Configuration
+=====================
+
+TODO
+
+Configuring SMTP
+----------------
+
+TODO
+
+
+Configuring Recipients etc.
+---------------------------
+
+TODO

docs/base/email/dev.rst

@@ -0,0 +1,8 @@
+
+----------------------------
+ Development Considerations
+----------------------------
+
+TODO
+
+* aka. how not to send unwanted/test emails to staff or public!

docs/base/email/handler.rst

@@ -0,0 +1,6 @@
+
+===============
+ Email Handler
+===============
+
+TODO

docs/base/email/index.rst

@@ -0,0 +1,18 @@
+
+Sending Email
+=============
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   overview
+   postfix
+   system
+   logging
+   config
+   templates
+   code
+   handler
+   dev
+   bounces

docs/base/email/logging.rst

@@ -0,0 +1,6 @@
+
+================
+Logging to Email
+================
+
+TODO

docs/base/email/overview.rst

@@ -0,0 +1,24 @@
+
+==========
+ Overview
+==========
+
+This manual is primarily concerned with 3 "types" of email:
+
+* emails sent by the underlying system
+* emails sent via Python logging mechanism
+* emails sent explicitly by a Poser/Rattail app
+
+The first, "emails sent by the underlying system" refers primarily to emails
+sent by the ``cron`` daemon.  See :doc:`system` for more about those.
+
+The second, "emails sent via Python logging mechanism" is covered in
+:doc:`logging`.
+
+The third, "emails sent explicitly by a Poser/Rattail app" is the primary
+motivation behind this section of the manual.  In particular see the sections
+about :doc:`config`, :doc:`templates` and :doc:`code`.
+
+Finally, if you're sending email to the public, it may be helpful to detect
+bounces and e.g. flag an address as invalid if it triggers a bounce.  See
+:doc:`bounces` for more on that.

docs/base/email/postfix.rst

@@ -0,0 +1,5 @@
+
+Postfix Setup
+=============
+
+TODO

docs/base/email/system.rst

@@ -0,0 +1,5 @@
+
+System Emails
+=============
+
+TODO

docs/base/email/templates.rst

@@ -0,0 +1,6 @@
+
+=======================
+ Customizing Templates
+=======================
+
+TODO

docs/base/handlers.rst

@@ -3,3 +3,5 @@ App Handlers
 ============
 
 TODO
+
+* Report Handler

docs/base/index.rst

@@ -13,7 +13,9 @@ Base Layer
    config/index
    commands
    scripts
-   email
+   email/index
+   cron
    supervisor
    filemon
+   upgrades
    handlers

docs/base/upgrades.rst

@@ -0,0 +1,6 @@
+
+==============
+ App Upgrades
+==============
+
+TODO