Clean up and update docs

Clean up some formatting issues in doc sources
and smooth out some wording.

Change-Id: I2bb2c9a32d67b71deeb7fcc13fd6a2949b4e195b
Signed-off-by: Doug Hellmann <doug.hellmann@dreamhost.com>

1 files changed, 6 insertions, 8 deletions

diff --git a/docs/source/index.rst b/docs/source/index.rst
index 8f10827..614baee 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -6,10 +6,12 @@ of `ShootQ <http://shootq.com>`_ while working at `Pictage
 <http://pictage.com>`_.
 
 Pecan was created to fill a void in the Python web-framework world – a
-very lightweight framework that provides object-dispatch style routing.
-Pecan does not aim to be a "full stack" framework, and therefore
-includes no out of the box support for things like sessions or
-databases. Pecan instead focuses on HTTP itself.
+very lightweight framework that provides object-dispatch style
+routing.  Pecan does not aim to be a "full stack" framework, and
+therefore includes no out of the box support for things like sessions
+or databases (although tutorials are included for integrating these
+yourself in just a few lines of code). Pecan instead focuses on HTTP
+itself.
 
 Although it is lightweight, Pecan does offer an extensive feature set
 for building HTTP-based applications, including:
@@ -21,10 +23,6 @@ for building HTTP-based applications, including:
  * Extensible JSON support
  * Easy Python-based configuration
 
-While Pecan doesn't provide support for sessions or databases out of the
-box, tutorials are included for integrating these yourself in just a few
-lines of code.
-
 Narrative Documentation
 =======================