From 07268c9d18350e7bad580c0b63568c03e7364d16 Mon Sep 17 00:00:00 2001 From: Nathan Bower Date: Thu, 7 Sep 2023 12:58:11 -0400 Subject: [PATCH] Remove terms as inoffensive (#4983) Signed-off-by: natebower <102320899+natebower@users.noreply.github.com> --- STYLE_GUIDE.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md index fa3b687b..9d7c0387 100644 --- a/STYLE_GUIDE.md +++ b/STYLE_GUIDE.md @@ -486,8 +486,6 @@ The following terms may be associated with unconscious racial bias, violence, or | abort | Don't use because it has unpleasant associations and is unnecessarily harsh sounding. Use *stop*, *end*, or *cancel* instead. | | black day | blocked day | | blacklist | deny list | -| execute | Replace with a more specific verb. In the sense of carrying out an action, use *run*, *process*, or *apply*. In the sense of initiating an operation, use *start*, *launch*, or *initiate*.

Exception: *Execution* is unavoidable for third-party terms for which no alternative was determined, such as SQL execution plans. *Executable* is also unavoidable. | -| hang | Don't use. This term is unnecessarily violent for technical documentation. Use *stop responding* instead. | | kill | Don't use. Replace with *stop*, *end*, *clear*, *remove*, or *cancel*.

Exception: *Kill* is unavoidable when referring to Linux kill commands. | | master | primary, main, leader | | master account | management account | @@ -503,11 +501,7 @@ The following terms may be problematic *in some contexts*. This doesn’t mean t |--------------------------|-------------------------------------| | blackout | service outage, blocked | | demilitarized zone (DMZ) | perimeter network, perimeter zone | -| invalid | not valid | | primitive | Avoid using *primitive* (especially plural *primitives*) as a colloquial way of referring to the basic concepts or elements that are associated with a feature or to the simplest elements in a programming language. For greatest clarity and to avoid sounding unpleasant, replace with *primitive data type* or *primitive type*. | -| purge | Use only in reference to specific programming methods. Otherwise, use *delete*, *clear*, or *remove* instead. | -| segregate | separate, isolate | -| trigger | Avoid using as a verb to refer to an action that precipitates a subsequent action. It is OK to use when referring to a feature name, such as a *trigger function* or *time-triggered architecture*. As a verb, use an alternative, such as *initiate*, *invoke*, *launch*, or *start*. | ## Trademark policy