Merge branch '284058-docs-aqualls-vale-rule-types' into 'master'

Define Vale result types in testing.md

See merge request gitlab-org/gitlab!49862

doc/development/documentation/testing.md

@@ -192,6 +192,20 @@ You can use Vale:
 - [In a Git hook](#configure-pre-push-hooks). Vale only reports errors in the Git hook (the same
   configuration as the CI/CD pipelines), and does not report suggestions or warnings.
 
+#### Vale
+
+Vale returns three types of results: `suggestion`, `warning`, and `error`:
+
+- **Suggestion**-level results are writing tips and aren't displayed in CI
+  job output. Suggestions don't break CI.
+- **Warning**-level results are [Style Guide](styleguide/index.md) violations, aren't displayed in CI
+  job output, and should contain clear explanations of how to resolve the warning.
+  Warnings may be technical debt, or can be future error-level test items
+  (after the Technical Writing team completes its cleanup). Warnings don't break CI.
+- **Error**-level results are Style Guide violations, and should contain clear explanations
+  about how to resolve the error. Errors break CI and are displayed in CI job output.
+  of how to resolve the error. Errors break CI and are displayed in CI job output.
+
 ### Install linters
 
 At a minimum, install [markdownlint](#markdownlint) and [Vale](#vale) to match the checks run in