Merge branch 'main' into RHIDP-3742-Discover-Correct-book-title

Author: hmanwani-rh

.github/workflows/build-asciidoc.yml

@@ -17,7 +17,7 @@ name: GitHub Pages
 
 on:
   push:
-    branches: 
+    branches:
     - main
     - rhdh-1.**
     - 1.**.x
@@ -41,14 +41,14 @@ jobs:
       run: |
         # update
         sudo apt-get update -y || true
-        # install 
-        sudo apt-get -y -q install asciidoctor && asciidoctor --version
+        # install
+        sudo apt-get -y -q install podman && podman --version
         echo "GIT_BRANCH=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_ENV
 
     - name: Build guides and indexes
       run: |
         echo "Building branch ${{ env.GIT_BRANCH }}"
-        build/scripts/build.sh -b ${{ env.GIT_BRANCH }}
+        build/scripts/build-ccutil.sh -b ${{ env.GIT_BRANCH }}
 
     # repo must be public for this to work
     - name: Deploy
@@ -60,7 +60,7 @@ jobs:
         keep_files: true
         publish_dir: ./titles-generated
 
-    - name: Cleanup merged PR branches 
+    - name: Cleanup merged PR branches
       run: |
         PULL_URL="https://api.github.com/repos/redhat-developer/red-hat-developers-documentation-rhdh/pulls"
         GITHUB_TOKEN="${{ secrets.RHDH_BOT_TOKEN }}"
@@ -70,7 +70,7 @@ jobs:
         git checkout gh-pages; git pull || true
         dirs=$(find . -maxdepth 1 -name "pr-*" -type d | sed -r -e "s|^\./pr-||")
         refs=$(cat pulls.html | grep pr- | sed -r -e "s|.+.html>pr-([0-9]+)</a>.+|\1|")
-        for d in $(echo -e "$dirs\n$refs" | sort -uV); do 
+        for d in $(echo -e "$dirs\n$refs" | sort -uV); do
           PR="${d}"
           echo -n "Check merge status of PR $PR ... "
           PR_JSON=$(curl -sSL -H "Accept: application/vnd.github+json" -H "Authorization: Bearer $GITHUB_TOKEN" "$PULL_URL/$PR")

.github/workflows/pr.yml

@@ -48,7 +48,7 @@ jobs:
           echo "✓"
 
   adoc_build:
-    name: Asciidoctor Build For PR branch preview
+    name: Ccutil Build For PR branch preview
     runs-on: ubuntu-latest
     needs: authorize
     permissions:
@@ -69,13 +69,13 @@ jobs:
           # update
           sudo apt-get update -y || true
           # install 
-          sudo apt-get -y -q install asciidoctor && asciidoctor --version
+          sudo apt-get -y -q install podman && podman --version
           echo "GIT_BRANCH=${GITHUB_HEAD_REF:-${GITHUB_REF#refs/heads/}}" >> $GITHUB_ENV
 
       - name: Build guides and indexes
         run: |
           echo "Building PR ${{ github.event.pull_request.number }}"
-          build/scripts/build.sh -b "pr-${{ github.event.number }}"
+          build/scripts/build-ccutil.sh -b "pr-${{ github.event.number }}"
 
       - name: Pull from origin before pushing (if possible)
         run: |

.github/workflows/style-guide.yml

@@ -0,0 +1,22 @@
+---
+name: Verify style guide compliance on pull request
+on: [pull_request]
+
+jobs:
+  vale:
+    name: Linting with Vale
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Install Asciidoctor
+        run: sudo apt-get install -y asciidoctor
+      - name: Run Vale on new and modified content
+        uses: errata-ai/[email protected]
+        with:
+          files: assemblies
+          vale_flags: "--minAlertLevel=warning"
+          reporter: github-pr-review
+        env:
+          GITHUB_TOKEN: ${{ secrets.RHDH_BOT_TOKEN }}
+          REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.RHDH_BOT_TOKEN }}

.gitignore

@@ -2,7 +2,6 @@
 titles/*/build
 index.html
 titles-generated/
-.vale.ini
 .vale-styles/RedHat
 .vscode
 .cache/

.vale-styles/DeveloperHub/tests/.vale.ini

@@ -0,0 +1,12 @@
+; .vale.ini
+; Specifies Vale configuration
+; See: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/user-guide/installing-vale-cli/
+;
+; Download and search Vale styles in this directory:
+StylesPath = ../..
+; Minimum alert level to display:
+MinAlertLevel = suggestion
+; Display alerts on AsciiDoc files:
+[*.adoc]
+; Apply these styles:
+BasedOnStyles = DeveloperHub

.vale.ini

@@ -0,0 +1,18 @@
+# .vale.ini
+# Specifies Vale configuration
+# See: https://redhat-documentation.github.io/vale-at-red-hat/docs/main/user-guide/installing-vale-cli/
+#
+
+# Download and search Vale styles in this directory:
+StylesPath = ".vale-styles"
+
+# Minimum alert level to display:
+MinAlertLevel = suggestion
+
+# Styles to download:
+Packages = RedHat
+
+# Display alerts on AsciiDoc files:
+[*.adoc]
+# Apply these styles:
+BasedOnStyles = RedHat,DeveloperHub

artifacts/attributes.adoc

@@ -27,8 +27,8 @@
 :osd-brand-name: Red Hat OpenShift Dedicated
 :osd-short: OpenShift Dedicated
 // minimum and current latest supported versions
-:ocp-version-min: 4.12
-:ocp-version: 4.15
+:ocp-version-min: 4.14
+:ocp-version: 4.17
 // First mention of OpenShift CLI or `oc` in a module
 :openshift-cli: pass:quotes[OpenShift CLI (`oc`)]
 :rhsso-brand-name: Red Hat Single-Sign On

artifacts/snip-customer-support-info.adoc

@@ -5,4 +5,4 @@
 If you experience difficulty with a procedure described in this documentation, visit the http://access.redhat.com[Red Hat Customer Portal]. You can use the Red Hat Customer Portal for the following purposes:
 
 * To search or browse through the Red Hat Knowledgebase of technical support articles about Red Hat products. 
-* To create a https://access.redhat.com/support/cases/#/case/new/get-support?caseCreate=true[support case] for Red Hat Global Support Services (GSS). For support case creation, select *Red Hat Developer Hub* as the product and select the appropriate product version.
+* To create a https://access.redhat.com/support/cases/#/case/new/get-support?caseCreate=true[support case] for {company-name} Global Support Services (GSS). For support case creation, select *{product}* as the product and select the appropriate product version. For detailed information about supported platforms, see link:{release-notes-url}#con-release-notes-overview.adoc[Supported Platforms] and the link:https://access.redhat.com/support/policy/updates/developerhub[{product} Life Cycle].

assemblies/assembly-add-custom-app-file-openshift.adoc

@@ -18,7 +18,7 @@ data:
 You can add the custom application configuration file to {ocp-short} in one of the following ways:
 
 * The {product} Operator
-* The {product} Helm chart.
+* The {product} Helm chart
 
 include::modules/getting-started/proc-add-custom-app-file-openshift-helm.adoc[leveloffset=+1]
 

assemblies/assembly-authenticating-with-github.adoc

@@ -1,5 +1,5 @@
-[id="assembly-auth-provider-github"]
-= Enabling the GitHub authentication provider
+[id="authenticating-with-github"]
+= Authenticating with GitHub
 
 To authenticate users with GitHub or GitHub Enterprise: