Doc updates

* fixed some language
* fixed some consistency issues
* fixed some 80-line-width issues
* fixed some typos and markup problems

docs/source/configuration.rst

@@ -19,13 +19,13 @@ mediagoblin.ini
   tweak settings for MediaGoblin, you'll usually tweak them here.
 
 paste.ini
-  This is primarily a server configuration file, on the python side
-  (specifically, on the wsgi side, via `paste deploy
+  This is primarily a server configuration file, on the Python side
+  (specifically, on the WSGI side, via `paste deploy
   <http://pythonpaste.org/deploy/>`_ / `paste script
   <http://pythonpaste.org/script/>`_).  It also sets up some
   middleware that you can mostly ignore, except to configure
   sessions... more on that later.  If you are adding a different
-  python server other than fastcgi / plain http, you might configure
+  Python server other than fastcgi / plain HTTP, you might configure
   it here.  You probably won't need to change this file very much.
 
 
@@ -47,19 +47,23 @@ Let's assume you're doing the virtualenv setup described elsewhere in this
 manual, and you need to make local tweaks to the config files. How do you do 
 that? Let's see.
 
-To make changes to mediagoblin.ini:
+To make changes to mediagoblin.ini ::
 
-  cp mediagoblin.ini mediagoblin_local.ini
+    cp mediagoblin.ini mediagoblin_local.ini
 
-To make changes to paste.ini:
-  cp paste.ini paste_local.ini
+To make changes to paste.ini ::
+
+    cp paste.ini paste_local.ini
 
 From here you should be able to make direct adjustments to the files,
 and most of the commands described elsewhere in this manual will "notice"
 your local config files and use those instead of the non-local version.
 
-(Note that all commands provide a way to pass in a specific config
-file also, usually by a -cf flag.)
+.. note::
+
+   Note that all commands provide a way to pass in a specific config
+   file also, usually by a ``-cf`` flag.
+
 
 Common changes
 ==============
@@ -69,9 +73,9 @@ Enabling email notifications
 
 You'll almost certainly want to enable sending emails.  By default,
 MediaGoblin doesn't really do this... for the sake of developer
-convenience, it runs in "email debug mode".  Change this:
+convenience, it runs in "email debug mode".  Change this::
 
-  email_debug_mode = false
+    email_debug_mode = false
 
 You can (and should) change the "from" email address by setting
 ``email_sender_address``.
@@ -82,21 +86,21 @@ If you have more custom SMTP settings, you also have the following
 options at your disposal, which are all optional, and do exactly what
 they sound like.
 
- - email_smtp_host
- - email_smtp_port
- - email_smtp_user
- - email_smtp_pass
+- email_smtp_host
+- email_smtp_port
+- email_smtp_user
+- email_smtp_pass
 
 All other configuration changes
 -------------------------------
 
-To be perfectly honest, there are quite a few options and I'm not
-going to be able to get to documanting them all in time for 0.1.0.
+To be perfectly honest, there are quite a few options and we haven't had
+time to document them all
 
 So here's a cop-out section saying that if you get into trouble, hop
-onto IRC and we'll help you out:
+onto IRC and we'll help you out::
 
-  #mediagoblin on irc.freenode.net
+    #mediagoblin on irc.freenode.net
 
 Celery
 ======