Add more comments

Author: AndyTitu

.github/workflows/ok-to-test.yml

@@ -8,6 +8,7 @@ on:
 jobs:
   ok-to-test:
     runs-on: ubuntu-latest
+    # required permissions for adding reactions to the pull request comments
     permissions:
       pull-requests: write
     # Only run for PRs, not issue comments
@@ -20,4 +21,5 @@ jobs:
         reaction-token: ${{ secrets.GITHUB_TOKEN }}
         issue-type: pull-request
         commands: ok-to-test
+        # The repository permission level required by the user to dispatch commands. Only allows 1Password collaborators to run this.
         permission: write

.github/workflows/validate.yml

@@ -53,9 +53,9 @@ jobs:
   # It will checkout the forked (and now trusted) code and it will run the integration tests on it.
   # If the tests are successful this action will proceed to update the status of the forked PR integration check.
   integration-test-fork:
-    # must have these permissions to
+    # required permissions for updating the status of the pull request checks
     permissions:
-      pull-requests: write
+      pull-request: write
       checks: write
     strategy:
       matrix: