(DOCSP-11378) Update text formatting page

Author: Anthony Sansone

Makefile

@@ -20,6 +20,10 @@ help: ## Show this help message
 html: ## Builds this branch's HTML under build/<branch>/html
 	giza make html
 
+clean-html:
+	rm -rf build/${GIT_BRANCH}
+	giza make html
+
 publish: ## Builds this branch's publishable HTML and other artifacts under build/public
 	giza make publish
 

source/reference/source-constants.txt

@@ -2,14 +2,15 @@
 Source Constants
 ================
 
-The `substitutions <http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#substitution-definitions>`__
-built into restructuredText have a number of limitations and quirks. For
-example, they cannot be used to substitute content inside of code blocks,
-and cannot contain links.
+The `substitutions
+<http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#substitution-definitions>`__
+built into restructuredText have a number of limitations and quirks.
+For example, they cannot be used to substitute content inside of code
+blocks, and cannot contain links.
 
-The MongoDB Documentation Project has an extension called ``source_constants``
-which allows you to substitute constants anywhere in a page *before*
-docutils begins its parse stage.
+The MongoDB Documentation Project has an extension called
+``source_constants`` which allows you to substitute constants anywhere
+in a page *before* docutils begins its parse stage.
 
 Example
 -------
@@ -18,6 +19,7 @@ In your ``conf.py``, add ``'source_constants'`` to the ``extensions``
 list, and define a ``source_constants`` dict:
 
 .. code-block:: python
+   :linenos:
 
    source_constants = {
        'package-branch': 'testing',
@@ -29,13 +31,15 @@ You may then use these constants in your restructuredText files:
 
 .. code-block:: rst
 
-   Create the ``/etc/apt/sources.list.d/mongodb-org-{+package-version+}.list`` list file using
-   the command appropriate for your version of Ubuntu:
+   Create the
+   ``/etc/apt/sources.list.d/mongodb-org-{+package-version+}.list``
+   list file using the command appropriate for your version of Ubuntu:
 
-   Ubuntu 14.04
-    .. code-block:: sh
+   .. code-block:: sh
 
-       echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu trusty/mongodb-org/{+package-branch+} multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-{+version+}.list
+      echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu \
+           trusty/mongodb-org/{+package-branch+} multiverse" \
+           | sudo tee /etc/apt/sources.list.d/mongodb-org-{+version+}.list
 
 Comparison with Other Variable Syntaxes
 ---------------------------------------
@@ -62,7 +66,8 @@ Comparison with Other Variable Syntaxes
    * - Valid Content
      - Anything
      - Anything
-     - May not be used to inject links or other non-trivial types of content
+     - May not be used to inject links or other non-trivial types of
+       content
 
    * - Mutable
      - Can currently only be defined in ``conf.py``

source/style-guide/includes/terms/0.rst

@@ -0,0 +1,19 @@
+#
+-
+
+.. glossary::
+
+   24x7x365
+     Use this phrase to describe continuous availability. Don't
+     replace the *x*'s with slashes, hyphens, or the word *by*.
+
+     .. list-table::
+        :widths: 50 50
+        :header-rows: 1
+
+        * - Recommended
+          -
+        * - We deliver fantastic support — we are here to help,
+            24x7x365.
+          - We deliver fantastic support: 24 by 7 by 365.
+