WIP

Author: sgtoj

docs/github-app-setup.md

@@ -28,7 +28,7 @@ This guide walks through creating and installing a GitHub App for github-ops-app
    > endpoint URL until after deployment. You'll configure and enable webhooks
    > in [Step 10](#step-10-configure-webhook).
 
-## Step 2: Configure Permissions
+### Configure Permissions
 
 Under **Permissions**, set the following:
 
@@ -39,30 +39,30 @@ Under **Permissions**, set the following:
 | Contents      | Read   | Read branch protection rules         |
 | Pull requests | Read   | Access PR details for compliance     |
 
-### Organization Permissions
+#### Organization Permissions
 
 | Permission     | Access     | Purpose                          |
 |----------------|------------|----------------------------------|
 | Members        | Read/Write | Manage team membership           |
 | Administration | Read       | Read organization settings       |
 
-## Step 3: Subscribe to Events
+## Step 2: Subscribe to Events
 
 Under **Subscribe to events**, check:
 
 - [x] **Pull request** - PR open, close, merge events
 - [x] **Team** - Team creation, deletion, changes
 - [x] **Membership** - Team membership changes
 
-## Step 4: Installation Settings
+## Step 3: Installation Settings
 
 | Setting                                 | Value                |
 |-----------------------------------------|----------------------|
 | Where can this GitHub App be installed? | Only on this account |
 
 Click **Create GitHub App**.
 
-## Step 5: Generate Private Key
+## Step 4: Generate Private Key
 
 After creating the app:
 
@@ -72,13 +72,13 @@ After creating the app:
 4. This file is used for `APP_GITHUB_APP_PRIVATE_KEY` or
    `APP_GITHUB_APP_PRIVATE_KEY_PATH`
 
-## Step 6: Note Your App ID
+## Step 5: Note Your App ID
 
 On the app's settings page, find and save:
 
 - **App ID** - numeric ID displayed near the top (e.g., `123456`)
 
-## Step 7: Install the App
+## Step 6: Install the App
 
 1. In the left sidebar, click **Install App**
 2. Select your organization
@@ -87,7 +87,7 @@ On the app's settings page, find and save:
    - **Only select repositories** - if limiting scope
 4. Click **Install**
 
-## Step 8: Get Installation ID
+## Step 7: Get Installation ID
 
 After installation, you'll be redirected to a URL like:
 ```
@@ -103,7 +103,7 @@ curl -H "Authorization: Bearer YOUR_JWT" \
   https://api.github.com/app/installations
 ```
 
-## Step 9: Configure Environment Variables
+## Step 8: Configure Environment Variables
 
 Set these environment variables in your deployment:
 
@@ -126,7 +126,7 @@ APP_GITHUB_APP_PRIVATE_KEY_PATH=/path/to/private-key.pem
 APP_GITHUB_APP_PRIVATE_KEY=arn:aws:ssm:us-east-1:123456789:parameter/github-bot/private-key
 ```
 
-## Step 10: Configure Webhook
+## Step 9: Configure Webhook
 
 After deploying your server, configure and enable webhooks: