From: colin-mueller-sonarsource <44168128+colin-mueller-sonarsource@users.noreply.github.com>
Date: Wed, 26 Jun 2019 20:50:30 +0000 (-0700)
Subject: Document Additional Permissions for GitHub Checks
X-Git-Tag: 8.0~451
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=e129e2b2aad841786f8638a75c7a4bffc23fdb38;p=sonarqube.git

Document Additional Permissions for GitHub Checks
---

diff --git a/server/sonar-docs/src/pages/instance-administration/github-application.md b/server/sonar-docs/src/pages/instance-administration/github-application.md
index 5d144bdab79..57fe93fda37 100644
--- a/server/sonar-docs/src/pages/instance-administration/github-application.md
+++ b/server/sonar-docs/src/pages/instance-administration/github-application.md
@@ -16,7 +16,15 @@ From the "Register new GitHub App" page, follow these steps to create your GitHu
 
 1. Under **GitHub App name**, give your app a name (such as SonarQubePRChecks).
 2. GitHub requires a **Homepage URL** and a **Webhook URL**. These values aren't important for Pull Request decoration, so you can use any URL (such as https://www.sonarqube.org/).
-3. Under "Permissions" set **Checks** to **Read & write**.
+3. Grant access for the following **Permissions**
+
+	| Permission          | Access       |
+	|---------------------|--------------|
+	| Checks              | Read & write |
+	| Repository metadata | Read-only    |
+	| Pull Requests       | Read-only    |
+	| Commit statuses     | Read-only    |
+
 4. Under "Where can this GitHub App be installed?," select **Any account**.
 5. Click **Create GitHub App**.