chore: cherrypick changes in main to the release-1.3 branch (#524)

Signed-off-by: Nick Boldt <nboldt@redhat.com>

Author: nickboldt

.github/pull_request_template.md

@@ -2,6 +2,8 @@
 
 <!--- If your changes apply to the latest released and/or in-development version of RHDH, open your PR against the `main` branch and cherrypick your PR to any released branches that you want to apply your changes to. --->
 
+**IMPORTANT: Do Not Merge - To be merged by Docs Team Only**
+
 **Version(s):**
 <!--- Specify the version(s) of RHDH that your PR applies to. -->
 
@@ -15,6 +17,7 @@
 - [ ] SME: @ mention assignee
 - [ ] QE: @ mention assignee
 - [ ] Docs review: @ mention assignee
+- [ ] Additional review: @mention assignee (by writer)
 <!--- SME approval is required to merge a PR unless the changes are made by a subject matter expert. --->
 <!--- QE approval is required to merge a PR unless there are no technical changes to the content. --->
 <!--- Docs team approval is required for ALL PRs. --->

.github/workflows/build-asciidoc.yml

@@ -21,6 +21,7 @@ on:
     - main
     - rhdh-1.**
     - 1.**.x
+    - release-1.**
 
 jobs:
   adoc_build:

.github/workflows/pr.yml

@@ -27,6 +27,7 @@ on:
     - main
     - rhdh-1.**
     - 1.**.x
+    - release-1.**
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.number || github.event.pull_request.head.ref }}
@@ -90,14 +91,19 @@ jobs:
           keep_files: true
           publish_dir: ./titles-generated
 
-      - name: PR comment with doc preview
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ secrets.RHDH_BOT_TOKEN }}
-          script: |
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: 'PR Preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-${{ github.event.number }}/' 
-            });
+      - name: PR comment with doc preview, replacing existing comments with a new one each time
+        shell: bash
+        env:
+          GH_TOKEN: ${{ secrets.RHDH_BOT_TOKEN }}
+        run: |
+          PR_NUM="${{ github.event.number }}"
+          ORG_REPO="${{ github.repository_owner }}/${{ github.event.repository.name }}"
+          gh repo set-default "${ORG_REPO}"
+          # for a given PR, check for existing comments from rhdh-bot; select the last one (if more than one)
+          if [[ $(gh api "repos/${ORG_REPO}/issues/${PR_NUM}/comments" -q 'map(select(.user.login=="rhdh-bot"))|last|.id') ]]; then 
+            # edit that comment:
+            gh pr comment ${PR_NUM} -R "${ORG_REPO}" --edit-last --body "Updated preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-${PR_NUM}/ @ $(date "+%x %X")"
+          else
+            # or create a new one:
+            gh pr comment ${PR_NUM} -R "${ORG_REPO}" --body "Preview: https://redhat-developer.github.io/red-hat-developers-documentation-rhdh/pr-${PR_NUM}/"
+          fi

modules/dynamic-plugins/rhdh-supported-plugins.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-# script to generate rhdh-supported-plugins.adoc from content in 
+# script to generate rhdh-supported-plugins.adoc from content in
 # https://github.com/janus-idp/backstage-plugins/tree/main/plugins/ */package.json
 # https://github.com/janus-idp/backstage-showcase/tree/main/dynamic-plugins/wrappers/ */json