Don't lint commented lines

.github/workflows/vale-on-pull.yml

@@ -13,9 +13,11 @@ on: [pull_request]
 jobs:
   vale:
     name: Linting with Vale
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     steps:
       - uses: actions/checkout@v4
+      - name: Install Asciidoctor
+        run: sudo apt-get install -y asciidoctor
       - uses: errata-ai/vale-action@reviewdog
         with:
           filter_mode: diff_context

.gitignore

@@ -11,6 +11,7 @@
 /.ruby-version
 /.yardoc/
 /build/
+bin
 /Gemfile.lock
 /node_modules/
 /pkg/

.vale/fixtures/OpenShiftAsciiDoc/NoXrefInModules/testvalid.adoc

@@ -1 +1,3 @@
 No xrefs here!
+
+//xref:../rosa_getting_started/rosa-getting-started.adoc#rosa-getting-started[Getting started with {product-title}]

.vale/fixtures/OpenShiftAsciiDoc/XrefContainsAnchorID/testvalid.adoc

@@ -1,3 +1,5 @@
 xref:../rosa_getting_started/rosa-getting-started.adoc#getting-started[Getting started with {product-title}]
 
 xref:../rosa_getting_started/rosa-getting-started.adoc#getting-started
+
+// stuff xref:../rosa/rosa-getting-started.adoc[Getting started with {product-title}]

.vale/fixtures/OpenShiftAsciiDoc/XrefContainsHTML/testvalid.adoc

@@ -1,6 +1,6 @@
+//vale-fixture
 xref:../rosa_getting_started/rosa-getting-started.adoc#getting-started[Getting started with {product-title}]
 
-xref:../rosa_getting_started/rosa-getting-started.adoc#getting-started
-
+//xref:../rosa_getting_started/rosa-getting-started.html#getting-started[Getting started with {product-title}]
 
 

.vale/fixtures/RedHat/GitLinks/testvalid.adoc

@@ -1,2 +1,2 @@
 https://github.com/openshift/*
-https://github.com/redhat-developer/*
+https://github.com/redhat-developer/*

.vale/styles/OpenShiftAsciiDoc/NoXrefInModules.yml

@@ -5,4 +5,4 @@ level: error
 link: https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#links-hyperlinks-and-cross-references
 message: "Do not include xrefs in modules, only assemblies."
 tokens:
-  - 'xref:(.*)(\.adoc)#(.*)'
+  - '(?<!\/\/.*)xref:(.*)(\.adoc)#(.*)'

.vale/styles/OpenShiftAsciiDoc/XrefContainsAnchorID.yml

@@ -5,4 +5,4 @@ level: error
 link: https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#links-hyperlinks-and-cross-references
 message: "The xref is missing an anchor ID."
 raw:
-  - 'xref(.*)(\.adoc)(?!\#)'
+  - '(?<!\/\/.*)xref(.*)(\.adoc)(?!\#)'

.vale/styles/OpenShiftAsciiDoc/XrefContainsHTML.yml

@@ -5,4 +5,4 @@ level: error
 link: https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#links-hyperlinks-and-cross-references
 message: "Use .adoc instead of .html in xrefs"
 tokens:
-  - 'xref(.*)(\.html)#(.*)'
+  - '(?<!\/\/.*)xref(.*)(\.html)#(.*)'

.vale/styles/RedHat/GitLinks.yml

@@ -8,5 +8,5 @@ scope: raw
 action:
   name: remove
 tokens:
-  - 'https:\/\/gitlab\.com\/.*'
-  - 'https:\/\/github\.com\/(?!openshift|redhat-developer).*'
+  - 'https:\/\/gitlab\.com'
+  - 'https:\/\/github\.com(?!\/openshift|redhat-developer)'

antora-playbook.yml

@@ -20,7 +20,6 @@ content:
     - url: ./
       branches:
         - HEAD
-        - v*
       edit_url: "https://github.com/redhat-documentation/vale-at-red-hat/edit/main/{path}"
 antora:
   extensions:

modules/contributor-guide/nav.adoc

@@ -1,5 +1,4 @@
-.xref:contributor-guide.adoc[Vale at Red Hat contributor guide]
-
+.Vale at Red Hat contributor guide
 * xref:contributing.adoc[]
 * xref:vale-at-red-hat-repository.adoc[]
 * xref:extending-the-spelling-rule.adoc[]

modules/reference-guide/nav.adoc

@@ -1,5 +1,4 @@
-.xref:reference-guide.adoc[Vale rules reference guide]
-
+.Vale rules reference guide
 * xref:abbreviations.adoc[]
 * xref:casesensitiveterms.adoc[]
 * xref:conjunctions.adoc[]

modules/user-guide/nav.adoc

@@ -1,5 +1,4 @@
-.xref:user-guide.adoc[Vale at Red Hat user guide]
-
+.Vale at Red Hat user guide
 * xref:introduction.adoc[]
 * xref:installing-vale-cli.adoc[]
 * xref:installing-redhat-style-for-vale.adoc[]

modules/user-guide/pages/using-vale-in-the-ide.adoc

@@ -16,7 +16,7 @@ Consider using Vale in your IDE when:
 .Prerequisites
 
 * Vale CLI is installed and configured. See xref:installing-vale-cli.adoc[].
-* link:https://code.visualstudio.com/docs/setup/setup-overview[Visual Studio Code] is installed.
+* link:https://github.com/microsoft/vscode[Visual Studio Code] is installed.
 
 .Procedure