Merge pull request github#16297 from github/repo-sync

repo sync

Author: rsese

.github/workflows/azure-preview-env-deploy.yml

@@ -165,7 +165,7 @@ jobs:
           rsync -rptovR ./user-code/content/./**/*.md ./content
           rsync -rptovR ./user-code/assets/./**/*.png ./assets
           rsync -rptovR ./user-code/data/./**/*.{yml,md} ./data
-          rsync -rptovR ./user-code/components/./**/*.{ts,tsx} ./components
+          rsync -rptovR ./user-code/components/./**/*.{scss,ts,tsx} ./components
           rsync -rptovR --ignore-missing-args ./user-code/lib/./**/*.{js,ts} ./lib
           rsync -rptovR --ignore-missing-args ./user-code/middleware/./**/*.{js,ts} ./middleware
           rsync -rptovR ./user-code/pages/./**/*.tsx ./pages

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 %}