Commit ff55e129 authored by Suzanne Selhorn's avatar Suzanne Selhorn

Added guidance for this, these, that, those

parent d1e2729c
...@@ -347,11 +347,13 @@ Use instead of **sub-group**. ...@@ -347,11 +347,13 @@ Use instead of **sub-group**.
## that ## that
Do not use. For example: Do not use when describing a noun. For example:
- Avoid: The file that you save... - Avoid: The file **that** you save...
- Use instead: The file you save... - Use instead: The file you save...
See also [this, these, that, those](#this-these-that-those).
## there is, there are ## there is, there are
Try to avoid. These phrases hide the subject. Try to avoid. These phrases hide the subject.
...@@ -365,6 +367,22 @@ Avoid the use of gender-specific pronouns, unless referring to a specific person ...@@ -365,6 +367,22 @@ Avoid the use of gender-specific pronouns, unless referring to a specific person
Use a singular [they](https://developers.google.com/style/pronouns#gender-neutral-pronouns) as Use a singular [they](https://developers.google.com/style/pronouns#gender-neutral-pronouns) as
a gender-neutral pronoun. a gender-neutral pronoun.
## this, these, that, those
Always follow these words with a noun. For example:
- Avoid: **This** improves performance.
- Use instead: **This setting** improves performance.
- Avoid: **These** are the best.
- Use instead: **These pants** are the best.
- Avoid: **That** is the one you are looking for.
- Use instead: **That Jedi** is the one you are looking for.
- Avoid: **Those** need to be configured.
- Use instead: **Those settings** need to be configured. (Or even better, **Configure those settings.**)
## to-do item ## to-do item
Use lowercase. ([Vale](../testing.md#vale) rule: [`ToDo.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale/gitlab/ToDo.yml)) Use lowercase. ([Vale](../testing.md#vale) rule: [`ToDo.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale/gitlab/ToDo.yml))
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment