First round of apps docs audit changes (#37320)

Co-authored-by: Jess Hosman <[email protected]>

Author: Sarah Edwards

assets/images/github-apps/authorize_app.png

@@ -8,7 +8,7 @@ versions:
   ghec: '*'
 topics:
   - GitHub Apps
-shortTitle: Authentication overview
+shortTitle: About authentication
 redirect_from:
   - /apps/building-integrations/setting-up-and-registering-github-apps/about-authentication-options-for-github-apps
   - /apps/building-github-apps/authentication-options-for-github-apps

assets/images/github-apps/install_app.png

@@ -13,12 +13,12 @@ topics:
   - GitHub Apps
 children:
   - /quickstart
-  - /setting-up-your-development-environment-to-create-a-github-app
   - /building-a-github-app-that-responds-to-webhook-events
   - /building-a-login-with-github-button-with-a-github-app
   - /building-a-cli-with-a-github-app
-  - /using-the-github-api-in-your-app
   - /making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow
+  - /setting-up-your-development-environment-to-create-a-github-app
+  - /using-the-github-api-in-your-app
   - /creating-ci-tests-with-the-checks-api
-  - /migrating-oauth-apps-to-github-apps
 ---
+

content/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app.md

@@ -53,6 +53,10 @@ When building an integration, you should consider using a {% data variables.prod
 
 In general, {% data variables.product.prodname_github_app %}s are preferred over {% data variables.product.prodname_oauth_app %}s.
 
+Both {% data variables.product.prodname_oauth_app %}s and {% data variables.product.prodname_github_app %}s use OAuth 2.0.
+
+{% data variables.product.prodname_oauth_app %}s can only act on behalf of a user while {% data variables.product.prodname_github_app %}s can either act on behalf of a user or independently of a user.
+
 For more information, see "[AUTOTITLE](/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)."
 
 For information on how to migrate an existing {% data variables.product.prodname_oauth_app %} to a {% data variables.product.prodname_github_app %}, see "[AUTOTITLE](/apps/creating-github-apps/guides/migrating-oauth-apps-to-github-apps)."

content/apps/creating-github-apps/guides/index.md

@@ -15,7 +15,7 @@ redirect_from:
 
 When you create a {% data variables.product.prodname_github_app %}, you can specify a callback URL. When you use the web application flow to generate a user access token in order to act on behalf of a user, users will be redirected to the callback URL after they authorize the app.
 
-You can specify up to 10 callback URLs. If you specify multiple callback URLs, you can use the `redirect_uri` parameter when you prompt the user to authorize your app, to indicate which callback URL the user should be redirected to. If you do not specify `redirect_uri`, the first callback URL will be used.
+You can specify up to 10 callback URLs. If you specify multiple callback URLs, you can use the `redirect_uri` parameter when you prompt the user to authorize your app, to indicate which callback URL the user should be redirected to. If you do not specify `redirect_uri`, the first callback URL will be used. For more information about using the `redirect_uri` parameter, see "[AUTOTITLE](/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app)".
 
 The callback URL is different from the setup URL. Users are redirected to the setup URL after they install an app. Users are redirected to the callback URL when they authorize an app via the web application flow. For more information, see "[AUTOTITLE](/apps/creating-github-apps/setting-up-a-github-app/about-the-setup-url)."
 

content/apps/creating-github-apps/setting-up-a-github-app/about-creating-github-apps.md

@@ -1,5 +1,6 @@
 ---
 title: Creating a GitHub App
+shortTitle: Create a {% data variables.product.prodname_github_app %}
 intro: 'You can create a {% data variables.product.prodname_github_app %} under your personal account or under any organization you own.'
 redirect_from:
   - /early-access/integrations/creating-an-integration

content/apps/creating-github-apps/setting-up-a-github-app/about-the-user-authorization-callback-url.md

@@ -13,17 +13,15 @@ topics:
   - GitHub Apps
 children:
   - /about-creating-github-apps
-  - /rate-limits-for-github-apps
+  - /migrating-oauth-apps-to-github-apps
+  - /best-practices-for-creating-a-github-app
   - /creating-a-github-app
+  - /about-the-user-authorization-callback-url
+  - /about-the-setup-url
   - /choosing-permissions-for-a-github-app
   - /using-webhooks-with-github-apps
   - /making-a-github-app-public-or-private
-  - /making-your-github-app-available-for-github-enterprise-server
-  - /creating-a-github-app-from-a-manifest
-  - /creating-a-github-app-using-url-parameters
+  - /rate-limits-for-github-apps
   - /creating-a-custom-badge-for-your-github-app
-  - /about-the-user-authorization-callback-url
-  - /about-the-setup-url
-  - /best-practices-for-creating-a-github-app
 ---
 

content/apps/creating-github-apps/setting-up-a-github-app/creating-a-github-app.md

@@ -17,7 +17,7 @@ versions:
   ghec: '*'
 topics:
   - GitHub Apps
-shortTitle: Manage app visibility
+shortTitle: Visibility
 ---
 
 ## About visibility for {% data variables.product.prodname_github_app %}s

content/apps/creating-github-apps/setting-up-a-github-app/index.md

@@ -5,14 +5,15 @@ redirect_from:
   - /apps/migrating-oauth-apps-to-github-apps
   - /developers/apps/migrating-oauth-apps-to-github-apps
   - /developers/apps/getting-started-with-apps/migrating-oauth-apps-to-github-apps
+  - /apps/creating-github-apps/guides/migrating-oauth-apps-to-github-apps
 versions:
   fpt: '*'
   ghes: '*'
   ghae: '*'
   ghec: '*'
 topics:
   - GitHub Apps
-shortTitle: Migrate from {% data variables.product.prodname_oauth_app %}s
+shortTitle: 'Migrate from {% data variables.product.prodname_oauth_app %}s'
 ---
 
 ## Benefits of migrating from {% data variables.product.prodname_oauth_app %}s to {% data variables.product.prodname_github_app %}s