Add UI checklist items to Pajamas documentation
Evaluate each of the following UI content checklist items. Add to the Pajamas documentation any not already covered.
- Present tense rather than future. https://design.gitlab.com/content/voice-tone#instructions
- Active voice. https://design.gitlab.com/content/voice-tone#active-voice
- No periods for settings or headings. https://design.gitlab.com/content/punctuation#periods
- Periods for all help text.
- No repetitive or unnecessary text. (Things like: This setting is... or "Use this setting to.")
- Oxford comma used correctly. (This, this, and this.)
- Language is parallel. (Review all the settings in the section to ensure they are similarly-worded.) https://design.gitlab.com/content/voice-tone#parallelism
- If a setting is optional, then "optional" is in parentheses at the end of the setting name. https://design.gitlab.com/components/form/#required-information
- Latinisms (i.e., e.g.) removed. https://design.gitlab.com/content/voice-tone#avoid-latin-abbreviations
- Don't use "allow" unless you're specifically talking about security. For example, "Allows users to fork the repo" should be "Users can fork the repo."
- If there's a documentation link, attempt to refer to the link as a question (like, "How do I configure runners?"). If not possible, use "Learn more." https://design.gitlab.com/usability/helping-users#formatting-help-content