OpenShiftAsciiDoc - no alphanumeric charaters in headings

Author: rohennes

.vale/fixtures/OpenShiftAsciiDoc/HeadingsAlphanumeric/.vale.ini

@@ -0,0 +1,5 @@
+; Vale configuration file to test the `HardWrappedLines` rule
+StylesPath = ../../../styles
+MinAlertLevel = error
+[*.adoc]
+OpenShiftAsciiDoc.HeadingsAlphanumeric = YES

.vale/fixtures/OpenShiftAsciiDoc/HeadingsAlphanumeric/testinvalid.adoc

@@ -0,0 +1,8 @@
+//vale-fixture
+= Don't Use: Special Characters in Headings
+
+//vale-fixture
+== No @Symbols! Here
+
+//vale-fixture
+== No periods.

.vale/fixtures/OpenShiftAsciiDoc/HeadingsAlphanumeric/testvalid.adoc

@@ -0,0 +1,9 @@
+//vale-fixture
+= Valid Headings with Alphanumeric Characters Only
+
+//vale-fixture
+== Exceptions include attribute references like {product-name}
+
+== Also allow single quotes even though we don't like them
+
+== And `backticks` are allowed too even though I cannot remember if we allow them in the style guide

.vale/styles/OpenShiftAsciiDoc/HeadingsAlphanumeric.yml

@@ -0,0 +1,9 @@
+---
+extends: existence
+scope: raw
+level: error
+link: https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#anchoring-in-module-files
+message: "Headings should only contain alphanumeric characters."
+nonword: true
+tokens:
+  - "^=+\\s+.*[^a-zA-Z0-9\\s\\{\\}'`-].*$"