Commit ccc80751 authored by Susan Tacker's avatar Susan Tacker

Added examples of wordiness

parent 09c369d1
......@@ -300,11 +300,17 @@ Do not include the same information in multiple places.
## Language
GitLab documentation should be clear and easy to understand.
GitLab documentation should be clear and easy to understand. Avoid unnecessary words.
- Be clear, concise, and stick to the goal of the documentation.
- Be clear, concise, and stick to the goal of the topic.
- Write in US English with US grammar. (Tested in [`British.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale/gitlab/British.yml).)
- Use [inclusive language](#inclusive-language).
- Rewrite to avoid wordiness:
- there is
- there are
- enables you to
- in order to
- because of the fact that
### Capitalization
......
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