Commit a0b2a76d authored by Amy Qualls's avatar Amy Qualls Committed by Marcel Amirault

Create initial test for possessive use

The word GitLab should never be used in the form of "GitLab's" for
legal reasons. Create a test to help eradicate the usage.
parent 8ef5490c
---
# Warning: gitlab.Possessive
#
# The word GitLab should not be used in the possessive form.
#
# For a list of all options, see https://errata-ai.gitbook.io/vale/getting-started/styles
extends: existence
message: 'Rewrite "%s" to not use "’s".'
level: warning
ignorecase: true
link: https://docs.gitlab.com/ee/development/documentation/styleguide/#contractions
tokens:
- GitLab's # Straight apostrophe.
- GitLab’s # Curly closing apostrophe.
- GitLab‘s # Curly opening apostrophe.
...@@ -329,6 +329,13 @@ GitLab documentation should be clear and easy to understand. ...@@ -329,6 +329,13 @@ GitLab documentation should be clear and easy to understand.
- Write in US English with US grammar. (Tested in [`British.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale/gitlab/British.yml).) - 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). - Use [inclusive language](#inclusive-language).
### Trademark
Only use the GitLab name and trademarks in accordance with
[GitLab Brand Guidelines](https://about.gitlab.com/handbook/marketing/inbound-marketing/digital-experience/brand-guidelines/#trademark).
Don't use the possessive form of the word GitLab (`GitLab's`).
### Point of view ### Point of view
In most cases, it’s appropriate to use the second-person (you, yours) point of In most cases, it’s appropriate to use the second-person (you, yours) point of
...@@ -608,11 +615,13 @@ especially in tutorials, instructional documentation, and ...@@ -608,11 +615,13 @@ especially in tutorials, instructional documentation, and
Some contractions, however, should be avoided: Some contractions, however, should be avoided:
- Do not use [the word GitLab in a contraction](#trademark).
- Do not use contractions with a proper noun and a verb. For example: - Do not use contractions with a proper noun and a verb. For example:
| Do | Don't | | Do | Don't |
|------------------------------------------|-----------------------------------------| |------------------------------------------|-----------------------------------------|
| GitLab is creating X. | GitLab's creating X. | | Canada is establishing X. | Canada's establishing X. |
- Do not use contractions when you need to emphasize a negative. For example: - Do not use contractions when you need to emphasize a negative. For example:
......
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