updated permissions with semantically correct formatting

Signed-off-by: Fabrice Flore-Thébault <[email protected]>

Author: themr0c

modules/integrating-with-github/proc-enabling-github-repository-discovery.adoc

@@ -28,19 +28,51 @@ Enter your {product-short} URL: `pass:c,a,q[{my-product-url}]`.
 Webhook secret::
 Enter a strong secret.
 
-Repository permissions::
-* Enable `Read-only` access to:
-*** *Administration*
-*** *Commit statuses*
-*** *Contents*
-*** *Dependabot alerts*
-*** *Deployments*
-*** *Pull Requests*
-*** *Webhooks*
-+
-TIP: If you plan to make changes using the GitHub API, ensure that `Read and write` permissions are enabled instead of `Read-only`.
+App permissions::
+Select permissions to define the level of access for the app.
+Adapt permissions to your needs:
+
+Reading software components:::
+
+Contents::::
+`Read-only`
+
+Commit statuses::::
+`Read-only`
+
+Reading organization data:::
+
+Members::::
+`Read-only`
+
+Publishing software templates:::
+
+Administration::::
+`Read & write` (for creating repositories)
+
+Contents::::
+`Read & write`
+
+Metadata::::
+`Read-only`
+
+Pull requests::::
+`Read & write`
+
+Issues::::
+`Read & write`
+
+Workflows::::
+`Read & write` (if templates include GitHub workflows)
+
+Variables::::
+`Read & write` (if templates include GitHub Action Repository Variables)
+
+Secrets::::
+`Read & write` (if templates include GitHub Action Repository Secrets)
 
-* Enable other permissions as per your needs.
+Environments::::
+`Read & write` (if templates include GitHub Environments)
 
 Organization permissions::
 * Enable `Read-only` access to *Members*.