Doc changes. Try without custom token.

Author: desrosj

.github/workflows/check-built-files.yml

@@ -1,11 +1,11 @@
-# Checks for uncommitted changes to built files and pushes changes back.
-name: Check built files
+# Checks for uncommitted changes to built files in pull requests.
+name: Check Built Files (PRs)
 
 on:
   # Because all commits happen through SVN and should always be manually reviewed by a committer, this workflow only
   # runs for pull requests.
   #
-  # Other workflows that run on push will detect changes to versioned files and fail.
+  # Other workflows that run for the push event will detect changes to versioned files and fail.
   pull_request:
     branches:
       - trunk
@@ -39,8 +39,8 @@ concurrency:
 permissions: {}
 
 jobs:
-  update-built-files:
-    name: Update built files
+  check-for-built-file-changes:
+    name: Check built files
     if: ${{ github.repository == 'desrosj/wordpress-develop' }}
     uses: ./.github/workflows/reusable-check-built-files.yml
 

.github/workflows/commit-built-file-changes.yml

@@ -1,4 +1,4 @@
-# Commits missed changes to built files back to pull request branches.
+# Commits all missed changes to built files back to pull request branches.
 name: Commit Built File Changes (PRs)
 
 on:
@@ -24,19 +24,13 @@ jobs:
   # read-only access.
   #
   # Performs the following steps:
+  # - Attempts to download the artifact containing the PR diff.
+  # - Checks for the existence of an artifact.
+  # - Unzips the artifact.
   # - Generates a token for authenticating with the GitHub App.
   # - Checks out the repository.
-  # - Sets up Node.js.
-  # - Configures caching for Composer.
-  # - Installs Composer dependencies.
-  # - Logs general debug information about the runner.
-  # - Installs npm dependencies.
-  # - Builds CSS file using SASS.
-  # - Builds Emoji files.
-  # - Builds bundled Root Certificate files.
-  # - Builds WordPress.
-  # - Checks for changes to versioned files.
-  # - Displays the result of git diff for debugging purposes.
+  # - Applies the patch file.
+  # - Displays the result of git diff.
   # - Configures the Git author.
   # - Stages changes.
   # - Commits changes.
@@ -131,9 +125,6 @@ jobs:
 
           rm -f private-key.pem
 
-      - name: list directory
-        run: ls -la
-
       - name: Checkout repository
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
         if: ${{ steps.artifact-check.outputs.exists == 'true' }}
@@ -142,10 +133,6 @@ jobs:
           ref: ${{ github.event.workflow_run.head_branch }}
           path: 'pr-repo'
           show-progress: ${{ runner.debug == '1' && 'true' || 'false' }}
-          token: ${{ env.ACCESS_TOKEN }}
-
-      - name: list directory
-        run: ls -la
 
       - name: Apply patch
         if: ${{ steps.artifact-check.outputs.exists == 'true' }}

.github/workflows/reusable-check-built-files.yml

@@ -1,4 +1,8 @@
-name: Lint GitHub Actions workflows
+##
+# A reusable workflow that checks for uncommitted changes to built files in pull requests.
+##
+name: Check Built Files (PRs)
+
 on:
   workflow_call:
 
@@ -7,8 +11,8 @@ permissions: {}
 jobs:
   # Checks a PR for uncommitted changes to built files.
   #
-  # When changes are detected, the patch and PR number are stored as an artifact for the Commit Built File Changes
-  # workflow to commit and push the changes back for testing.
+  # When changes are detected, the patch is stored as an artifact. The Commit Built File Changes workflow runs on
+  # workflow_run, commits, and push the changes back to the pull request for testing purposes.
   #
   # Performs the following steps:
   # - Checks out the repository.
@@ -100,9 +104,8 @@ jobs:
         if: ${{ steps.built-file-check.outputs.uncommitted_changes == 'true' }}
         run: git diff > ./changes.diff
 
-      # Uploads the PR number and diff as an artifact for the Commit Built File Changes workflow to download and then
-      # commit back for testing.
-      - name: Upload PR data as artifact
+      # Uploads the diff file as an artifact.
+      - name: Upload diff file as artifact
         uses: actions/upload-artifact@65c4c4a1ddee5b72f698fdd19549f0f0fb45cf08 # v4.6.0
         if: ${{ steps.built-file-check.outputs.uncommitted_changes == 'true' }}
         with: