Merge pull request #163 from rachel-mack/DOCSP-33817-disable-fail

Clarification of acceptable use of "fail" and "disable"

Author: rachel-mack

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

@@ -109,8 +109,8 @@ D
           -
 
    disabled
-     :icon-fa4:`exclamation-triangle` Don't use *disabled* to describe
-     inactive commands, options, or buttons on the interface. Use
+     :icon-fa4:`exclamation-triangle` Use *inactive* to describe
+     commands, options, toggles, or buttons in the interface. Use
      *dimmed* to describe the appearance of an inactive command,
      option, or button; use *unavailable* to refer to its state. Don't
      use *disabled* to refer to individuals with disabilities.

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

@@ -4,7 +4,10 @@ F
 .. glossary::
 
    fail to
-     :icon-fa4:`times-circle` Use *unable to* instead.
+     :icon-fa4:`times-circle` Use *unable to* when you when refer to an individual or
+     company. 
+     
+     You may use *fail* to describe system performance.
 
    FAQ
      Use the acronym *FAQ* to refer to an article or section that

source/style-guide/writing/use-positive-statements.txt

@@ -31,8 +31,9 @@ and are typically shorter.
 Avoid Negative Words
 --------------------
 
-Try to avoid the following negative words, using instead the suggested
-alternatives. However, always be honest and transparent about issues.
+Try to avoid the following negative words, using instead the suggested alternatives,
+particularly in reference to the user or the company. However, always communicate honestly and
+transparently about issues, and accurately describe a system's performance.
 
 .. list-table::
    :widths: 50 50