docs: move permissions into usage examples

Include required permissions directly in the example workflow code
for better visibility and easier copy-paste experience.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: vaind

danger/README.md

@@ -11,6 +11,11 @@ on:
   pull_request:
     types: [opened, synchronize, reopened, edited, ready_for_review, labeled, unlabeled]
 
+permissions:
+  contents: read       # To read repository files
+  pull-requests: write # To post comments on pull requests
+  statuses: write      # To post commit status checks
+
 jobs:
   danger:
     runs-on: ubuntu-latest
@@ -25,17 +30,6 @@ jobs:
   * required: false
   * default: `${{ github.token }}`
 
-## Required Permissions
-
-For workflows using this action, you need to set the following permissions:
-
-```yaml
-permissions:
-  contents: read       # To read repository files
-  pull-requests: write # To post comments on pull requests
-  statuses: write      # To post commit status checks
-```
-
 ## Outputs
 
 * `outcome`: Whether the Danger run finished successfully. Possible values are `success`, `failure`, `cancelled`, or `skipped`.

updater/README.md

@@ -15,6 +15,11 @@ on:
     branches:
       - main
 
+permissions:
+  contents: write      # To modify files and create commits
+  pull-requests: write # To create and update pull requests
+  actions: write       # To cancel previous workflow runs
+
 jobs:
   # Update a git submodule
   cocoa:
@@ -104,17 +109,6 @@ jobs:
   * type: string
   * required: true
 
-## Required Permissions
-
-For workflows using this action, you need to set the following permissions:
-
-```yaml
-permissions:
-  contents: write      # To modify files and create commits
-  pull-requests: write # To create and update pull requests
-  actions: write       # To cancel previous workflow runs
-```
-
 ## Outputs
 
 * `prUrl`: The created/updated PR's URL.