chore: Update GitHub instructions with App registration instructions (#3070)

* chore: Update GitHub instructions with App registration instructions

* fixup! chore: Update GitHub instructions with App registration instructions

Author: vinokurig

modules/administration-guide/pages/configuring-oauth-2-for-github.adoc

@@ -9,11 +9,13 @@
 
 To enable users to work with a remote Git repository that is hosted on GitHub:
 
-. Set up the GitHub OAuth App (OAuth 2.0).
-. Apply the GitHub OAuth App Secret.
+. Set up a link:https://docs.github.com/en/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps#about-github-apps[GitHub App] or a link:https://docs.github.com/en/apps/oauth-apps/using-oauth-apps[OAuth App].
+. Apply the GitHub App or OAuth App Secret.
 
 include::partial$proc_setting-up-the-github-oauth-app.adoc[leveloffset=+1]
 
+include::partial$proc_setting-up-the-github-app.adoc[leveloffset=+1]
+
 include::partial$proc_applying-the-github-oauth-app-secret.adoc[leveloffset=+1]
 
 To configure OAuth 2.0 for another GitHub provider,

modules/administration-guide/partials/proc_setting-up-the-github-app.adoc

@@ -0,0 +1,39 @@
+:_content-type: PROCEDURE
+:description: Setting up the GitHub App
+:keywords: github, github-app
+:navtitle: Setting up the GitHub App
+// :page-aliases:
+
+[id="setting-up-the-github-app"]
+= Setting up the GitHub App
+
+Set up a GitHub App to enable users to work with GitHub repositories.
+
+.Prerequisites
+
+* You are logged in to GitHub.
+
+.Procedure
+
+. Register a GitHub app, see: link:https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/registering-a-github-app#registering-a-github-app[Registering a GitHub App].
+. Enter the following values:
+.. *GitHub App name*: `<__application name__>`
+.. *Homepage URL*: `pass:c,a,q[{prod-url}]/`
+.. *Callback URL*: `pass:c,a,q[{prod-url}]/api/oauth/callback`
+.. Deselect the `Active` check-box in the `Webhook` section.
+.. Under *Permissions & events*, set the *Contents* repository permission to *Read and Write*.
+
+. Click *Create GitHub App*.
+
+. Click *Generate a new client secret*.
+
+. Copy and save the *GitHub App Client Secret* for use when applying the GitHub App Secret.
+
+. Copy and save the *GitHub App Client ID* for use when applying the GitHub App Secret.
+
+. Install the GitHub App, see: link:https://docs.github.com/en/apps/using-github-apps/installing-your-own-github-app#installing-your-own-github-app[Installing your own GitHub App]
+
+
+.Additional resources
+
+* link:https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/registering-a-github-app[GitHub Docs: Registering a GitHub App]