Merge branch 'main' into repo-sync

Author: Octomerger

assets/images/azure/github-ae-azure-portal-search.png

@@ -48,6 +48,7 @@ export function RestOperation({ operation }: Props) {
       {previews && (
         <RestPreviewNotice slug={operation.slug} previews={operation['x-github'].previews} />
       )}
+      <RestResponse responses={operation.responses} variant="error" />
     </div>
   )
 }

components/rest/RestOperation.tsx

@@ -1,14 +1,44 @@
 import { CodeResponse } from './types'
 import { CodeBlock } from './CodeBlock'
+import { useTranslation } from 'components/hooks/useTranslation'
+import { RestResponseTable } from './RestResponseTable'
 
 type Props = {
   responses: Array<CodeResponse>
+  variant?: 'non-error' | 'error'
 }
 
-export function RestResponse({ responses }: Props) {
+export function RestResponse(props: Props) {
+  const { responses, variant = 'non-error' } = props
+  const { t } = useTranslation('products')
+
+  if (!responses || responses.length === 0) {
+    return null
+  }
+
+  const filteredResponses = responses.filter((response) => {
+    const responseCode = parseInt(response.httpStatusCode)
+
+    if (variant === 'error') {
+      return responseCode >= 400
+    } else {
+      return responseCode < 400
+    }
+  })
+
+  if (filteredResponses.length === 0) {
+    return null
+  }
+
+  if (variant === 'error') {
+    return (
+      <RestResponseTable heading={t('rest.reference.error_codes')} responses={filteredResponses} />
+    )
+  }
+
   return (
     <>
-      {responses.map((response: CodeResponse, index: number) => {
+      {filteredResponses.map((response, index) => {
         return (
           <div key={`${response.httpStatusMessage}-${index}}`}>
             <h4 dangerouslySetInnerHTML={{ __html: response.description }} />

components/rest/RestResponse.tsx

@@ -0,0 +1,48 @@
+.restResponseTable {
+  table-layout: fixed !important;
+
+  thead {
+    tr {
+      border-top: none;
+
+      th {
+        border: 0;
+        font-weight: normal;
+      }
+
+      th:first-child {
+        width: 25%;
+      }
+
+      th:nth-child(2) {
+        width: 75%;
+      }
+    }
+  }
+
+  tr:nth-child(2n) {
+    background: none !important;
+  }
+
+  td {
+    padding: 0.75rem 0.5rem !important;
+    border: 0 !important;
+    vertical-align: top;
+    width: 100%;
+  }
+
+  tbody {
+    tr td:first-child {
+      width: 30%;
+      font-weight: bold;
+    }
+
+    tr td:nth-child(2) {
+      width: 70%;
+    }
+
+    table tr td:not(:first-child) {
+      font-weight: normal;
+    }
+  }
+}

components/rest/RestResponseTable.module.scss

@@ -0,0 +1,45 @@
+import cx from 'classnames'
+import { CodeResponse } from './types'
+import { useTranslation } from 'components/hooks/useTranslation'
+import styles from './RestResponseTable.module.scss'
+
+type Props = {
+  heading: string
+  responses: Array<CodeResponse>
+}
+
+export function RestResponseTable({ heading, responses }: Props) {
+  const { t } = useTranslation('products')
+
+  return (
+    <>
+      <h4>{heading}</h4>
+      <table className={cx(styles.restResponseTable)}>
+        <thead>
+          <tr className="text-left">
+            <th>{t('rest.reference.http_status_code')}</th>
+            <th>{t('rest.reference.description')}</th>
+          </tr>
+        </thead>
+        <tbody>
+          {responses.map((response, index) => {
+            return (
+              <tr key={`${response.description}-${index}}`}>
+                <td>
+                  <code>{response.httpStatusCode}</code>
+                </td>
+                <td>
+                  {response.description ? (
+                    <div dangerouslySetInnerHTML={{ __html: response.description }} />
+                  ) : (
+                    response.httpStatusMessage
+                  )}
+                </td>
+              </tr>
+            )
+          })}
+        </tbody>
+      </table>
+    </>
+  )
+}

components/rest/RestResponseTable.tsx

@@ -24,8 +24,10 @@ export const ScrollButton = ({ className, ariaLabel }: ScrollButtonPropsT) => {
       },
       { threshold: [0] }
     )
-
     observer.observe(document.getElementsByTagName('h1')[0])
+    return () => {
+      observer.disconnect()
+    }
   }, [])
 
   const onClick = () => {

components/ui/ScrollButton/ScrollButton.tsx

@@ -23,7 +23,7 @@ At the start of each workflow run, {% data variables.product.prodname_dotcom %}
 
 When you enable {% data variables.product.prodname_actions %}, {% data variables.product.prodname_dotcom %} installs a {% data variables.product.prodname_github_app %} on your repository. The `GITHUB_TOKEN` secret is a {% data variables.product.prodname_github_app %} installation access token. You can use the installation access token to authenticate on behalf of the {% data variables.product.prodname_github_app %} installed on your repository. The token's permissions are limited to the repository that contains your workflow. For more information, see "[Permissions for the `GITHUB_TOKEN`](#permissions-for-the-github_token)."
 
-Before each job begins, {% data variables.product.prodname_dotcom %} fetches an installation access token for the job. The token expires when the job is finished.
+Before each job begins, {% data variables.product.prodname_dotcom %} fetches an installation access token for the job. {% data reusables.actions.github-token-expiration %}
 
 The token is also available in the `github.token` context. For more information, see "[Contexts](/actions/learn-github-actions/contexts#github-context)."
 

content/actions/security-guides/automatic-token-authentication.md

@@ -234,3 +234,11 @@ For example, if a pull request contains a `feature` branch (the current scope) a
 ## Usage limits and eviction policy
 
 {% data variables.product.prodname_dotcom %} will remove any cache entries that have not been accessed in over 7 days. There is no limit on the number of caches you can store, but the total size of all caches in a repository is limited to 10 GB. If you exceed this limit, {% data variables.product.prodname_dotcom %} will save your cache but will begin evicting caches until the total size is less than 10 GB.
+
+{% if actions-cache-management %}
+
+## Managing caches
+
+You can use the {% data variables.product.product_name %} REST API to manage your caches. At present, you can use the API to see your cache usage, with more functionality expected in future updates. For more information, see the "[Actions](/rest/reference/actions#cache)" REST API documentation.
+
+{% endif %}

content/actions/using-workflows/caching-dependencies-to-speed-up-workflows.md

@@ -714,6 +714,12 @@ The maximum number of minutes to let a job run before {% data variables.product.
 
 If the timeout exceeds the job execution time limit for the runner, the job will be canceled when the execution time limit is met instead. For more information about job execution time limits, see {% ifversion fpt or ghec or ghes %}"[Usage limits and billing](/actions/reference/usage-limits-billing-and-administration#usage-limits)" for {% data variables.product.prodname_dotcom %}-hosted runners and {% endif %}"[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits){% ifversion fpt or ghec or ghes %}" for self-hosted runner usage limits.{% elsif ghae %}."{% endif %}
 
+{% note %}
+
+**Note:** {% data reusables.actions.github-token-expiration %} For self-hosted runners, the token may be the limiting factor if the job timeout is greater than 24 hours. For more information on the `GITHUB_TOKEN`, see "[About the `GITHUB_TOKEN` secret](/actions/security-guides/automatic-token-authentication#about-the-github_token-secret)."
+
+{% endnote %}
+
 ## `jobs.<job_id>.strategy`
 
 {% data reusables.actions.jobs.section-using-a-build-matrix-for-your-jobs-strategy %}

content/actions/using-workflows/workflow-syntax-for-github-actions.md

@@ -22,6 +22,8 @@ shortTitle: About configuration
 {% endif %}
 
 {% ifversion ghae %}
+To get started with {% data variables.product.product_name %}, you first need to deploy {% data variables.product.product_name %}. For more information, see "[Deploying {% data variables.product.product_name %}](/admin/configuration/configuring-your-enterprise/deploying-github-ae)."
+
 The first time you access your enterprise, you will complete an initial configuration to get {% data variables.product.product_name %} ready to use. The initial configuration includes connecting your enterprise with an identity provider (IdP), authenticating with SAML SSO, configuring policies for repositories and organizations in your enterprise, and configuring SMTP for outbound email. For more information, see "[Initializing {% data variables.product.prodname_ghe_managed %}](/admin/configuration/initializing-github-ae)."
 
 Later, you can use the site admin dashboard and enterprise settings to further configure your enterprise, manage users, organizations and repositories, and set policies that reduce risk and increase quality.