"This" and "there is/are" in CI YAML reference doc
Problem to solve
This topic: https://docs.gitlab.com/ee/ci/yaml/README.html uses words that need to modify a word that's missing.
Further details
This
In this topic, search for "This" and see if there is a word after it.
For example:
- This runs the job.
- This makes your life easier.
The better way to write this:
- This command runs the job.
- This setting makes your life easier.
There is/are
In this topic, search for "there is" and "there are" and see if the sentence or phrase can be re-written to remove that language.
OK:
- There are settings you can use to do this thing.
- There are three ways to do this thing.
Better:
(Start with what you want to do, then follow up with action.)
- To do this thing, use these settings.
- To do this thing, choose one of these options:
Other links/references
Related to: &4138 (closed)
Edited by Suzanne Selhorn