Merge branch 'main' into fix/pull-request-template-translated-content-link

2026-01-06 06:02:35 -05:00 · 2021-10-08 15:42:14 -05:00
parent 72a5580038 eef9e5a4fc
commit 1f91339aed
78 changed files with 281 additions and 160 deletions
--- a/.github/workflows/automerge-dependencies.yml
+++ b/.github/workflows/automerge-dependencies.yml
@@ -52,10 +52,35 @@ jobs:
      }}
    runs-on: ubuntu-latest
    steps:
-      - name: Close and comment on the pull request
+      - name: Close pull request
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          PR_URL: ${{ github.event.pull_request.html_url }}
        run: |
          gh pr close "$PR_URL"
+
+      - name: Comment on the pull request
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PR_URL: ${{ github.event.pull_request.html_url }}
+        run: |
          gh pr comment "$PR_URL" --body "This dependency update will be handled internally by our engineering team."
+
+      # Because we get far too much spam ;_;
+      - name: Lock conversations
+        uses: actions/github-script@2b34a689ec86a68d8ab9478298f91d5401337b7d
+        env:
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+        with:
+          script: |
+            try {
+              await github.issues.lock({
+                ...context.repo,
+                issue_number: parseInt(process.env.PR_NUMBER, 10),
+                lock_reason: 'resolved'
+              })
+              console.log('Locked the pull request to prevent spam!')
+            } catch (error) {
+              console.error(`Failed to lock the pull request. Error: ${error}`)
+              throw error
+            }
--- a/.github/workflows/triage-unallowed-contributions.yml
+++ b/.github/workflows/triage-unallowed-contributions.yml
@@ -26,7 +26,12 @@ on:

 jobs:
  triage:
-    if: github.repository == 'github/docs' && github.event.pull_request.user.login != 'Octomerger'
+    if: >-
+      ${{
+        github.repository == 'github/docs' &&
+        github.event.pull_request.user.login != 'Octomerger' &&
+        github.event.pull_request.user.login != 'dependabot[bot]'
+      }}
    runs-on: ubuntu-latest
    steps:
      - name: Get files changed
@@ -70,7 +75,7 @@ jobs:
        if: ${{ steps.filter.outputs.notAllowed }}
        uses: actions/github-script@2b34a689ec86a68d8ab9478298f91d5401337b7d
        with:
-          github-token: ${{secrets.GITHUB_TOKEN}}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
          script: |
            const badFilesArr = [
              '.github/actions-scripts/**',
--- a/content/actions/creating-actions/developing-a-third-party-cli-action.md
+++ b/content/actions/creating-actions/developing-a-third-party-cli-action.md
@@ -0,0 +1,72 @@
+---
+title: Developing a third party CLI action
+shortTitle: CLI setup action
+intro: 'Learn how to develop an action to set up a CLI on {% data variables.product.prodname_actions %} runners.'
+product: '{% data reusables.gated-features.actions %}'
+redirect_from: []
+versions:
+  fpt: '*'
+type: tutorial
+topics:
+  - Actions
+---
+
+## Introduction
+
+You can write an action to provide a way for users to access your servers via a configured CLI environment on {% data variables.product.prodname_actions %} runners.
+
+Your action should:
+
+- Make it simple for users to specify the version of the CLI to install
+- Support multiple operating systems
+- Run in an efficient fashion to minimize run-time and associated costs
+- Work across {% data variables.product.product_name %}-hosted and self-hosted runners
+- Leverage community tooling when possible
+
+This article will demonstrate how to write an action that retrieves a specific version of your CLI, installs it, adds it to the path, and (optionally) caches it. This type of action (an action that sets up a tool) is often named `setup-$TOOL`. 
+
+## Prerequisites
+
+You should have an understanding of how to write a custom action. For more information, see "[About custom actions](/actions/creating-actions/about-custom-actions)". For a more detailed guide on how to write a custom action, see "[Creating a JavaScript action](/actions/creating-actions/creating-a-javascript-action)."
+
+## Example
+
+The following script demonstrates how you can get a user-specified version as input, download and extract the specific version of your CLI, then add the CLI to the path.
+
+{% data variables.product.prodname_dotcom %} provides [`actions/toolkit`](https://github.com/actions/toolkit), which is a set of packages that helps you create actions. This example uses the [`actions/core`](https://github.com/actions/toolkit/tree/main/packages/core) and [`actions/tool-cache`](https://github.com/actions/toolkit/tree/main/packages/tool-cache) packages.
+
+{% raw %}
+```javascript{:copy}
+const core = require('@actions/core');
+const tc = require('@actions/tool-cache');
+
+async function setup() {
+  // Get version of tool to be installed
+  const version = core.getInput('version');
+
+  // Download the specific version of the tool, e.g. as a tarball
+  const pathToTarball = await tc.downloadTool(getDownloadURL());
+
+  // Extract the tarball onto the runner
+  const pathToCLI = await tc.extractTar(pathToTarball);
+
+  // Expose the tool by adding it to the PATH
+  core.addPath(pathToCLI)
+}
+
+module.exports = setup
+```
+{% endraw %}
+
+To use this script, replace `getDownloadURL` with a function that downloads your CLI. You will also need to create an actions metadata file (`action.yml`) that accepts a `version` input and that runs this script. For full details about how to create an action, see "[Creating a JavaScript action](/actions/creating-actions/creating-a-javascript-action)."
+
+For a full example of how to set up this action, see [example-setup-gh](https://github.com/github-developer/example-setup-gh).
+
+## Further reading
+
+This pattern is employed in several actions. For more examples, see:
+
+* [`ruby/setup-ruby`](https://github.com/ruby/setup-ruby)
+* [`google-github-actions/setup-gcloud`](https://github.com/google-github-actions/setup-gcloud)
+* [`hashicorp/setup-terraform`](https://github.com/hashicorp/setup-terraform)
+
--- a/content/actions/creating-actions/index.md
+++ b/content/actions/creating-actions/index.md
@@ -20,6 +20,7 @@ children:
  - /dockerfile-support-for-github-actions
  - /setting-exit-codes-for-actions
  - /publishing-actions-in-github-marketplace
+  - /developing-a-third-party-cli-action
 ---
 {% data reusables.actions.enterprise-beta %}
 {% data reusables.actions.enterprise-github-hosted-runners %}
--- a/content/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners.md
+++ b/content/actions/hosting-your-own-runners/autoscaling-with-self-hosted-runners.md
@@ -54,3 +54,21 @@ Your access token will require the following scope:
 To  authenticate using a {% data variables.product.prodname_dotcom %} App, it must be assigned the following permissions:
 - For repositories, assign the `administration` permission.
 - for organizations, assign the `organization_self_hosted_runners` permission.
+
+## Recommended autoscaling solutions
+
+{% data variables.product.prodname_dotcom %} recommends and partners closely with two open source projects that you can use for autoscaling your runners. One or both solutions may be suitable, based on your needs. 
+
+The following repositories have detailed instructions for setting up these autoscalers: 
+
+- [actions-runner-controller/actions-runner-controller](https://github.com/actions-runner-controller/actions-runner-controller) - A Kubernetes controller for {% data variables.product.prodname_actions %} self-hosted runnners.
+- [philips-labs/terraform-aws-github-runner](https://github.com/philips-labs/terraform-aws-github-runner) - A Terraform module for scalable {% data variables.product.prodname_actions %} runners on Amazon Web Services.
+
+Each solution has certain specifics that may be important to consider:
+
+| **Features** | **actions-runner-controller** | **terraform-aws-github-runner** |
+| :--- | :--- | :--- |
+| Runtime | Kubernetes | Linux and Windows VMs |
+| Supported Clouds | Azure, Amazon Web Services, Google Cloud Platform, on-premises | Amazon Web Services |
+| Where runners can be scaled | Enterprise, organization, and repository levels. By runner label and runner group. | Organization and repository levels. By runner label and runner group. |
+| Pull-based autoscaling support | Yes | No |
--- a/lib/search/indexes/github-docs-2.22-cn-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:82fe6d7ea9bbc475a969da9e2a57c9939770ebe20a01e99f92c4c142683ad3cc
-size 525510
+oid sha256:4786eac6d91a286e44907bc2d77730aadfed4107e45be39eefbbd18dc9063867
+size 525249
--- a/lib/search/indexes/github-docs-2.22-cn.json.br
+++ b/lib/search/indexes/github-docs-2.22-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0deeae208b6bf81314d1e9e24d0e9e878b9bede72ab7998bc87a8b52b7cc3c0e
-size 868679
+oid sha256:5e78cba601b62dd9925d706d77de43b84f85ea548ec6c9a5862cced2dbf8d86e
+size 868608
--- a/lib/search/indexes/github-docs-2.22-de-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0475853337d7c332cc90e2098a7e8ef00d44fea4a8f38d62e7ae9896f45ff66e
-size 479338
+oid sha256:c21f8de4e35f987bf316b15712222743a94a5671d88f32857d918c0bb8a8c0ea
+size 479315
--- a/lib/search/indexes/github-docs-2.22-de.json.br
+++ b/lib/search/indexes/github-docs-2.22-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:efc8a4b430931acf5b9311ff780e008c0956e3784b92696f9ea04a1748f63f2f
-size 2127098
+oid sha256:74f97029e12af7a55a04ba2f7c72827cced9f2c8a2643d4b83e89edd1a7f6789
+size 2126348
--- a/lib/search/indexes/github-docs-2.22-en-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a30274e34c73ece9fa6aecae2c8d634f569f51b33e5718b6779831543e037d75
-size 433837
+oid sha256:4695d77158ba8b8879d86d60209b89fa09d5ec3b61dbd2a0c1e27351faf6a265
+size 433907
--- a/lib/search/indexes/github-docs-2.22-en.json.br
+++ b/lib/search/indexes/github-docs-2.22-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f2532d8f3d6cb00f0965eb7f9c8733e15e2b7f7e1e47677483f24ce7b00aa9c2
-size 1695347
+oid sha256:065beb0dab03b00adfca5d3b1c0e14983884036ee00a423da66726e79cd53315
+size 1695238
--- a/lib/search/indexes/github-docs-2.22-es-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3b5b7ce8840c71b3b2f6b0558b684bfac4125170aba0b02ba00f3605fe734f5a
-size 195109
+oid sha256:0a7e4aad5d5315eba97767d2876fb4396612ceac3800368e20d483c302377487
+size 195215
--- a/lib/search/indexes/github-docs-2.22-es.json.br
+++ b/lib/search/indexes/github-docs-2.22-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4f1f7993639ffbce85a9fa172b9a372dd543b3d8ff236e26597578cd2d58bf38
-size 702614
+oid sha256:ae1b7f168c8cb82cfb0b996d49753e6dd36e3e4e2b74377c7366ae18aa4b9b1c
+size 702352
--- a/lib/search/indexes/github-docs-2.22-ja-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:87d0dc73a44bd204427a6e3bc93b18a4a2061bb7d3fd2519074f238918f40bb5
-size 545288
+oid sha256:9af02343813ca642cea70c38fb51b5b2ce66ee90f2c3695d80278013d69d04c1
+size 545302
--- a/lib/search/indexes/github-docs-2.22-ja.json.br
+++ b/lib/search/indexes/github-docs-2.22-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a40f0eaa1434cdc44ba3163272a41ba57b4fdade41ab2ac9c84bce6395cbe00a
-size 2882124
+oid sha256:8132659e84dd00449f4195c908a939f886c1da71b48cfb46afbec8dbde49b022
+size 2880437
--- a/lib/search/indexes/github-docs-2.22-pt-records.json.br
+++ b/lib/search/indexes/github-docs-2.22-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8ec3002dfe91a41cdd56d2665c4f6e9a29b10abf6ef14179604fb60db72e5035
-size 456903
+oid sha256:544350152b0948f19243e8eb5865c15a5b208bbd68e67f78023cc7e5c77f007c
+size 456740
--- a/lib/search/indexes/github-docs-2.22-pt.json.br
+++ b/lib/search/indexes/github-docs-2.22-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1887b15fee7c990218edea92be97550a8d5e3476bf9604a9203e59569591053f
-size 1905808
+oid sha256:074b6dfc8a1ad7332151c25be849ab4e825c9474220b71764007f122326bf5ef
+size 1905240
--- a/lib/search/indexes/github-docs-3.0-cn-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:efa39ba9271c0c542d2b7188b1f1501efd0978cfca797f8fad6a282146366cb8
-size 544899
+oid sha256:64838182757ba5ba7587d8dda2135a0139e0fce41cf5c47c09b002d48eb35b1c
+size 544927
--- a/lib/search/indexes/github-docs-3.0-cn.json.br
+++ b/lib/search/indexes/github-docs-3.0-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:c4afa60faa115fc4e62abe5f60a667677d72b34988075be6e8cda81da06cf92c
-size 907123
+oid sha256:e4d66fff24c25b293e47d7a79e27fc41e51e23da14fc0d64bc76e3caf8571b32
+size 906610
--- a/lib/search/indexes/github-docs-3.0-de-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d55cfdab7d2bd77811dabf244b27c1142c6f81edf73123afe2a2da4b13c20b25
-size 499877
+oid sha256:6df1e2b959f980bdac8968b644b6ce9f2b4d0d7c79c352204517eeff32bbd1de
+size 499705
--- a/lib/search/indexes/github-docs-3.0-de.json.br
+++ b/lib/search/indexes/github-docs-3.0-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:b2a811ed8bef80612cdec134f330a9ca8f5a17a70233cfa19634584a5366ea27
-size 2232574
+oid sha256:b577b17eedc8922274b87450de36e78b39f07730844838cdc08938fa10fba04f
+size 2233168
--- a/lib/search/indexes/github-docs-3.0-en-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bc039d9499a4c3de8bc98762ee8246f7406072ffafde4cc0e59127ff83cc4288
-size 453476
+oid sha256:bd6f1ffb6dc02b5c63c300f34f6f5fb4a6bfaac208b713b43ab0e745334adc4f
+size 454039
--- a/lib/search/indexes/github-docs-3.0-en.json.br
+++ b/lib/search/indexes/github-docs-3.0-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e0707ffcff230914538f096d507538ab7367ff92ff01878e4a7fc548f6f2d01f
-size 1771920
+oid sha256:468ab24a5a3f93b0e503a02377891ca687f3de92ccecf3cd62c0598f3c8c4d7d
+size 1770272
--- a/lib/search/indexes/github-docs-3.0-es-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:cd275d03c26693fe58ba11ff2e996af5f205af7281fe35c953a06a30e7d846ea
-size 193529
+oid sha256:f4b3165f99658751b42ddd6195b0401e0261114287de5c23890166fc23e3602b
+size 193628
--- a/lib/search/indexes/github-docs-3.0-es.json.br
+++ b/lib/search/indexes/github-docs-3.0-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:18bcf5bce399c66fc1add0dc16551bc00e7ac1924634d642913624d90197792b
-size 694372
+oid sha256:7577690f8c9ce729e9fee72b9fd1fe21820178b1625ad97f7f696c56b01aca34
+size 694548
--- a/lib/search/indexes/github-docs-3.0-ja-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4174247a9e5f14219438cb74d52d473c55c3cda06411d422ac3cd6ea9bb235be
-size 567900
+oid sha256:267f8ddc97996b73e00761e84eea6c84bad95cf238d76ada16be360acc4c916e
+size 567780
--- a/lib/search/indexes/github-docs-3.0-ja.json.br
+++ b/lib/search/indexes/github-docs-3.0-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f6c60f62476d034d0178385660e0c90caee2fc1b0659f40f15a29b0a53730d96
-size 3008097
+oid sha256:aab73428acea608f97813f7adfbcf338df7d2e6e67061e24a7a90848f6a91c5b
+size 3007131
--- a/lib/search/indexes/github-docs-3.0-pt-records.json.br
+++ b/lib/search/indexes/github-docs-3.0-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3c6e193a81411f323c31e7410ea32d40f2ae5c4642d0f551adfccffe9bc71df3
-size 477533
+oid sha256:43dda86cf90c32b6d022e2bc853581e03ec0d35f34d54805ffa278330f18dc2c
+size 477700
--- a/lib/search/indexes/github-docs-3.0-pt.json.br
+++ b/lib/search/indexes/github-docs-3.0-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:48d513add0193ee0f2b8e1ad77d25218ca35a081baaadb7cd201d9e94101baed
-size 1992884
+oid sha256:c28c5b93e1d20b0c9a4a045dbaefcb1a86ab4d145465159f381c6747fcd57e67
+size 1993277
--- a/lib/search/indexes/github-docs-3.1-cn-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ad9ad65ca2b288d03c37561d8531cb2170aca412b604de2e5cf1d9fb7bd62c67
-size 557519
+oid sha256:cde9f9bc5b5ef87c2383a460cc632ada9397e7c70007d754e26ce31ffe14630c
+size 557584
--- a/lib/search/indexes/github-docs-3.1-cn.json.br
+++ b/lib/search/indexes/github-docs-3.1-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1751c8ea1b6ea0efc3465b0d1cdffbb4678243179c36c275cdbdfdaedd61c4d2
-size 929848
+oid sha256:b12e74ae38d4174f9791c838c8b630a4e1fd55aecfa02b6c63a6d7b0ec0b05ec
+size 929609
--- a/lib/search/indexes/github-docs-3.1-de-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:990da558fc45d631d697c9321f943a3f8af6000be92fcb7265c5cc269e249b3c
-size 508596
+oid sha256:d92314c347e062ec7a52a4f2550e30d2804a369d722d279deeba2e3aa216e591
+size 508699
--- a/lib/search/indexes/github-docs-3.1-de.json.br
+++ b/lib/search/indexes/github-docs-3.1-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:341c1f305365994912f3a65dff5fa1f3cfb578f9ab87c1e958a814f7fab5a512
-size 2285338
+oid sha256:c778e3cfd1afbfef7e74f29c74aa5a8860be4369712f4b848d9ee002df68f082
+size 2284796
--- a/lib/search/indexes/github-docs-3.1-en-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:90da9d3783466397c0679880de589eb0412949e40c34e50f6adddf3b747c0e12
-size 464328
+oid sha256:3a9d9381ca12047a3625b5bde9e9b7d2a6517c38f72d371f00c21d43c4e049f8
+size 464144
--- a/lib/search/indexes/github-docs-3.1-en.json.br
+++ b/lib/search/indexes/github-docs-3.1-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:080e53e7c86c7f673b56cc198da74dfff65218071f1255d568baadb89ef5b1a8
-size 1814125
+oid sha256:e53c63ea0b5041bc8ce5f980e18594455428b9725ca32510e999f56f2451f4e1
+size 1813533
--- a/lib/search/indexes/github-docs-3.1-es-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1496f914da8de93397b5469922de8b3eaabd2f0da464bede95eb9f59baddc310
-size 193579
+oid sha256:5fdd4627561520d2e9a04f908df5b0e53e13ca48ffa8d8d38b9bf5a55d834040
+size 193648
--- a/lib/search/indexes/github-docs-3.1-es.json.br
+++ b/lib/search/indexes/github-docs-3.1-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:61d11cd130faa0ad1aa25f3175561999cf7794c0b4f49d6139fba65dc5c6446d
-size 694064
+oid sha256:77198f0851b1cc1261a3cc2971af6d0fc8c9a270664c3a885317c7c23b50e10f
+size 694199
--- a/lib/search/indexes/github-docs-3.1-ja-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:880f2a6770bbc3444256da810db639d12b2e3c1e19269662b885ef14b8a2b8f0
-size 579951
+oid sha256:7f86bcbe9ed743aed2f30f8c73ee9a734daef2b3abfa805d2eb2780ccc84cd87
+size 580035
--- a/lib/search/indexes/github-docs-3.1-ja.json.br
+++ b/lib/search/indexes/github-docs-3.1-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:13f341bcd41605cad606d4a5a4f41bad96dbc9881497fcd95d9b6cb02f8ad4cd
-size 3074427
+oid sha256:8e924568813c5158f3c4122d1e436637648e8503cfdfa22a12544b6cd8d84fec
+size 3073509
--- a/lib/search/indexes/github-docs-3.1-pt-records.json.br
+++ b/lib/search/indexes/github-docs-3.1-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bc608eaf70d2f9f3fe6b07a5f1a8aa985140412bf56ac788816574b62f94d0cf
-size 487252
+oid sha256:eeb3538b82c8fbdefe78e0aec99ae1bfb08ae5cc60e24beabf02d61cd5c3f0b9
+size 487118
--- a/lib/search/indexes/github-docs-3.1-pt.json.br
+++ b/lib/search/indexes/github-docs-3.1-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:f8c0126d286ad256276dd2a7bc93de58bec6aa5fed49d030abf21ace412377ae
-size 2038093
+oid sha256:636a9044b704af85f600189de1249627ca9a8dbeb5908ca2d87a90d8e2043f57
+size 2036685
--- a/lib/search/indexes/github-docs-3.2-cn-records.json.br
+++ b/lib/search/indexes/github-docs-3.2-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:7761c50d49e8c1e16516beb10591e9637a48f530c576589d6e6dcc9e9080846d
-size 568120
+oid sha256:6c8a0d06c907ae0a2f1f2a5470cc10a53b7fcacb8d4c6721904bcb2c96c32056
+size 567937
--- a/lib/search/indexes/github-docs-3.2-cn.json.br
+++ b/lib/search/indexes/github-docs-3.2-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2421ff74d9968160d2023f536d4f87949316f72d8e91da00d67b38e82192abaa
-size 949535
+oid sha256:52d75eee9c962d2557fe7bebd3c214ad2f1a9fe17373ff7e825d9c8a32c01411
+size 949359
--- a/lib/search/indexes/github-docs-3.2-de-records.json.br
+++ b/lib/search/indexes/github-docs-3.2-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:b064e0853e819301012c4cdbb7fd4e3d9c3c82e1979b299219f86e35bf55abe7
-size 517714
+oid sha256:bceae6b35d4a505b8a77c14774fe8b680641679604e64d636190de529fa8188f
+size 517641
--- a/lib/search/indexes/github-docs-3.2-de.json.br
+++ b/lib/search/indexes/github-docs-3.2-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1a05f9cf9a1dd9f2639f28fab701ed23c89ff5ebb492689b81adbb9291324094
+oid sha256:3c1fa6440aaa0ffb4a29753c7e0ab9da402811f5c174699f0307b43536c71a6c
 size 2333276
--- a/lib/search/indexes/github-docs-3.2-en-records.json.br
+++ b/lib/search/indexes/github-docs-3.2-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6b0e0617c60c06a9c7955a1eb2851d9fe8b771fced0e5a7d4c8b68e35c3efa3c
-size 472716
+oid sha256:bb59275fbe4a8863cf767ca8e79fd79dd25ba7363db285c176cba72a9d2afe05
+size 472643
--- a/lib/search/indexes/github-docs-3.2-en.json.br
+++ b/lib/search/indexes/github-docs-3.2-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ea25e08e5c49ef0191599307879f50b0e42c793e700011d63432132203a55250
-size 1845938
+oid sha256:e4d0f2784b83810fcad0f76812e727df38a160cd3e4ad7e985280574f4a091a9
+size 1844893
--- a/lib/search/indexes/github-docs-3.2-es-records.json.br
+++ b/lib/search/indexes/github-docs-3.2-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4c9fd14f09f3c7986401bd2895f543e9ed55a4d5c5c650138854701e3dd61e2b
-size 193683
+oid sha256:6c1a327461095f007d05dc2062e1b61ddd095e53d7cc04243cd7b988060a4bca
+size 193702
--- a/lib/search/indexes/github-docs-3.2-es.json.br
+++ b/lib/search/indexes/github-docs-3.2-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:7e644835b9d60ff6c7df7a8d3900d182778c91bf770dec6d166a22b2bc4e6517
-size 694027
+oid sha256:4454113a231a3214d387eba0153102719e676bfce7ce6ce382f36987f1580376
+size 694160
--- a/lib/search/indexes/github-docs-3.2-ja-records.json.br
+++ b/lib/search/indexes/github-docs-3.2-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3d72531da85b915f27a499bdf51cfbe863e947cf6665b6d8a710646ae5c344c8
-size 590526
+oid sha256:17b32ec1a96a08da0daf36c6e24f9a8c20e79f7b794cebbcfa1ea4c1547745d8
+size 590408
--- a/lib/search/indexes/github-docs-3.2-ja.json.br
+++ b/lib/search/indexes/github-docs-3.2-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ae11d664c689dccff29ac263a173d3dc06c9ae8c5f646f5280969988e4318821
-size 3141532
+oid sha256:618858821456bc98f3ea8ec275a840af31d398373eece9fb81d7ff824d620ddc
+size 3140224
--- a/lib/search/indexes/github-docs-3.2-pt-records.json.br
+++ b/lib/search/indexes/github-docs-3.2-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:55e10ee2b1125c4421eab60242a53d5052217747dc122e6af07fa5e0fbe52d8e
-size 496770
+oid sha256:82097965f2013c4feb628aa78226a7df19a2928d212706f4a2ecf657716fa703
+size 496899
--- a/lib/search/indexes/github-docs-3.2-pt.json.br
+++ b/lib/search/indexes/github-docs-3.2-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:b1ddfa98813253e2f6b9f383f2f93aa4471a58099b9b21f854b925cddeb16013
-size 2078717
+oid sha256:8a901edfc7a27a1d23839a76b04ccab0e5eea9e4980095908260356d1b56e407
+size 2079110
--- a/lib/search/indexes/github-docs-dotcom-cn-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8378db315e35bfab90337ac8bf5e44f745d59482e8e212befe2001f24fd7b5a8
-size 770980
+oid sha256:a6d70bed7bf2da642689bbd977a69516ed6e0b5d8b18102d0a46ab49840563bd
+size 770387
--- a/lib/search/indexes/github-docs-dotcom-cn.json.br
+++ b/lib/search/indexes/github-docs-dotcom-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:3b23b5fe0fe7b5eb9f31272c6923dff6c6a61f01026a9e03cad74556f8cc1bf8
-size 1171460
+oid sha256:5f44f6bea73e1b8b541d6c50d08119f6b7700607e1b91a0b4ce3ca66f0c84a38
+size 1171387
--- a/lib/search/indexes/github-docs-dotcom-de-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:4efa48e0f7ee259a28681cade37bab38632fcc74532fe8a5f88f28c6c63819be
-size 690765
+oid sha256:cada21a62e21789ae7e6af3f4d5895aa812ad50e2b1feeff66c010962c906828
+size 690576
--- a/lib/search/indexes/github-docs-dotcom-de.json.br
+++ b/lib/search/indexes/github-docs-dotcom-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:45b18aa15bc6c161d9ae0330eae82303fd3eda639abab8a2c0628a13f1505843
-size 3124441
+oid sha256:40c92ca695273e1bb0de9ccc5d223651d2ba0edea403816137c918d31b0d10aa
+size 3124808
--- a/lib/search/indexes/github-docs-dotcom-en-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:cfb0b748498a496682098fefe47c33370711326c145e8da1f8a6232d2725b054
-size 638883
+oid sha256:57bf9e8e1ee54c70425c255fc64ad41e52f3ddfa950d31294eff285f5d054602
+size 639166
--- a/lib/search/indexes/github-docs-dotcom-en.json.br
+++ b/lib/search/indexes/github-docs-dotcom-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:fef2e06df0ba425fdbc9db96e7ff73e97f8621cdb22b12bc8939dbc1090eef3d
-size 2427922
+oid sha256:951d067b784a87ca618148b2e370548ff009a0816c41445dfeac7b75b1d30524
+size 2428888
--- a/lib/search/indexes/github-docs-dotcom-es-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bde595553329d38dc248c8b85f82b133eafdf44d6a9b0ee56ec808b1df28056e
-size 205227
+oid sha256:a8ae578d42c9758d362d54c4ac728dd754719a2d326f9a01ba803010d6919ea3
+size 205226
--- a/lib/search/indexes/github-docs-dotcom-es.json.br
+++ b/lib/search/indexes/github-docs-dotcom-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0ce83d9b5d28f8f1b467f5ad20d66558d4c0d2416946e1909a18ca9fa88052d7
-size 651136
+oid sha256:936921fef9219f5b7646381b127020df9b94ab2445c892bfcb0972eb21e1fd88
+size 650902
--- a/lib/search/indexes/github-docs-dotcom-ja-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:778e0b2f9be95f2fcba6b461b5e9279df32a3f9214a9636655d79cf91ebd9dcb
-size 795770
+oid sha256:0d5e81d5413dfc952d70c30df1af4c6958a50d6c6449165bf7e7c2e2f073415a
+size 795122
--- a/lib/search/indexes/github-docs-dotcom-ja.json.br
+++ b/lib/search/indexes/github-docs-dotcom-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d9f190ebe4f5e25bc1c53c47ad29d6cceb57ac7a071b01f58bca6e6bbe6a81d6
-size 4153131
+oid sha256:5f649fe3416979b42c196665b7d8bf2102e1880a993d533d2d1b429f1c2eb29f
+size 4151520
--- a/lib/search/indexes/github-docs-dotcom-pt-records.json.br
+++ b/lib/search/indexes/github-docs-dotcom-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:66024f8a2944ef349bb01185d8afdd7b1bf9e4d98fbc9f0aa16a6b3741c2e205
-size 669886
+oid sha256:6c43d354d8c5b57134f6e0b58776dd7b41f1588ceef9c966c7181ea26f873acf
+size 669455
--- a/lib/search/indexes/github-docs-dotcom-pt.json.br
+++ b/lib/search/indexes/github-docs-dotcom-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:ebe055935e6d2911a7900e8a34439fbc9250d37f672ae318b109b66faadd2f4e
-size 2751493
+oid sha256:724e39433cef2f97502cf154f264cf1f25d37b12914343dac69f2fcf7031602f
+size 2750153
--- a/lib/search/indexes/github-docs-ghae-cn-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-cn-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e5bbf996198e3538a0b8d1429d3ccbcdcd487554f017beb3ab70105f881a7bea
-size 433700
+oid sha256:a71b4237a5088d121ec92b3afaf5b88502c7a19b2e6d337c128720e74713b315
+size 433589
--- a/lib/search/indexes/github-docs-ghae-cn.json.br
+++ b/lib/search/indexes/github-docs-ghae-cn.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:2d95c42488612b7d51b87f921ec7f075fb33b2d3806a2ead4319700f8c869dbc
-size 691915
+oid sha256:2c122e07f270df80c8bb8bdb1fbfc8e00a2a03601176a035ecdf9c7263bbcc6d
+size 691580
--- a/lib/search/indexes/github-docs-ghae-de-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-de-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6df22e95e3048c9c2f3455ff1b1fbd66fd410b2e68f78fcdab1a4307d4357a27
-size 400661
+oid sha256:71592596f4b71e18683c19853977546db42ac4faf50a94874a02223252de2da4
+size 400534
--- a/lib/search/indexes/github-docs-ghae-de.json.br
+++ b/lib/search/indexes/github-docs-ghae-de.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:973e4444e1cb3b28e083409e9f0fed9a875add77cecf4de012eb7161d05b5054
-size 1741863
+oid sha256:7136dbd85ca3c2838f1fe0001953284d68ae8d72cb856cf02c3b9b65465a9345
+size 1741762
--- a/lib/search/indexes/github-docs-ghae-en-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-en-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:b4ba15f5b979b4caa3765a45410be8185cbe3a79dd7c07c3dd208c7cf4b8a6b1
-size 366072
+oid sha256:0cf3737c615d34ee4f9679f010f0fe4122a463b24772da894e083873f9199f3b
+size 365611
--- a/lib/search/indexes/github-docs-ghae-en.json.br
+++ b/lib/search/indexes/github-docs-ghae-en.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:1f14c2aa58572fa18b1052160b1ff7e25d9f1e70d7b1acdbafa1076d1c619d64
-size 1358785
+oid sha256:d00bfd3a278f1feb8436970976386dfe28fa73abde814d9a98f37f1351901440
+size 1358729
--- a/lib/search/indexes/github-docs-ghae-es-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-es-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:77e009d60430bdc575ade588e59c0c77a44987f2a5b4ff6c9cf78e0e7f86ee2e
-size 130798
+oid sha256:a17db2d27cfc0dda56102444a35626415074686ea06bab37a9212ee5dc2382a6
+size 130810
--- a/lib/search/indexes/github-docs-ghae-es.json.br
+++ b/lib/search/indexes/github-docs-ghae-es.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:7b7edf7f4b66c157d71dc9a3bf2c2c08e21e43b2d47bab18a7087a1596e8d47c
-size 420019
+oid sha256:2af973d2d165d31b5e1a4bee25ef8750d7fdbf7b649bbdd19d1a63d1041c9c8c
+size 420075
--- a/lib/search/indexes/github-docs-ghae-ja-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-ja-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:948e85c8a342bbe8defd3ca7ba8647af76ef16a79de2c3a4c6d9101f37b3d6f5
-size 453226
+oid sha256:7ea485e34b695129bcaaaf7e636b5e49c5c32c59f427614c041bcab3f7c8b854
+size 453042
--- a/lib/search/indexes/github-docs-ghae-ja.json.br
+++ b/lib/search/indexes/github-docs-ghae-ja.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:6003090218ec785d499a2908988dbfdeb4a82aba77930a88ecb19419a26c6e1d
-size 2297372
+oid sha256:04d8df49a99dee76c6f0e29df051d1e22b1cdbfab23afda4ab01e0f0a4054ecd
+size 2296689
--- a/lib/search/indexes/github-docs-ghae-pt-records.json.br
+++ b/lib/search/indexes/github-docs-ghae-pt-records.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:0d4e20b8d2e2bc987599ca58385263fc52b50e6e581c114d603f9e2492610c95
-size 385053
+oid sha256:9bd443425df118380cea6fa76a84a358dc46200ad6b1b5120c2935beece77f38
+size 385008
--- a/lib/search/indexes/github-docs-ghae-pt.json.br
+++ b/lib/search/indexes/github-docs-ghae-pt.json.br
@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:d27acad1b75beb510e1983a30731b756f6edf979b73d09361288a4b946b1ffb5
-size 1537113
+oid sha256:c8f944435d164d63c0bcd87ad6da2cb054c7cdb617284a025a487a2d54b42a93
+size 1536838
--- a/package-lock.json
+++ b/package-lock.json
@@ -19366,9 +19366,9 @@
      }
    },
    "node_modules/prismjs": {
-      "version": "1.24.1",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.1.tgz",
-      "integrity": "sha512-mNPsedLuk90RVJioIky8ANZEwYm5w9LcvCXrxHlwf4fNVSn8jEipMybMkWUyyF0JhnC+C4VcOVSBuHRKs1L5Ow=="
+      "version": "1.25.0",
+      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.25.0.tgz",
+      "integrity": "sha512-WCjJHl1KEWbnkQom1+SzftbtXMKQoezOCYs5rECqMN+jP+apI7ftoflyqigqzopSO3hMhTEb0mFClA8lkolgEg=="
    },
    "node_modules/private": {
      "version": "0.1.8",
@@ -20059,13 +20059,13 @@
      }
    },
    "node_modules/refractor": {
-      "version": "3.4.0",
-      "resolved": "https://registry.npmjs.org/refractor/-/refractor-3.4.0.tgz",
-      "integrity": "sha512-dBeD02lC5eytm9Gld2Mx0cMcnR+zhSnsTfPpWqFaMgUMJfC9A6bcN3Br/NaXrnBJcuxnLFR90k1jrkaSyV8umg==",
+      "version": "3.5.0",
+      "resolved": "https://registry.npmjs.org/refractor/-/refractor-3.5.0.tgz",
+      "integrity": "sha512-QwPJd3ferTZ4cSPPjdP5bsYHMytwWYnAN5EEnLtGvkqp/FCCnGsBgxrm9EuIDnjUC3Uc/kETtvVi7fSIVC74Dg==",
      "dependencies": {
        "hastscript": "^6.0.0",
        "parse-entities": "^2.0.0",
-        "prismjs": "~1.24.0"
+        "prismjs": "~1.25.0"
      },
      "funding": {
        "type": "github",
@@ -40256,9 +40256,9 @@
      "optional": true
    },
    "prismjs": {
-      "version": "1.24.1",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.1.tgz",
-      "integrity": "sha512-mNPsedLuk90RVJioIky8ANZEwYm5w9LcvCXrxHlwf4fNVSn8jEipMybMkWUyyF0JhnC+C4VcOVSBuHRKs1L5Ow=="
+      "version": "1.25.0",
+      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.25.0.tgz",
+      "integrity": "sha512-WCjJHl1KEWbnkQom1+SzftbtXMKQoezOCYs5rECqMN+jP+apI7ftoflyqigqzopSO3hMhTEb0mFClA8lkolgEg=="
    },
    "private": {
      "version": "0.1.8",
@@ -40806,13 +40806,13 @@
      }
    },
    "refractor": {
-      "version": "3.4.0",
-      "resolved": "https://registry.npmjs.org/refractor/-/refractor-3.4.0.tgz",
-      "integrity": "sha512-dBeD02lC5eytm9Gld2Mx0cMcnR+zhSnsTfPpWqFaMgUMJfC9A6bcN3Br/NaXrnBJcuxnLFR90k1jrkaSyV8umg==",
+      "version": "3.5.0",
+      "resolved": "https://registry.npmjs.org/refractor/-/refractor-3.5.0.tgz",
+      "integrity": "sha512-QwPJd3ferTZ4cSPPjdP5bsYHMytwWYnAN5EEnLtGvkqp/FCCnGsBgxrm9EuIDnjUC3Uc/kETtvVi7fSIVC74Dg==",
      "requires": {
        "hastscript": "^6.0.0",
        "parse-entities": "^2.0.0",
-        "prismjs": "~1.24.0"
+        "prismjs": "~1.25.0"
      },
      "dependencies": {
        "character-entities": {