WIP

Author: sgtoj

docs/github-app-setup.md

@@ -16,41 +16,32 @@ 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 > Webhook URL | Leave blank for now                             |
-   | Webhook > Secret      | Generate a strong secret (save this for later)  |
-   | Webhook > Active      | **Uncheck** to disable webhooks initially       |
-
-   > **Note**: Disable webhooks during creation since you may not know your
-   > endpoint URL until after deployment. You'll configure webhooks and
-   > subscribe to events in [Step 7](#step-7-configure-webhook-and-events).
-
-### Configure Permissions
-
-Under **Permissions**, set the following:
-
-### Repository Permissions
-
-| Permission    | Access | Purpose                              |
-|---------------|--------|--------------------------------------|
-| Contents      | Read   | Read branch protection rules         |
-| Pull requests | Read   | Access PR details for compliance     |
-
-#### Organization Permissions
-
-| Permission     | Access     | Purpose                          |
-|----------------|------------|----------------------------------|
-| Members        | Read/Write | Manage team membership           |
-| Administration | Read       | Read organization settings       |
-
-4. Set installation scope:
-
-   | Setting                                 | Value                |
-   |-----------------------------------------|----------------------|
-   | Where can this GitHub App be installed? | Only on this account |
+    | 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       |
+
+    > **Note**: Disable webhooks during creation since you may not know your
+    > endpoint URL until after deployment. You'll configure webhooks and
+    > subscribe to events in [Step 7](#step-7-configure-webhook-and-events).
+
+4. Under **Permissions**, set the following:
+   - Repository Permissions
+     - Contents: Read
+       - Read branch protection rules
+     - Pull requests: Read
+       - Access PR details for compliance
+   - Organization Permissions
+     - Administration: Read
+       - Read organization settings
+     - Members: Read/Write
+       - Manage team membership
+
+4. Under Set installation scope:
+   - Where can this GitHub App be installed?: Only on this account
 
 5. Click **Create GitHub App**