(DOCSP-11394): Update Punctuation page (#44)

* (DOCSP-11394): Update Punctuation page

* Apply suggestions from code review

Co-authored-by: Anthony Sansone <[email protected]>

* copy review

Co-authored-by: Anthony Sansone <[email protected]>

Author: melissamahoney-mongodb

source/style-guide/style/punctuation.txt

@@ -4,12 +4,14 @@
 Punctuation
 ===========
 
-.. include:: /style-guide/includes/page-needs-update.rst
+.. default-domain:: mongodb
+
+.. include:: /includes/style/corrections.rst
 
 Use punctuation correctly and consistently. This section provides
 guidelines for using punctuation in MongoDB documentation. For basic
-rules about punctuation, see a grammar reference, such as the
-*Harbrace College Handbook*.
+rules about punctuation, see :cmos17:`section 5, Grammar and Usage
+</part2/ch05/toc.html>` in the *Chicago Manual of Style*.
 
 .. contents:: On this page
    :local:
@@ -62,8 +64,9 @@ Use the following guidelines for colons:
 Commas
 ~~~~~~
 
-Use the following guidelines for commas. For basic comma usage, see a
-grammar reference, such as the *Harbrace College Handbook*.
+Use the following guidelines for commas. For basic comma usage,
+:cmos17:`section 6.16, Commas </part2/ch06/psec016.html>` in the Chicago
+Manual of Style.
 
 .. list-table::
    :widths: 40 30 30
@@ -116,10 +119,10 @@ grammar reference, such as the *Harbrace College Handbook*.
        However, you can easily update the version by using the
        WordPress management dashboard.
 
-       Unlike the other alarms in this list, you set the network check alarm
-       variable upon network check creation.
+       Unlike the other alarms in this list, you set the network check
+       alarm variable upon network check creation.
 
-       For more information, see Upgrading your Private Cloud.
+       To learn more, see Upgrading Ops Manager.
      - When you check your email with an IMAP connection you're
        accessing and managing your email directly from the email
        server.
@@ -130,7 +133,7 @@ grammar reference, such as the *Harbrace College Handbook*.
        Unlike the other alarms in this list you set the network check
        alarm variable upon network check creation.
 
-       For more information see Upgrading your Private Cloud.
+       To learn more, see Upgrading Ops Manager.
 
    * - Don't use a comma between the verbs in a compound predicate.
      - These open-source Python clients run on Linux or Mac OS X
@@ -293,8 +296,7 @@ be necessary in the following cases:
    *preemptive*, which aren't likely to be misread.
 
 -  The product team has hyphenated a term with a prefix, and you need
-   to follow suit in the docs for consistency with the interface—for
-   example, *multi-factor authentication* in the Identity product.
+   to follow suit in the docs for consistency with the interface.
    Whenever possible, work with the teams to use preferred spelling.
 
 For the correct formatting of a specific word, see a dictionary or
@@ -347,7 +349,7 @@ Periods
 ~~~~~~~
 
 Use the following guidelines for periods. For basic period usage, see a
-grammar reference, such as the *Harbrace College Handbook*.
+grammar reference, :cmos17:`section 6.12, Periods </part2/ch06/psec012.html>` in the *Chicago Manual of Style*.
 
 - Use a period at the end of a declarative or imperative sentence, and
   insert only one space after the period.