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**.
## 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...
See also [this, these, that, those](#this-these-that-those).
## there is, there are
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
Use a singular [they](https://developers.google.com/style/pronouns#gender-neutral-pronouns) as
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
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