---
# Suggestion: gitlab.SubstitutionSuggestions
#
# Suggests better options for frequently misused terms that are often - but not always - incorrect.
# SubstitutionWarning.yml and Substitutions.yml also exist.
#
# For a list of all options, see https://vale.sh/docs/topics/styles/
extends: substitution
message: "Consider '%s' instead of '%s'."
link: https://docs.gitlab.com/ee/development/documentation/styleguide/word_list.html
level: suggestion
ignorecase: true
swap:
  active user: "billable user"
  active users: "billable users"
  docs: "documentation"
  e-mail: "email"
  GLFM: "GitLab Flavored Markdown"
  it is recommended: "you should"
  we recommend: "you should"
  navigate: go
  OAuth2: "OAuth 2.0"
  once that: "after that"
  once the: "after the"
  once you: "after you"
  since: "because' or 'after"
  sub-group: "subgroup"
  sub-groups: "subgroups"
  within: "in"