diff options
author | GitLab Bot <gitlab-bot@gitlab.com> | 2021-06-30 03:07:45 +0300 |
---|---|---|
committer | GitLab Bot <gitlab-bot@gitlab.com> | 2021-06-30 03:07:45 +0300 |
commit | e222250937b497b4cf6e9b8e5ddde0097f0e0954 (patch) | |
tree | 28884b81a74a2d9da5bb446c925b4903b512ae81 /doc/development/documentation/testing.md | |
parent | 97eb4a009519453821dcae6c99049e490863adce (diff) |
Add latest changes from gitlab-org/gitlab@master
Diffstat (limited to 'doc/development/documentation/testing.md')
-rw-r--r-- | doc/development/documentation/testing.md | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/doc/development/documentation/testing.md b/doc/development/documentation/testing.md index b634e2b93db..95b3d4e47a7 100644 --- a/doc/development/documentation/testing.md +++ b/doc/development/documentation/testing.md @@ -210,6 +210,20 @@ Vale returns three types of results: `suggestion`, `warning`, and `error`: of how to resolve the error. Errors break CI and are displayed in CI job output. See a list of [error-level rules](https://gitlab.com/search?utf8=✓&snippets=false&scope=&repository_ref=master&search=path%3Adoc%2F.vale%2Fgitlab+Error%3A&group_id=9970&project_id=278964). +#### Vale spelling test + +When Vale flags a valid word as a spelling mistake, you can fix it following these +guidelines: + +| Flagged word | Guideline | +|------------------------------------------------------|-----------| +| jargon | Rewrite the sentence to avoid it. | +| *correctly-capitalized* name of a product or service | Add the word to the [vale spelling exceptions list](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale/gitlab/spelling-exceptions.txt). | +| name of a person | Remove the name if it's not needed, or [add the vale exception code in-line](#disable-vale-tests). | +| a command, variable, code, or similar | Put it in backticks or a code block. For example: ``The git clone command can be used with the CI_COMMIT_BRANCH variable.`` -> ``The `git clone` command can be used with the `CI_COMMIT_BRANCH` variable.`` | +| UI text from GitLab | Verify it correctly matches the UI, then: <ul><li>If it does not match the UI, update it.</li><li>If it matches the UI, but the UI seems incorrect, create an issue to see if the UI needs to be fixed.</li><li>If it matches the UI and seems correct, add it to the [vale spelling exceptions list](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/.vale/gitlab/spelling-exceptions.txt).</li></ul> | +| UI text from a third-party product | Rewrite the sentence to avoid it, or [add the vale exception code in-line](#disable-vale-tests). | + ### Install linters At a minimum, install [markdownlint](#markdownlint) and [Vale](#vale) to match the checks run in |