From ed2d411aa84efc76baba3adf0d0f99df0e44ba57 Mon Sep 17 00:00:00 2001 From: Carlton Gibson Date: Thu, 5 Sep 2019 09:54:01 +0200 Subject: [PATCH] Refs #30573 -- Noted to avoid "simple" & co. in Writing Style guide. Co-authored-by: Tobias Kunze --- docs/internals/contributing/writing-documentation.txt | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/internals/contributing/writing-documentation.txt b/docs/internals/contributing/writing-documentation.txt index 09e0629a75..0bfeeb62e3 100644 --- a/docs/internals/contributing/writing-documentation.txt +++ b/docs/internals/contributing/writing-documentation.txt @@ -129,6 +129,12 @@ Instead of: * his or hers... use theirs. * himself or herself... use themselves. +Try to avoid using words that minimise the difficulty involved in a task or +operation, such as "easily", "simply", "just", "merely", "straightforward", and +so on. People's experience may not match your expectations, and they may become +frustrated when they do not find a step as "straightforward" or "simple" as it +is implied to be. + Commonly used terms ===================