Merge branch 'main' into patch-2

content/rest/overview/other-authentication-methods.md

@@ -138,7 +138,7 @@ $ curl --request POST \
 {% endif %}
 
 [curl]: http://curl.haxx.se/
-[oauth-auth]: /rest#authentication
+[oauth-auth]: /rest/overview/resources-in-the-rest-api#authentication
 [personal-access-tokens]: /articles/creating-a-personal-access-token-for-the-command-line
 [saml-sso]: /articles/about-identity-and-access-management-with-saml-single-sign-on
 [saml-sso-tokens]: https://github.com/settings/tokens

content/rest/reference/actions.md

@@ -1,5 +1,6 @@
 ---
 title: Actions
+intro: 'With the Actions API, you can manage and control {% data variables.product.prodname_actions %} for an organization or repository.'
 redirect_from:
   - /v3/actions
 versions:

content/rest/reference/activity.md

@@ -1,5 +1,6 @@
 ---
 title: Activity
+intro: 'The Activity API allows you to list events and feeds and manage notifications, starring, and watching for the authenticated user.'
 redirect_from:
   - /v3/activity
 versions:

content/rest/reference/apps.md

@@ -1,5 +1,6 @@
 ---
 title: Apps
+intro: 'The GitHub Apps API enables you to retrieve the information about the installation as well as specific information about GitHub Apps.'
 redirect_from:
   - /v3/apps
 versions:
@@ -12,8 +13,6 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
-The GitHub Apps API enables you to get high-level information about a GitHub App as well as specific information about installations of the app. To learn more about GitHub Apps, see "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)."
-
 {% data reusables.apps.general-apps-restrictions %}
 
 This page lists endpoints that you can access while authenticated as a GitHub App. See "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)" to learn more.

content/rest/reference/billing.md

@@ -1,5 +1,6 @@
 ---
 title: Billing
+intro: 'With the Billing API, you can monitor the charges and usage {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %} for a user or organization.'
 versions:
   fpt: '*'
   ghec: '*'
@@ -8,8 +9,6 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
-You can monitor your {% data variables.product.prodname_actions %} and {% data variables.product.prodname_registry %} charges and usage for a user and organization through the Billing API.
-
 You can get billing information for an enterprise. For more information, see the "[{% data variables.product.prodname_dotcom %} Enterprise administration](/rest/reference/enterprise-admin#billing)" REST API.
 
 {% for operation in currentRestOperations %}

content/rest/reference/checks.md

@@ -1,5 +1,6 @@
 ---
 title: Checks
+intro: 'With the Checks API, you can build {% data variables.product.prodname_github_apps %} that run powerful checks against the code changes in a repository.'
 redirect_from:
   - /v3/checks
 versions:
@@ -11,8 +12,7 @@ topics:
   - API
 miniTocMaxHeadingLevel: 3
 ---
-
-The Checks API enables you to build GitHub Apps that run powerful checks against code changes in a repository. You can create apps that perform continuous integration, code linting, or code scanning services and provide detailed feedback on commits. For more information, see "[Getting started with the checks API](/rest/guides/getting-started-with-the-checks-api)" and "[Creating CI tests with the Checks API](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)."
+You can create apps that perform continuous integration, code linting, or code scanning services and provide detailed feedback on commits. For more information, see "[Getting started with the checks API](/rest/guides/getting-started-with-the-checks-api)" and "[Creating CI tests with the Checks API](/apps/quickstart-guides/creating-ci-tests-with-the-checks-api/)."
 
 {% for operation in currentRestOperations %}
   {% unless operation.subcategory %}{% include rest_operation %}{% endunless %}