wip

Author: sgtoj

docs/github-app-setup.md

@@ -5,7 +5,6 @@ This guide walks through creating and installing a GitHub App for github-ops-app
 ## Prerequisites
 
 - GitHub organization with admin access
-- Webhook endpoint URL (your deployed server or Lambda API Gateway URL)
 
 ## Step 1: Create the GitHub App
 
@@ -17,17 +16,17 @@ This guide walks through creating and installing a GitHub App for github-ops-app
 
 3. Fill in the basic information:
 
-   | Field              | Value                                                     |
-   |--------------------|-----------------------------------------------------------|
-   | GitHub App name    | `github-ops-app` (must be unique across GitHub)           |
-   | Homepage URL       | Your organization's URL or repo URL                       |
-   | Webhook URL        | Your endpoint (e.g., `https://api.example.com/webhooks`)  |
-   | Webhook secret     | Generate a strong secret (save this for later)            |
+   | Field                 | Value                                           |
+   |-----------------------|-------------------------------------------------|
+   | GitHub App name       | `github-ops-app` (must be unique across GitHub) |
+   | Homepage URL          | Your organization's URL or repo URL             |
+   | Webhook > Webhook URL | Leave blank for now                             |
+   | Webhook > Secret      | Generate a strong secret (save this for later)  |
+   | Webhook > Active      | **Uncheck** to disable webhooks initially       |
 
-   Generate a webhook secret:
-   ```bash
-   openssl rand -hex 32
-   ```
+   > **Note**: Disable webhooks during creation since you may not know your
+   > endpoint URL until after deployment. You'll configure and enable webhooks
+   > in [Step 10](#step-10-configure-webhook).
 
 ## Step 2: Configure Permissions
 
@@ -127,6 +126,18 @@ 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
+
+After deploying your server, configure and enable webhooks:
+
+1. Go to your GitHub App settings:
+   `https://github.com/organizations/YOUR_ORG/settings/apps/YOUR_APP`
+2. Set **Webhook URL** to your endpoint:
+   - Lambda: `https://xxx.execute-api.region.amazonaws.com/webhooks`
+   - Server: `https://your-domain.com/webhooks`
+3. Check **Active** to enable webhooks
+4. Click **Save changes**
+
 ## Using the App Manifest (Alternative)
 
 For automated setup, use the manifest at `assets/github/manifest.json`: