(DOCSP-11403): Update Write for Accessibility (#45)

* (DOCSP-11403): Update Write for Accessibility

* Apply suggestions from code review

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

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

Author: melissamahoney-mongodb

source/style-guide/writing/write-for-accessibility.txt

@@ -35,7 +35,7 @@ Writing with accessibility in mind improves the documentation experience for all
 Provide Context for UI Elements
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Do not identify UI elements using only one sensory characteristic (such
+Don't identify UI elements using only one sensory characteristic (such
 as color or location).
 
 Directional phrases like “at the top of the page” or "right-hand side"
@@ -61,16 +61,19 @@ to” or “above” might not provide the correct context.
    * - Click **Save**.
      - Click the green button.
        Click the round button.
-   * - *Where an element appears more than once in the UI:*
-       1. Click **Clusters**.
-       2. Click **...** next to the cluster you want to modify.
-       *or*
-       *Where an element appears once in the UI:*
-       1. Click **Clusters**.
-       2. Click **...**.
-     - 1. Click **...**.
-       *or*
-       2. In the clusters view, click the **...** button next to the cluster you want to modify.
+   * - | *Where an element appears more than once in the UI:*
+       | 1. Click **Clusters**.
+       | 2. Click **...** next to the cluster you want to modify.
+       | 
+       | *Where an element appears once in the UI:*
+       | 1. Click **Clusters**.
+       | 2. Click **...**.
+     - | *Where an element appears more than once in the UI:*
+       | 1. Click **...**.
+       |
+       | *Where an element appears once in the UI:*
+       | 1. In the clusters view, click the **...** button next to the 
+       | cluster you want to modify.
 
 Write for Ease of Reading
 ~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -95,12 +98,12 @@ heading. Make the hierarchy clear and headings meaningful.
   their browser and the page. It's easier to jump between pages and
   sections of a page if the headings and titles are unique.
 - Use a heading hierarchy and don't skip levels. For example, put an
-  ``h3`` only under an ``h2>``.
+  ``h3`` only under an ``h2``.
 - Don't use a heading level that doesn't fit the hierarchy. Find
   another way to change the visual formatting of a heading.
 - Don't have empty headings or headings with no associated content.
-- Tag headings using heading elements, not bold.
-- Use a level 1 heading for the page title or main content heading.
+- Format headings using RST markup, like `heading types <https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#sections>`__, not **bold**.
+- Use an ``h1`` for the page title or main content heading.
 
 Use Meaningful Link Text and Formatting
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~