From 87acb6a36e47f9a87f6d66acad0bd683eedc58a9 Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Fri, 9 Aug 2024 11:41:32 +0100 Subject: [PATCH] ENGDOCS-2176 (#20569) --- .github/vale/Docker/RecommendedWords.yml | 1 - content/contribute/style/grammar.md | 4 ---- content/contribute/style/recommended-words.md | 4 ---- 3 files changed, 9 deletions(-) diff --git a/.github/vale/Docker/RecommendedWords.yml b/.github/vale/Docker/RecommendedWords.yml index be22d589ac..c4bd532dfb 100644 --- a/.github/vale/Docker/RecommendedWords.yml +++ b/.github/vale/Docker/RecommendedWords.yml @@ -31,7 +31,6 @@ swap: check box: checkbox check boxes: checkboxes click: select - deselect: clear ergo: therefore file name: filename keypress: keystroke diff --git a/content/contribute/style/grammar.md b/content/contribute/style/grammar.md index 74d925d2e7..422d02157a 100644 --- a/content/contribute/style/grammar.md +++ b/content/contribute/style/grammar.md @@ -172,7 +172,3 @@ Avoid the use of exclamation marks. ### Parentheses Don't use parentheses in technical documentation. They can reduce the readability of a sentence. - -## Third party documentation - -If you are documenting a task that requires the use of a third-party product, link out to the third-party's documentation. Don't copy the content because it might violate copyright. It can also result in an unnecessary maintenance burden of having to keep the docs up-to-date when the third-party changes or updates their product. It is best practice to link to the single source of truth. diff --git a/content/contribute/style/recommended-words.md b/content/contribute/style/recommended-words.md index 74ea06a20d..19ee3091c4 100644 --- a/content/contribute/style/recommended-words.md +++ b/content/contribute/style/recommended-words.md @@ -58,10 +58,6 @@ Select applies to more devices, while click is more specific to a mouse. Don't use `currently` when talking about the product or its features. The documentation describes the product as it is today. -#### deselect - -Don’t use `deselect`. Instead, use `clear`. - #### disable Don't use `disable`. Implies that disability is a less-desired or negative state.