Merge pull request #74633 from aireilly/update-prow-gen-docs

Tweaking Prow docs and template yaml

Author: aireilly

scripts/prow/README.adoc

@@ -33,8 +33,15 @@ When you add a new enterprise branch, remember to remove `openshift-rosa` and `o
 
 For example, when the current version is 4.15, and you create a enterprise-4.16 branch, remove `openshift-rosa` and `openshift-osd` distros from the enterprise-4.15 branch build.
 ====
++
+[NOTE]
+====
+You can optionally add an `openshift-docs-vale-review` test step to the `validate-asciidoc` job.
+For example, review the `validate-asciidoc` test steps: link:https://github.com/openshift/release/blob/master/ci-operator/config/openshift/openshift-docs/openshift-openshift-docs-main.yaml[openshift-openshift-docs-main.yaml].
+This test step adds a Vale linting run on open PRs.
+====
 
-. Change to the `$HOME/release` directory and verify that the new build config has been added. For example:
+. Change to the `$HOME/release` directory and verify that the new build config has been added.
 +
 [source,text]
 ----

scripts/prow/openshift-openshift-docs-BRANCH.yaml

@@ -21,16 +21,19 @@ tests:
     - ref: openshift-docs-build-docs
     - ref: openshift-docs-preview-comment-pages
 - as: validate-asciidoc
+  steps:
+    test:
+    - ref: openshift-docs-asciidoctor
+    - ref: openshift-docs-lint-topicmaps
+- as: validate-portal
   steps:
     env:
       BUILD: build_for_portal.py
       DISTROS: ${DISTROS}
       VERSION: "${VERSION}"
     test:
-    - ref: openshift-docs-asciidoctor
-    - ref: openshift-docs-lint-topicmaps
     - ref: openshift-docs-portal
 zz_generated_metadata:
   branch: ${BRANCH}
   org: openshift
-  repo: openshift-docs
+  repo: openshift-docs