From 001b49216bdf69ecb2e79937b2fa0f35dac801ea Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Wed, 21 Sep 2022 08:41:56 +0100 Subject: [PATCH] new recommended words (#15703) --- contribute/overview.md | 2 +- contribute/style/recommended-words.md | 12 ++++++++++++ 2 files changed, 13 insertions(+), 1 deletion(-) diff --git a/contribute/overview.md b/contribute/overview.md index 93ed00f163..2d91453307 100644 --- a/contribute/overview.md +++ b/contribute/overview.md @@ -77,4 +77,4 @@ We also provide: - A section of useful components you can add to your documentation. For components and controls, we use [Bootstrap](https://getbootstrap.com) - Information on Docker's [tone and voice](style/voice-tone.md). -- A [writing checklist](checklist.md) to help you when you're contributing to Docker's documentation. \ No newline at end of file +- A [writing checklist](checklist.md) to help you when you're contributing to Docker's documentation. diff --git a/contribute/style/recommended-words.md b/contribute/style/recommended-words.md index 2b25fc09dc..16bbc101c3 100644 --- a/contribute/style/recommended-words.md +++ b/contribute/style/recommended-words.md @@ -40,6 +40,12 @@ Do not use `currently` when talking about the product or its features. The docum Don’t use `deselect`. Instead, use `clear`. +#### disable + +Do not use `disable`. Implies that disability is a less-desired or negative state. + +Instead, use `turn off` or `toggle off`. + #### earlier Use `earlier` when talking about version numbers. @@ -52,6 +58,12 @@ Instead of: _In Docker Desktop 4.1 and lower._ +#### enable + +Do not use `enable`. Implies that disability is a less-desired or negative state. + +Instead, use `turn on` or `toggle on`. + #### execute Avoid where possible. Use `run` instead.