moves the action of commenting on the PR out of comment-on-pr into pr-url-and-dependent. updates contribute.md irt checks. removes common-on-pr workflow, no longer needed.

Author: gilzow

.github/workflows/comment-on-pr.yaml

@@ -170,7 +170,7 @@ jobs:
           state: '${{ steps.set-status-message.outputs.status_state }}'
 
   report_changed_files:
-    name: Collect a list of changed files
+    name: Collects a list of changed files, reports their URL as a comment
     needs:
       - get_info_on_pr
       - get_pr_url
@@ -187,11 +187,10 @@ jobs:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      - name: Make artifact files
+      - name: Make pr_comment.txt file
         run: |
-          # these are used in comment-on-pr
-          touch pr_number.txt pr_comment.txt
-          echo "${{ env.PRNUM }}" > pr_number.txt
+          # we need this for the later action
+          touch pr_comment.txt
       - name: Get changed files
         id: changed-files
         uses: tj-actions/changed-files@v41
@@ -274,13 +273,11 @@ jobs:
         run: |
           echo -e "Your Platform.sh environment has successfully deployed. :rocket:\n\nSee the site:\n\n- [Platform.sh docs]($ENV_URL)\n- [Upsun docs]($UPSUN_ENV_URL)" > pr_comment.txt
 
-      - uses: actions/upload-artifact@v4
+      - name: Post PR comment
+        uses: marocchino/sticky-pull-request-comment@v2
         with:
-          name: pr-comment-info
-          path: |
-            pr_comment.txt
-            pr_number.txt
-          retention-days: 1
+          number: ${{ env.PRNUM }}
+          path: pr_comment.txt
 
   run-redirection-tests:
     name: Verify contracted redirections

.github/workflows/pr-url-and-dependent.yaml

@@ -175,8 +175,10 @@ To ensure the docs work smoothly, a few checks run on each pull request:
   ./bin/htmltest
   ```
 
-- Custom workflows [check all changed files](./.github/workflows/pr-url-and-dependent.yaml) within `docs/src`
-  and [comment with links](./.github/workflows/comment-on-pr.yaml) to the deployed pages for review.
+- Custom workflows check all changed files within `docs/src`
+  and comment with links to the deployed pages for review.
+- Checks redirection links that start with `/anchor`
+- Runs a series of end-to-end tests to ensure search is working properly
 
 Outside of pull requests, twice a week [Muffet](https://github.com/raviqqe/muffet)
 checks if all links on the site are valid.