Aidan Reilly

Should cause a Vale error: ``` nodes/clusters/nodes-cluster-overcommit.adoc:38 container density on nodes. You can configure cluster-level overcommit using the xref:#nodes-cluster-resource-override_nodes-cluster-overcommit[ClusterResourceOverride Operator] ```

Create a Vale AsciiDoc rule that catches in source. Example error in output: https://access.redhat.com/documentation/en-us/openshift_container_platform/4.12/html/scalability_and_performance/what-huge-pages-do-and-how-they-are-consumed#consuming-huge-pages-resource-using-the-downward-api_huge-pages

OpenShiftAsciiDoc/CheckDollarSymbolInTerminalBlock.yml flags an error where there is none

1

The `OpenShiftAsciiDoc/CheckDollarSymbolInTerminalBlock.yml` shows an error incorrectly in the below file. IMO this rule should not raise an error at all, the below problem notwithstanding. ``` . Verify that a matching...

`ifdef::revnumber[This document has a version number of {revnumber}.]` is a valid oneline ifdef that does not get caught by the ValidConditions rule. https://docs.asciidoctor.org/asciidoc/latest/directives/ifdef-ifndef/

Adding en dash rule

2

Fixes https://github.com/redhat-documentation/vale-at-red-hat/issues/698

 https://www.ibm.com/docs/en/ibm-style?topic=measurement-numbers#ranges

Create a localization rule to highlight common errors that cause trouble for translators

11

Vale can help us produce content that makes localization easier. There are many English language usages that can cause problems for localization. For example, in the ISG, "should" is a...

[Vale vocabularies](https://vale.sh/docs/topics/vocab/) are useful for managing errors at the docs project level that you don't want to see in Vale. Vocab terms can be considered for later inclusion in rules.

Specifically: https://github.com/redhat-documentation/vale-at-red-hat/blob/main/.vale/fixtures/RedHat/Headings/testvalid.adoc?plain=1#L17 ``` ┌───── ~/vale-at-red-hat/.vale/fixtures/RedHat/Headings (fix-tests) $ vale . testvalid.adoc 17:4 suggestion Use sentence-style RedHat.Headings capitalization in 'Spotify, GraphQL, and Quiltflower are proper nouns so uppercase in headings is OK.'....

This could potentially be codified as a Vale rule.