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.