From 721b2e7d67272dea898be55d935f4c9dbf821f6d Mon Sep 17 00:00:00 2001
From: Kim Gardner <kgardnr@gmail.com>
Date: Tue, 10 Sep 2019 09:55:34 -0400
Subject: [PATCH] [CORL-527] English copy tweaks (#2546)

* English copy tweaks

* fix: unit tests

* Use reactions to be more general

* fix: snapshots
---
 package-lock.json                             |  2 +-
 .../__snapshots__/advanced.spec.tsx.snap      |  3 +-
 .../__snapshots__/general.spec.tsx.snap       | 23 +++--
 .../__snapshots__/moderation.spec.tsx.snap    | 52 +++++------
 .../__snapshots__/organization.spec.tsx.snap  |  8 +-
 .../__snapshots__/wordList.spec.tsx.snap      | 24 +----
 .../renderConfigure.spec.tsx.snap             | 16 ++--
 .../configure/streamConfiguration.spec.tsx    |  2 +-
 .../__snapshots__/account.spec.tsx.snap       |  4 +-
 src/core/server/locales/en-US/errors.ftl      |  4 +-
 src/locales/en-US/admin.ftl                   | 87 +++++++++----------
 src/locales/en-US/stream.ftl                  | 28 +++---
 12 files changed, 113 insertions(+), 140 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index b472d7d67..7343c5b7e 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -24246,7 +24246,7 @@
       "dependencies": {
         "async": {
           "version": "1.5.2",
-          "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
+          "resolved": "http://registry.npmjs.org/async/-/async-1.5.2.tgz",
           "integrity": "sha1-7GphrlZIDAw8skHJVhjiCJL5Zyo=",
           "dev": true
         }
diff --git a/src/core/client/admin/test/configure/__snapshots__/advanced.spec.tsx.snap b/src/core/client/admin/test/configure/__snapshots__/advanced.spec.tsx.snap
index 88b0d59c0..8f16c695a 100644
--- a/src/core/client/admin/test/configure/__snapshots__/advanced.spec.tsx.snap
+++ b/src/core/client/admin/test/configure/__snapshots__/advanced.spec.tsx.snap
@@ -245,7 +245,8 @@ each of your site’s stories.
                 <p
                   className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
                 >
-                  When enabled, there will be real-time loading and updating of comments as new comments and replies are published
+                  When enabled, there will be real-time loading and updating of comments. 
+When disabled, users will have to refresh the page to see new comments.
                 </p>
                 <div>
                   <div
diff --git a/src/core/client/admin/test/configure/__snapshots__/general.spec.tsx.snap b/src/core/client/admin/test/configure/__snapshots__/general.spec.tsx.snap
index 95b8408b5..8676e2e20 100644
--- a/src/core/client/admin/test/configure/__snapshots__/general.spec.tsx.snap
+++ b/src/core/client/admin/test/configure/__snapshots__/general.spec.tsx.snap
@@ -211,10 +211,10 @@ exports[`renders configure general 1`] = `
               <p
                 className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
               >
-                Open or close comment streams for new comments sitewide. When new comments
-are turned off sitewide, new comments cannot be submitted, but existing
-comments can continue to receive “Respect” reactions, be reported, and be
-shared.
+                Open or close comment streams for new comments sitewide. 
+When new comments are turned off, new comments cannot be 
+submitted, but existing comments can continue to receive 
+reactions, be reported, and be shared.
               </p>
               <fieldset
                 className="Box-root HorizontalGutter-root FormField-root HorizontalGutter-half"
@@ -386,10 +386,10 @@ shared.
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  Write a summary of your community guidelines that will appear
-at the top of each comment stream sitewide. Your summary can be
-formatted using Markdown Syntax. More information on how to use
-Markdown can be found 
+                  This will appear above the comments sitewide. 
+You can format the text using Markdown. 
+More information on how to use Markdown 
+
                   <a
                     className="ExternalLink-root"
                     href="#"
@@ -827,7 +827,7 @@ moderation panel.
               <p
                 className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
               >
-                Write a message to appear after a story is closed for commenting.
+                Write a message to appear when a story is closed for commenting.
               </p>
               <div
                 className="MarkdownEditor-wrapper"
@@ -858,9 +858,8 @@ moderation panel.
                 className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
               >
                 Allow your community to engage with one another and express themselves
-with one-click reactions. By default, Coral allows commenters to
-"Respect" each other's comments, but you may customize reaction text
-based on the needs of your community.
+with one-click reactions. By default, Coral allows commenters to "Respect" 
+each other's comments.
               </p>
               <div
                 className="Box-root HorizontalGutter-root HorizontalGutter-double"
diff --git a/src/core/client/admin/test/configure/__snapshots__/moderation.spec.tsx.snap b/src/core/client/admin/test/configure/__snapshots__/moderation.spec.tsx.snap
index 676b19a10..7fff74626 100644
--- a/src/core/client/admin/test/configure/__snapshots__/moderation.spec.tsx.snap
+++ b/src/core/client/admin/test/configure/__snapshots__/moderation.spec.tsx.snap
@@ -277,7 +277,7 @@ approved by a moderator.
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  The period of time over which a user’s rejection rate is calculated.
+                  Amount of time to calculate a commenter's rejection rate.
                 </p>
                 <div
                   className="Box-root Flex-root Flex-flex Flex-itemGutter gutter"
@@ -318,15 +318,10 @@ approved by a moderator.
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  Prevents repeat offenders from publishing comments without approval.
-After a commenter's rejection rate rises above the defined threshold
-below, their next submitted comments are 
-                  <strong>
-                    sent to Pending for
-moderator approval.
-                  </strong>
-                   The filter is removed when their rejection rate
-falls below the threshold.
+                  Prevents repeat offenders from publishing comments without approval. 
+When a commenter's rejection rate is above the threshold, their 
+comments are sent to Pending for moderator approval. This does not 
+apply to Staff comments.
                 </p>
                 <div>
                   <div
@@ -390,9 +385,9 @@ falls below the threshold.
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  A user’s rejected comments divided by their published comments, over
-the time period set below (does not include comments pending for
-toxicity, spam or pre-moderation.)
+                  Rejected comments ÷ (rejected comments + published comments) 
+over the timeframe above, as a percentage. It does not include 
+comments pending for toxicity, spam or pre-moderation.
                 </p>
                 <div
                   className="TextField-root"
@@ -440,8 +435,10 @@ toxicity, spam or pre-moderation.)
               <p
                 className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
               >
-                Using the Perspective API, the Toxic Comment filter warns users when comments exceed the predefined toxicity
-threshold. Comments with a toxicity score above the threshold 
+                Using the Perspective API, the Toxic Comment filter warns users 
+when comments exceed the predefined toxicity threshold. 
+Comments with a toxicity score above the threshold 
+
                 <strong>
                   will not be published
                 </strong>
@@ -450,7 +447,8 @@ the
                 <strong>
                   Pending Queue for review by a moderator
                 </strong>
-                . If approved by a moderator, the comment will be published.
+                . 
+If approved by a moderator, the comment will be published.
               </p>
               <fieldset
                 className="FieldSet-root Box-root HorizontalGutter-root FormField-root HorizontalGutter-half"
@@ -568,7 +566,8 @@ comment is toxic, according to Perspective API. By default the threshold is set
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  Choose your Perspective Model. The default is TOXICITY. You can find out more about model choices 
+                  Choose your Perspective Model. The default is TOXICITY. 
+You can find out more about model choices 
                   <a
                     className="ExternalLink-root"
                     href="https://github.com/conversationai/perspectiveapi/blob/master/api_reference.md#models"
@@ -784,21 +783,10 @@ improve the API over time.
               <p
                 className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
               >
-                Submitted comments are passed to the Akismet API for spam detection.
-If a comment is determined to be spam, it will prompt the user,
-indicating that the comment might be considered spam.
-If the user continues after this point with the still spam-like comment,
-the comment will be marked as containing spam, 
-                <strong>
-                  will not be published
-                </strong>
-                 and
-are placed in the 
-                <strong>
-                  Pending Queue for review by a moderator
-                </strong>
-                . If approved by a moderator,
-the comment will be published.
+                The Akismet API filter warns users when a comment is determined likely 
+to be spam. Comments that Akismet thinks are spam will not be published 
+and are placed in the Pending Queue for review by a moderator. 
+If approved by a moderator, the comment will be published.
               </p>
               <fieldset
                 className="FieldSet-root Box-root HorizontalGutter-root FormField-root HorizontalGutter-half"
diff --git a/src/core/client/admin/test/configure/__snapshots__/organization.spec.tsx.snap b/src/core/client/admin/test/configure/__snapshots__/organization.spec.tsx.snap
index 4a537ffdb..4f4cb755a 100644
--- a/src/core/client/admin/test/configure/__snapshots__/organization.spec.tsx.snap
+++ b/src/core/client/admin/test/configure/__snapshots__/organization.spec.tsx.snap
@@ -179,10 +179,10 @@ exports[`renders configure organization 1`] = `
                 <p
                   className="Box-root Typography-root Typography-bodyShort Typography-colorTextPrimary"
                 >
-                  This email address will be used as in emails and across
-the platform for community members to get in touch with
-the organization should they have any questions about the
-status of their accounts or moderation questions.
+                  Open or close comment streams for new comments sitewide. When new comments
+are turned off sitewide, new comments cannot be submitted, but existing
+comments can continue to receive reactions, be reported, and be
+shared.
                 </p>
                 <div
                   className="TextField-root TextField-fullWidth"
diff --git a/src/core/client/admin/test/configure/__snapshots__/wordList.spec.tsx.snap b/src/core/client/admin/test/configure/__snapshots__/wordList.spec.tsx.snap
index 2ba9d9a39..a0634b680 100644
--- a/src/core/client/admin/test/configure/__snapshots__/wordList.spec.tsx.snap
+++ b/src/core/client/admin/test/configure/__snapshots__/wordList.spec.tsx.snap
@@ -150,17 +150,7 @@ exports[`renders configure wordList 1`] = `
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  Separate banned words or phrases with a new line. Attempting to copy
-and paste a comma separated list? 
-                  <a
-                    className="ExternalLink-root"
-                    href="#"
-                    rel="noopener noreferrer"
-                    target="_blank"
-                  >
-                    Learn how to convert your list
-to a new line separated list.
-                  </a>
+                  Separate banned words or phrases with a new line.
                 </p>
                 <div>
                   <textarea
@@ -214,17 +204,7 @@ published (if comments are not pre-moderated).
                 <p
                   className="Box-root Typography-root Typography-fieldDescription Typography-colorTextSecondary"
                 >
-                  Separate suspect words or phrases with a new line. Attempting to copy
-and paste a comma separated list? 
-                  <a
-                    className="ExternalLink-root"
-                    href="#"
-                    rel="noopener noreferrer"
-                    target="_blank"
-                  >
-                    Learn how to convert your list
-to a new line separated list.
-                  </a>
+                  Separate suspect words or phrases with a new line.
                 </p>
                 <div>
                   <textarea
diff --git a/src/core/client/stream/test/configure/__snapshots__/renderConfigure.spec.tsx.snap b/src/core/client/stream/test/configure/__snapshots__/renderConfigure.spec.tsx.snap
index 0ca0939e1..8c700de00 100644
--- a/src/core/client/stream/test/configure/__snapshots__/renderConfigure.spec.tsx.snap
+++ b/src/core/client/stream/test/configure/__snapshots__/renderConfigure.spec.tsx.snap
@@ -123,7 +123,10 @@ exports[`renders configure 1`] = `
               <p
                 className="Box-root Typography-root Typography-detail Typography-colorTextSecondary WidthLimitedDescription-root"
               >
-                When enabled, there will be real-time loading and updating of comments as new comments and replies are published.
+                When enabled, the comments will be updated instantly 
+as new comments and replies are submitted, instead of 
+requiring a page refresh. You can disable this in the 
+unusual situation of an article getting so much traffic that the comments are loading slowly.
               </p>
             </div>
           </div>
@@ -166,7 +169,7 @@ exports[`renders configure 1`] = `
               <p
                 className="Box-root Typography-root Typography-detail Typography-colorTextSecondary WidthLimitedDescription-root"
               >
-                Moderators must approve any comment before it is published to this stream.
+                Moderators must approve any comment before it is published to this story.
               </p>
             </div>
           </div>
@@ -209,7 +212,7 @@ exports[`renders configure 1`] = `
               <p
                 className="Box-root Typography-root Typography-detail Typography-colorTextSecondary WidthLimitedDescription-root"
               >
-                Moderators must approve any comment that contains a link before it is published to this stream.
+                Moderators must approve any comment that contains a link before it is published to this story.
               </p>
             </div>
           </div>
@@ -240,7 +243,7 @@ exports[`renders configure 1`] = `
                     className="Box-root Typography-root Typography-heading3 Typography-colorTextPrimary"
                   >
                     <span>
-                      Enable Message Box for this Stream
+                      Enable Message Box for this Story
                     </span>
                   </span>
                 </span>
@@ -255,8 +258,9 @@ exports[`renders configure 1`] = `
                 <p
                   className="Box-root Typography-root Typography-detail Typography-colorTextSecondary WidthLimitedDescription-root"
                 >
-                  Add a message to the top of the comment box for your readers. Use this to pose a topic,
-ask a question or make announcements relating to this story.
+                  Add a message to the top of the comment box for your readers. 
+Use this to suggest a discussion topic, ask a question or make 
+announcements relating to the comments on this story.
                 </p>
               </div>
             </div>
diff --git a/src/core/client/stream/test/configure/streamConfiguration.spec.tsx b/src/core/client/stream/test/configure/streamConfiguration.spec.tsx
index 7c51227b6..c4e0ec702 100644
--- a/src/core/client/stream/test/configure/streamConfiguration.spec.tsx
+++ b/src/core/client/stream/test/configure/streamConfiguration.spec.tsx
@@ -161,7 +161,7 @@ it("change message box", async () => {
   });
 
   const enableField = within(form).getByLabelText(
-    "Enable Message Box for this Stream"
+    "Enable Message Box for this Story"
   );
 
   expect(applyButton.props.disabled).toBe(true);
diff --git a/src/core/client/stream/test/profile/__snapshots__/account.spec.tsx.snap b/src/core/client/stream/test/profile/__snapshots__/account.spec.tsx.snap
index 5bfe9b035..17d11d0ab 100644
--- a/src/core/client/stream/test/profile/__snapshots__/account.spec.tsx.snap
+++ b/src/core/client/stream/test/profile/__snapshots__/account.spec.tsx.snap
@@ -300,8 +300,8 @@ exports[`renders the empty settings pane 1`] = `
                         className="Box-root Typography-root Typography-bodyCopy Typography-colorTextPrimary"
                       >
                         An email has been sent to $email to verify your account.
-You must verify your new email address before it can be used for
-signing into your account or for email notifications.
+You must verify your new email address before it can be used 
+to sign in to your account or to receive notifications.
                       </p>
                       <button
                         className="BaseButton-root Button-root Button-sizeRegular Button-colorPrimary Button-variantRegular ChangeEmailContainer-resendButton coral coral-verifyEmail-resendButton"
diff --git a/src/core/server/locales/en-US/errors.ftl b/src/core/server/locales/en-US/errors.ftl
index 5acc743a8..baee0b902 100644
--- a/src/core/server/locales/en-US/errors.ftl
+++ b/src/core/server/locales/en-US/errors.ftl
@@ -50,10 +50,10 @@ error-userSuspended = Your account is currently suspended until {$until}.
 error-integrationDisabled = Specified integration is disabled.
 error-passwordResetTokenExpired = Password reset link expired.
 error-emailConfirmTokenExpired = Email confirmation link expired.
-error-rateLimitExceeded = Rate limit exceeded.
+error-rateLimitExceeded = You're trying to do that too many times. Please wait and try again.
 error-inviteTokenExpired = Invite link has expired.
 error-inviteRequiresEmailAddresses = Please add an email address to send invitations.
-error-passwordIncorrect = Password provided was incorrect.
+error-passwordIncorrect = Incorrect password. Please try again.
 error-usernameAlreadyUpdated = You may only change your username once every { framework-timeago-time }.
 error-persistedQueryNotFound = The persisted query with ID { $id } was not found.
 error-rawQueryNotAuthorized = You are not authorized to execute this query.
diff --git a/src/locales/en-US/admin.ftl b/src/locales/en-US/admin.ftl
index 40072cb7a..60dbe21bf 100644
--- a/src/locales/en-US/admin.ftl
+++ b/src/locales/en-US/admin.ftl
@@ -87,10 +87,10 @@ configure-permissionField-dontAllow = Don't allow
 ### General
 configure-general-guidelines-title = Community guidelines summary
 configure-general-guidelines-explanation =
-  Write a summary of your community guidelines that will appear
-  at the top of each comment stream sitewide. Your summary can be
-  formatted using Markdown Syntax. More information on how to use
-  Markdown can be found <externalLink>here</externalLink>.
+  This will appear above the comments sitewide. 
+  You can format the text using Markdown. 
+  More information on how to use Markdown 
+  <externalLink>here</externalLink>.
 configure-general-guidelines-showCommunityGuidelines = Show community guidelines summary
 
 #### Locale
@@ -100,10 +100,10 @@ configure-general-locale-chooseLanguage = Choose the language for your Coral com
 #### Sitewide Commenting
 configure-general-sitewideCommenting-title = Sitewide commenting
 configure-general-sitewideCommenting-explanation =
-  Open or close comment streams for new comments sitewide. When new comments
-  are turned off sitewide, new comments cannot be submitted, but existing
-  comments can continue to receive “Respect” reactions, be reported, and be
-  shared.
+  Open or close comment streams for new comments sitewide. 
+  When new comments are turned off, new comments cannot be 
+  submitted, but existing comments can continue to receive 
+  reactions, be reported, and be shared.
 configure-general-sitewideCommenting-enableNewCommentsSitewide =
   Enable new comments sitewide
 configure-general-sitewideCommenting-onCommentStreamsOpened =
@@ -145,7 +145,7 @@ configure-general-commentEditing-seconds = Seconds
 
 #### Closed Stream Message
 configure-general-closedStreamMessage-title = Closed comment stream message
-configure-general-closedStreamMessage-explanation = Write a message to appear after a story is closed for commenting.
+configure-general-closedStreamMessage-explanation = Write a message to appear when a story is closed for commenting.
 
 ### Organization
 configure-organization-name = Organization name
@@ -153,10 +153,10 @@ configure-organization-nameExplanation =
   Your organization name will appear on emails sent by { -product-name } to your community and organization members.
 configure-organization-email = Organization email
 configure-organization-emailExplanation =
-  This email address will be used as in emails and across
-  the platform for community members to get in touch with
-  the organization should they have any questions about the
-  status of their accounts or moderation questions.
+  Open or close comment streams for new comments sitewide. When new comments
+  are turned off sitewide, new comments cannot be submitted, but existing
+  comments can continue to receive reactions, be reported, and be
+  shared.
 configure-organization-url = Organization URL
 configure-organization-urlExplanation =
   Your organization url will appear on emails sent by { -product-name } to your community and organization members.
@@ -252,19 +252,18 @@ configure-auth-settings-session-duration-label = Session duration
 configure-moderation-recentCommentHistory-title = Recent history
 configure-moderation-recentCommentHistory-timeFrame = Recent comment history time period
 configure-moderation-recentCommentHistory-timeFrame-description =
-  The period of time over which a user’s rejection rate is calculated.
+  Amount of time to calculate a commenter's rejection rate.
 configure-moderation-recentCommentHistory-enabled = Recent history filter
 configure-moderation-recentCommentHistory-enabled-description =
-  Prevents repeat offenders from publishing comments without approval.
-  After a commenter's rejection rate rises above the defined threshold
-  below, their next submitted comments are <strong>sent to Pending for
-  moderator approval.</strong> The filter is removed when their rejection rate
-  falls below the threshold.
+  Prevents repeat offenders from publishing comments without approval. 
+  When a commenter's rejection rate is above the threshold, their 
+  comments are sent to Pending for moderator approval. This does not 
+  apply to Staff comments.
 configure-moderation-recentCommentHistory-triggerRejectionRate = Rejection rate threshold
 configure-moderation-recentCommentHistory-triggerRejectionRate-description =
-  A user’s rejected comments divided by their published comments, over
-  the time period set below (does not include comments pending for
-  toxicity, spam or pre-moderation.)
+  Rejected comments ÷ (rejected comments + published comments) 
+  over the timeframe above, as a percentage. It does not include 
+  comments pending for toxicity, spam or pre-moderation.
 
 #### Pre-Moderation
 configure-moderation-preModeration-title = Pre-moderation
@@ -280,13 +279,10 @@ configure-moderation-apiKey = API key
 
 configure-moderation-akismet-title = Spam detection filter
 configure-moderation-akismet-explanation =
-  Submitted comments are passed to the Akismet API for spam detection.
-  If a comment is determined to be spam, it will prompt the user,
-  indicating that the comment might be considered spam.
-  If the user continues after this point with the still spam-like comment,
-  the comment will be marked as containing spam, <strong>will not be published</strong> and
-  are placed in the <strong>Pending Queue for review by a moderator</strong>. If approved by a moderator,
-  the comment will be published.
+  The Akismet API filter warns users when a comment is determined likely 
+  to be spam. Comments that Akismet thinks are spam will not be published 
+  and are placed in the Pending Queue for review by a moderator. 
+  If approved by a moderator, the comment will be published.
 
 #### Akismet
 configure-moderation-akismet-filter = Spam detection filter
@@ -299,9 +295,12 @@ configure-moderation-akismet-siteURL = Site URL
 #### Perspective
 configure-moderation-perspective-title = Toxic comment filter
 configure-moderation-perspective-explanation =
-  Using the Perspective API, the Toxic Comment filter warns users when comments exceed the predefined toxicity
-  threshold. Comments with a toxicity score above the threshold <strong>will not be published</strong> and are placed in
-  the <strong>Pending Queue for review by a moderator</strong>. If approved by a moderator, the comment will be published.
+  Using the Perspective API, the Toxic Comment filter warns users 
+  when comments exceed the predefined toxicity threshold. 
+  Comments with a toxicity score above the threshold 
+  <strong>will not be published</strong> and are placed in
+  the <strong>Pending Queue for review by a moderator</strong>. 
+  If approved by a moderator, the comment will be published.
 configure-moderation-perspective-filter = Toxic comment filter
 configure-moderation-perspective-toxicityThreshold = Toxicity threshold
 configure-moderation-perspective-toxicityThresholdDescription =
@@ -309,7 +308,8 @@ configure-moderation-perspective-toxicityThresholdDescription =
   comment is toxic, according to Perspective API. By default the threshold is set to { $default }.
 configure-moderation-perspective-toxicityModel = Toxicity model
 configure-moderation-perspective-toxicityModelDescription =
-  Choose your Perspective Model. The default is { $default }. You can find out more about model choices <externalLink>here</externalLink>.
+  Choose your Perspective Model. The default is { $default }. 
+  You can find out more about model choices <externalLink>here</externalLink>.
 configure-moderation-perspective-allowStoreCommentData = Allow Google to store comment data
 configure-moderation-perspective-allowStoreCommentDataDescription =
   Stored comments will be used for future research and community model building purposes to
@@ -327,9 +327,7 @@ configure-wordList-banned-explanation =
   Comments containing a word or phrase in the banned words list are <strong>automatically rejected and are not published</strong>.
 configure-wordList-banned-wordList = Banned word list
 configure-wordList-banned-wordListDetail =
-  Separate banned words or phrases with a new line. Attempting to copy
-  and paste a comma separated list? <externalLink>Learn how to convert your list
-  to a new line separated list.</externalLink>
+  Separate banned words or phrases with a new line.
 
 #### Suspect Words Configuration
 configure-wordList-suspect-bannedWordsAndPhrases = Suspect words and phrases
@@ -339,9 +337,7 @@ configure-wordList-suspect-explanation =
   published (if comments are not pre-moderated).</strong>
 configure-wordList-suspect-wordList = Suspect word list
 configure-wordList-suspect-wordListDetail =
-  Separate suspect words or phrases with a new line. Attempting to copy
-  and paste a comma separated list? <externalLink>Learn how to convert your list
-  to a new line separated list.</externalLink>
+  Separate suspect words or phrases with a new line. 
 
 ### Advanced
 configure-advanced-customCSS = Custom CSS
@@ -356,7 +352,8 @@ configure-advanced-permittedDomains-description =
 
 configure-advanced-liveUpdates = Comment stream live updates
 configure-advanced-liveUpdates-explanation =
-  When enabled, there will be real-time loading and updating of comments as new comments and replies are published
+  When enabled, there will be real-time loading and updating of comments. 
+  When disabled, users will have to refresh the page to see new comments.
 
 configure-advanced-embedCode-title = Embed code
 configure-advanced-embedCode-explanation =
@@ -527,9 +524,8 @@ moderate-user-drawer-recent-history-calculated =
 moderate-user-drawer-recent-history-rejected = Rejected
 moderate-user-drawer-recent-history-tooltip-title = How is this calculated?
 moderate-user-drawer-recent-history-tooltip-body =
-  Rejected comments divided by the sum of rejected and
-  published comments, during the recent comment history
-  time frame.
+  Rejected comments ÷ (rejected comments + published comments). 
+  The threshold can be changed by administrators in Configure > Moderation.
 moderate-user-drawer-recent-history-tooltip-button =
   .aria-label = Toggle recent comment history tooltip
 moderate-user-drawer-recent-history-tooltip-submitted = Submitted
@@ -740,9 +736,8 @@ userDetails-suspension-end = <strong>End:</strong> { $timestamp }
 configure-general-reactions-title = Reactions
 configure-general-reactions-explanation =
   Allow your community to engage with one another and express themselves
-  with one-click reactions. By default, Coral allows commenters to
-  "Respect" each other's comments, but you may customize reaction text
-  based on the needs of your community.
+  with one-click reactions. By default, Coral allows commenters to "Respect" 
+  each other's comments. 
 configure-general-reactions-label = Reaction label
 configure-general-reactions-input =
   .placeholder = E.g. Respect
diff --git a/src/locales/en-US/stream.ftl b/src/locales/en-US/stream.ftl
index 84516f6b5..9d3faf931 100644
--- a/src/locales/en-US/stream.ftl
+++ b/src/locales/en-US/stream.ftl
@@ -22,7 +22,7 @@ comments-allCommentsTab = All Comments
 comments-featuredTab = Featured
 comments-featuredCommentTooltip-how = How is a comment featured?
 comments-featuredCommentTooltip-handSelectedComments =
-  Comments are hand selected by our team as worth reading.
+  Comments are chosen by our team as worth reading. 
 comments-featuredCommentTooltip-toggleButton =
   .aria-label = Toggle featured comments tooltip
 
@@ -197,8 +197,10 @@ profile-commentHistory-empty-subheading = A history of your comments will appear
 ### Account
 profile-account-ignoredCommenters = Ignored Commenters
 profile-account-ignoredCommenters-description =
-  Once you ignore someone, all of their comments are hidden from you.
-  Commenters you ignore will still be able to see your comments.
+  You can Ignore other commenters by clicking on their username 
+  and selecting Ignore. When you ignore someone, all of their 
+  comments are hidden from you. Commenters you Ignore will still 
+  be able to see your comments.
 profile-account-ignoredCommenters-empty = You are not currently ignoring anyone
 profile-account-ignoredCommenters-stopIgnoring = Stop ignoring
 profile-account-ignoredCommenters-manage = Manage
@@ -378,20 +380,24 @@ configure-stream-apply = Apply
 
 configure-premod-title = Enable Pre-Moderation
 configure-premod-description =
-  Moderators must approve any comment before it is published to this stream.
+  Moderators must approve any comment before it is published to this story.
 
 configure-premodLink-title = Pre-Moderate Comments Containing Links
 configure-premodLink-description =
-  Moderators must approve any comment that contains a link before it is published to this stream.
+  Moderators must approve any comment that contains a link before it is published to this story.
 
 configure-liveUpdates-title = Enable Live Updates for this Story
 configure-liveUpdates-description =
-  When enabled, there will be real-time loading and updating of comments as new comments and replies are published.
+  When enabled, the comments will be updated instantly 
+  as new comments and replies are submitted, instead of 
+  requiring a page refresh. You can disable this in the 
+  unusual situation of an article getting so much traffic that the comments are loading slowly.
 
-configure-messageBox-title = Enable Message Box for this Stream
+configure-messageBox-title = Enable Message Box for this Story
 configure-messageBox-description =
-  Add a message to the top of the comment box for your readers. Use this to pose a topic,
-  ask a question or make announcements relating to this story.
+  Add a message to the top of the comment box for your readers. 
+  Use this to suggest a discussion topic, ask a question or make 
+  announcements relating to the comments on this story.
 configure-messageBox-preview = Preview
 configure-messageBox-selectAnIcon = Select an Icon
 configure-messageBox-noIcon = No Icon
@@ -426,8 +432,8 @@ profile-changeEmail-edit = Edit
 profile-changeEmail-please-verify = Verify your email address
 profile-changeEmail-please-verify-details =
   An email has been sent to { $email } to verify your account.
-  You must verify your new email address before it can be used for
-  signing into your account or for email notifications.
+  You must verify your new email address before it can be used 
+  to sign in to your account or to receive notifications.
 profile-changeEmail-resend = Resend verification
 profile-changeEmail-heading = Edit your email address
 profile-changeEmail-desc = Change the email address used for signing in and for receiving communication about your account.