diff --git a/docs/dev/analysis/features/hyperlink.rst b/docs/dev/analysis/features/hyperlink.rst
index 092d76cfe..9a123fb03 100644
--- a/docs/dev/analysis/features/hyperlink.rst
+++ b/docs/dev/analysis/features/hyperlink.rst
@@ -28,8 +28,8 @@ Add multiple runs to a hyperlink:
 
     >>> hyperlink = paragraph.add_hyperlink(url='http://github.com')
     >>> hyperlink.add_run('A')
-    >>> hyperlink.add_run(' formatted').italic = True
-    >>> hyperlink.add_run(' link').bold = True
+    >>> hyperlink.add_run('formatted').italic = True
+    >>> hyperlink.add_run('link').bold = True
     >>> len(hyperlink.runs)
     3
 
@@ -56,22 +56,25 @@ Specimen XML
 
 .. highlight:: xml
 
-A simple hyperlink to an external url, and the relationship for it's url:
+A simple hyperlink to an external url::
 
-    <w:hyperlink r:id="rId9">
-      <w:r>
-        <w:rPr>
-          <w:rStyle w:val="Hyperlink"/>
-        </w:rPr>
-        <w:t>Google</w:t>
-      </w:r>
-    </w:hyperlink>
+  <w:hyperlink r:id="rId9">
+    <w:r>
+      <w:rPr>
+        <w:rStyle w:val="Hyperlink"/>
+      </w:rPr>
+      <w:t>Google</w:t>
+    </w:r>
+  </w:hyperlink>
+
+
+The relationship for the above url::
 
     <Relationships xmlns="…">
       <Relationship Id="rId9" Mode="External" Target=http://google.com />
     </Relationships>
 
-A hyperlink to an internal named range:
+A hyperlink to an internal named range::
 
     <w:hyperlink r:anchor="section1">
       <w:r>
@@ -82,7 +85,7 @@ A hyperlink to an internal named range:
       </w:r>
     </w:hyperlink>
 
-A hyperlink with mutiple runs of text:
+A hyperlink with multiple runs of text::
 
     <w:hyperlink r:id="rId2">
       <w:r>
@@ -127,13 +130,11 @@ Resources
 .. _Hyperlinks Members (Word) on MSDN:
    http://msdn.microsoft.com/en-us/library/office/ff192421.aspx
 
-.. Hyperlink Class (OpenXML.Office2010.CustomUI) on MSDN:
-   http://msdn.microsoft.com/en-us/library/documentformat.openxml.
-   office2010.customui.hyperlink.aspx
+.. _Hyperlink Class (OpenXML.Office2010.CustomUI) on MSDN:
+   http://msdn.microsoft.com/en-us/library/documentformat.openxml.office2010.customui.hyperlink.aspx
 
-.. Hyperlink Class (OpenXML.Wordprocessing) on MSDN:
-   http://msdn.microsoft.com/en-us/library/documentformat.openxml.
-   wordprocessing.hyperlink.aspx
+.. _Hyperlink Class (OpenXML.Wordprocessing) on MSDN:
+   http://msdn.microsoft.com/en-us/library/documentformat.openxml.wordprocessing.hyperlink.aspx
 
 
 MS API
diff --git a/docs/dev/analysis/index.rst b/docs/dev/analysis/index.rst
index 52afab2bd..7b85350ab 100644
--- a/docs/dev/analysis/index.rst
+++ b/docs/dev/analysis/index.rst
@@ -41,4 +41,5 @@ ISO/IEC 29500 spec.
    schema/ct_body
    schema/ct_p
    schema/ct_ppr
+   schema/ct_hyperlink
    schema/ct_styles