diff --git a/docs/intro/learning.rst b/docs/intro/learning.rst
index ba4a95965..397165821 100644
--- a/docs/intro/learning.rst
+++ b/docs/intro/learning.rst
@@ -130,7 +130,7 @@ no previous programming experience.
 
 
 Learn to Program in Python with Codeacademy
-~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 A Codeacademy course for the absolute Python beginner. This free and interactive course provides and teaches the basics (and beyond) of Python programming whilst testing the user's knowledge in between progress.
 
diff --git a/docs/intro/news.rst b/docs/intro/news.rst
index b48e8bd11..429749016 100644
--- a/docs/intro/news.rst
+++ b/docs/intro/news.rst
@@ -41,7 +41,7 @@ Python News is the news section in the official Python web site
     `Python News <http://www.python.org/news/>`_
 
 Import Python Weekly
-~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~
 
 Weekly Python Newsletter containing Python Articles, Projects, Videos, Tweets
 delivered in your inbox.  Keep Your Python Programming Skills Updated.
diff --git a/docs/scenarios/gui.rst b/docs/scenarios/gui.rst
index 466dec066..da2944750 100644
--- a/docs/scenarios/gui.rst
+++ b/docs/scenarios/gui.rst
@@ -15,7 +15,7 @@ and the mailing list https://groups.google.com/forum/#!forum/project-camelot
 
 Cocoa
 -----
-.. note:: The Cocoa framework is only available on OS X. Don't pick this if you're writing a cross-platform application!
+.. note:: The Cocoa framework is only available on OS X. Don't pick this if you're writing a cross-platform application!
 
 GTk
 ---
diff --git a/docs/scenarios/imaging.rst b/docs/scenarios/imaging.rst
index 421793a6a..7ae952d37 100644
--- a/docs/scenarios/imaging.rst
+++ b/docs/scenarios/imaging.rst
@@ -20,8 +20,8 @@ Installation
 ~~~~~~~~~~~~
 
 Before installing Pillow, you'll have to install Pillow's prerequisites. Find
-the instructions for your platform
-`here <https://pillow.readthedocs.org/en/3.0.0/installation.html>`_.
+the instructions for your platform in the
+`Pillow installation instructions <https://pillow.readthedocs.org/en/3.0.0/installation.html>`_.
 
 After that, it's straightforward:
 
@@ -53,7 +53,5 @@ Example
         exif_data = im._getexif()
         exif_data
 
-There are more examples of the Pillow library 
-`here <http://pillow.readthedocs.org/en/3.0.x/handbook/tutorial.html>`_.
-
-
+There are more examples of the Pillow library in the
+`Pillow tutorial <http://pillow.readthedocs.org/en/3.0.x/handbook/tutorial.html>`_.
diff --git a/docs/scenarios/web.rst b/docs/scenarios/web.rst
index 14080f341..9a5c7603b 100644
--- a/docs/scenarios/web.rst
+++ b/docs/scenarios/web.rst
@@ -167,8 +167,8 @@ programming languages and protocols - including Python and WSGI. uWSGI can
 either be run as a stand-alone web router, or be run behind a full web
 server (such as Nginx or Apache).  In the latter case, a web server can
 configure uWSGI and an application's operation over the
-`uwsgi <https://uwsgi-docs.readthedocs.org/en/latest/Protocol.html>`_
-protocol.  uWSGI's web server support allows for dynamically configuring
+`uwsgi protocol <https://uwsgi-docs.readthedocs.org/en/latest/Protocol.html>`_.
+uWSGI's web server support allows for dynamically configuring
 Python, passing environment variables and further tuning.  For full details,
 see `uWSGI magic
 variables <https://uwsgi-docs.readthedocs.org/en/latest/Vars.html>`_.
diff --git a/docs/shipping/freezing.rst b/docs/shipping/freezing.rst
index 13454298c..8b01d647e 100644
--- a/docs/shipping/freezing.rst
+++ b/docs/shipping/freezing.rst
@@ -75,7 +75,7 @@ Prerequisite is to install :ref:`Python on Windows <install-windows>`.
 
 1. Download and install http://sourceforge.net/projects/py2exe/files/py2exe/
 
-2. Write :file:`setup.py` (`List of configuration options <http://www.py2exe.org/index.cgi/ListOfOptions>`_)::
+2. Write :file:`setup.py` (`List of configuration options <http://www.py2exe.org/index.cgi/ListOfOptions>`_):
 
 .. code-block:: python
 
@@ -107,7 +107,7 @@ Prerequisite is to have installed :ref:`Python, Setuptools and pywin32 dependenc
 - `Manual <http://www.pyinstaller.org/export/d3398dd79b68901ae1edd761f3fe0f4ff19cfb1a/project/doc/Manual.html?format=raw>`_
 
 
-OS X
+OS X
 ----