doc: fix typos, missing parentheses, upper/lower case

Fix some minor typos, add a missing parentheses and
unify some upper vs lower case words.

Change-Id: I2b6c394238de8d16f8eb4a752c2495762b01a2c3
diff --git a/doc/source/reporters.rst b/doc/source/reporters.rst
index 18d35a1..63a86c4 100644
--- a/doc/source/reporters.rst
+++ b/doc/source/reporters.rst
@@ -5,11 +5,11 @@
 
 Zuul can communicate results and progress back to configurable
 protocols. For example, after succeeding in a build a pipeline can be
-configured to post a positive review back to gerrit.
+configured to post a positive review back to Gerrit.
 
 There are three stages when a report can be handled. That is on:
 Start, Success or Failure. Each stage can have multiple reports.
-For example, you can set verified on gerrit and send an email.
+For example, you can set verified on Gerrit and send an email.
 
 Gerrit
 ------
@@ -18,7 +18,7 @@
 ``gerrit`` command over an SSH connection.  It reports back to
 Gerrit using SSH.
 
-The dictionary passed to the gerrit reporter is used for ``gerrit
+The dictionary passed to the Gerrit reporter is used for ``gerrit
 review`` arguments, with the boolean value of ``true`` simply
 indicating that the argument should be present without following it
 with a value. For example, ``verified: 1`` becomes ``gerrit review
@@ -28,7 +28,7 @@
 Gerrit Configuration
 ~~~~~~~~~~~~~~~~~~~~
 
-The configuration for posting back to gerrit is shared with the gerrit
+The configuration for posting back to Gerrit is shared with the Gerrit
 trigger in zuul.conf as described in :ref:`zuulconf`.
 
 SMTP
@@ -39,7 +39,7 @@
 SMTP Configuration
 ~~~~~~~~~~~~~~~~~~
 
-zuul.conf contains the smtp server and default to/from as describe
+zuul.conf contains the SMTP server and default to/from as describe
 in :ref:`zuulconf`.
 
 Each pipeline can overwrite the to or from address by providing