(DOCSP-11399): Update Voice & Tone w/ JD feedback (#38)

* (DOCSP-11399): Update Voice & Tone w/ JD feedback

* copy review

Author: melissamahoney-mongodb

source/style-guide/style/voice-and-tone.txt

@@ -1,13 +1,19 @@
+.. _voice-and-tone:
+
 ==============
 Voice and Tone
 ==============
 
-The voice and tone that we use with words influence how people think
+.. default-domain:: mongodb
+
+.. include:: /includes/styles/corrections.rst
+
+The *voice* and *tone* that we use influence how people think
 and feel about MongoDB.
 
-Voice is our style and communicates our personality to the user. Tone
-is our mood and communicates our attitude about the subject to the
-user.
+- *Voice* is our style and communicates our personality to the user. 
+- *Tone* is our mood and communicates our attitude about the subject to 
+  the user.
 
 The words we choose—and the ways we use them—should reflect our goals,
 which include the following things:
@@ -22,109 +28,103 @@ No matter where our words land, they should sound like us.
 Voice and Tone Attributes
 -------------------------
 
-The following table shows attributes for voice and tone:
+At MongoDB, we shape our words with the following voice and tone
+attributes:
 
 .. list-table::
-   :widths: 50 50
    :header-rows: 1
+   :widths: 50 50
 
-   * - Voice attributes
-     - Tone attributes
-
-   * - **Basic**
-
-       * Human
-       * Conversational
-       * Friendly
-       * Confident
-       * Knowledgeable
-       * Trustworthy
-
-     - **Basic**
-
-       * Indispensable
-       * Helpful
-       * Approachable
-       * Smart
-       * Professional
-       * Honest
-       * Accurate
-
-   * - **Amplified**
-
-       * Bold
-       * Voice of reality
-       * Voice of experience
-       * Committed
-       * Exuberant
-
-     - **Amplified**
-
-       * Empathetic without sugarcoating it
-       * Empowering and proactive
-       * Playful, but professional
-       * Steadfast, but open and approachable
+   * - Voice
+     - Tone
+   * - - Human
+       - Conversational
+       - Friendly
+       - Confident
+       - Knowledgeable
+       - Trustworthy
+
+     - - Indispensable
+       - Helpful
+       - Approachable
+       - Smart
+       - Professional
+       - Honest
+       - Accurate
+
+These attributes make our documentation:
+
+- Empathetic without sugarcoating it.
+- Empowering and proactive.
+- Committed and energetic.
+- Playful, but professional.
+- Steadfast, but open and approachable.
+- A trusted voice of reality and experience.
 
 Best Practices
 --------------
 
 Consider the following best practices for voice and tone:
 
 .. list-table::
-   :widths: 33 33 34
+   :widths: 50 25 25
    :header-rows: 1
 
    * - Best practices
      - Use
-     - Don't Use
-
-   * - Write to the user by using second person and imperative mood.
-       Users are more engaged with content when it talks to them
-       directly. You talk to users directly by using second person,
-       addressing the user as *you*. When you use second person with
-       the imperative mood (in which the subject *you* is understood)
-       *and* active voice, you make the text clear, concise, and
-       direct.
+     - Avoid
+
+   * - :ref:`Write to the user <write-to-the-user>` by using second 
+       person and imperative mood. Users are more engaged with content
+       when it talks to them directly. You talk to users directly by
+       using second person, addressing the user as *you*. When you use
+       second person with the imperative mood (in which the subject
+       *you* is understood) *and* active voice, you make the text clear,
+       concise, and direct.
      - Click **Yes** to accept the license agreement.
      - The license agreement is accepted when the user clicks **Yes**.
 
-   * - Write in active voice. Active voice makes the performer of the
-       action (usually the user) the subject of the sentence.
-       Active-voice sentences are more direct and easier to understand
-       than passive-voice sentences.
-     - After you install the software, start the computer.
+   * - :ref:`Write in active voice <use-active-voice>`. Active voice 
+       makes the performer of the action (usually the user) the subject
+       of the sentence. Active-voice sentences are more direct and
+       easier to understand than passive-voice sentences.
+     - After you install the software, restart the computer.
      - After the software has been installed, the computer can be
-       started.
+       restarted.
 
-   * - Use present tense. Users read content to help them perform tasks
-       or to gather information. These activities occur in the users'
-       present time, so the present tense is appropriate in most
-       content.
+   * - :ref:`Use present tense <use-present-tense>`. Users read content 
+       to help them perform tasks or to gather information. These
+       activities occur in the users' present time, so the present tense
+       is appropriate in most content.
      - The product **prompts** you to verify the deletion.
      - The product **will prompt** you to verify the deletion.
 
    * - Be impactful and speak directly to a pain point.
-     - Stop letting the cloud manage you.
-     - Are you ready for the managed cloud?
+     - Stop letting maintenance of your database take time away from
+       developing your app.
+     - MongoDB Atlas is built for agile teams who'd rather spend time
+       building apps than managing databases.
 
    * - It's about them, not us, and promises a solution.
      - Offload the burden of managing the cloud to a team of experts.
      - The managed cloud difference, fueled by expertise...
 
    * - Be simple and direct.
-     - The cloud is hard. We can help.
-     - Let us help you solve your cloud challenges.
+     - Why MongoDB Atlas? Flexible and scalable document database.   
+       Available as a fully managed service.
+     - Are you looking for a global cloud database service that deploys
+       fully managed document databases?
 
    * - Write in a way that the user wants to be spoken to. Use helpful
        words and phrases that are informative, simple, clear, and easy
        to understand.
-     - The IP address of the server needs to be entered. Click the **My
-       Server** button to complete the configuration.
+     - Enter the IP address of the host. Click :guilabel:`My
+       Server` to complete the configuration.
      - The monitoring engine couldn't connect to the server. Make sure
        the information is correctly entered.
 
-   * - Temper the enthusiasm conveyed in content.
-     - You have successfully configured databased for monitoring.
+   * - Avoid being overly enthusiastic.
+     - You successfully configured all databases for monitoring.
      - Congratulations!! ALL of your databases are now being
        monitored!!