diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json index 38926a7dd8..a10ad565e4 100644 --- a/.devcontainer/devcontainer.json +++ b/.devcontainer/devcontainer.json @@ -32,12 +32,6 @@ "postCreateCommand": "npm ci && npm run build", // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root. - "remoteUser": "node", - - // Test restricting low-spec machines - "hostRequirements": { - "cpus": 8, - "memory": "8gb", - "storage": "32gb" - } + "remoteUser": "node" + } diff --git a/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/nodejs.tsx b/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/nodejs.tsx index 1992008c04..903ebb49c0 100644 --- a/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/nodejs.tsx +++ b/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/nodejs.tsx @@ -24,11 +24,11 @@ const article: PlaygroundArticleT = { id: '0', }, type: 'default', - title: 'Starting with the Node.js workflow template', + title: 'Using the Node.js starter workflow', content: dedent` - GitHub provides a Node.js workflow template that will work for most Node.js projects. This guide includes npm and Yarn examples that you can use to customize the template. For more information, see the [Node.js workflow template](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml). + GitHub provides a Node.js starter workflow that will work for most Node.js projects. This guide includes npm and Yarn examples that you can use to customize the starter workflow. For more information, see the [Node.js starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml). - To get started quickly, add the template to the \`.github/workflows\` directory of your repository. The example workflow assumes that the default branch for your repository is \`main\`. + To get started quickly, add the starter workflow to the \`.github/workflows\` directory of your repository. The example workflow assumes that the default branch for your repository is \`main\`. `, }, { @@ -39,7 +39,7 @@ const article: PlaygroundArticleT = { type: 'default', title: 'Running on a different operating system', content: dedent` - The starter workflow template configures jobs to run on Linux, using the GitHub-hosted \`ubuntu-latest\` runners. You can change the \`runs-on\` key to run your jobs on a different operating system. For example, you can use the GitHub-hosted Windows runners. + The starter workflow configures jobs to run on Linux, using the GitHub-hosted \`ubuntu-latest\` runners. You can change the \`runs-on\` key to run your jobs on a different operating system. For example, you can use the GitHub-hosted Windows runners. \`\`\`yaml runs-on: windows-latest @@ -66,7 +66,7 @@ const article: PlaygroundArticleT = { The \`setup-node\` action takes a Node.js version as an input and configures that version on the runner. The \`setup-node\` action finds a specific version of Node.js from the tools cache on each runner and adds the necessary binaries to \`PATH\`, which persists for the rest of the job. Using the \`setup-node\` action is the recommended way of using Node.js with GitHub Actions because it ensures consistent behavior across different runners and different versions of Node.js. If you are using a self-hosted runner, you must install Node.js and add it to \`PATH\`. - The template includes a matrix strategy that builds and tests your code with four Node.js versions: 10.x, 12.x, 14.x, and 15.x. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Each version of Node.js specified in the \`node-version\` array creates a job that runs the same steps. + The starter workflow includes a matrix strategy that builds and tests your code with four Node.js versions: 10.x, 12.x, 14.x, and 15.x. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Each version of Node.js specified in the \`node-version\` array creates a job that runs the same steps. Each job can access the value defined in the matrix \`node-version\` array using the \`matrix\` context. The \`setup-node\` action uses the context as the \`node-version\` input. The \`setup-node\` action configures each job with a different Node.js version before building and testing code. For more information about matrix strategies and contexts, see "[Workflow syntax for GitHub Actions](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" and "[Context and expression syntax for GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions)." `, diff --git a/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/python.tsx b/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/python.tsx index 52a4dfb7be..d5fcdeeb81 100644 --- a/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/python.tsx +++ b/components/playground/content/actions/guides/building-and-testing-nodejs-or-python/python.tsx @@ -28,11 +28,11 @@ const article: PlaygroundArticleT = { codeBlock: { id: '0', }, - title: 'Starting with the Python workflow template', + title: 'Using the Python starter workflow', content: dedent` - GitHub provides a Python workflow template that should work for most Python projects. This guide includes examples that you can use to customize the template. For more information, see the [Python workflow template](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml). + GitHub provides a Python starter workflow that should work for most Python projects. This guide includes examples that you can use to customize the starter workflow. For more information, see the [Python starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml). - To get started quickly, add the template to the \`.github/workflows\` directory of your repository. + To get started quickly, add the starter workflow to the \`.github/workflows\` directory of your repository. `, }, { @@ -206,7 +206,7 @@ const article: PlaygroundArticleT = { For this example, you will need to create two [PyPI API tokens](https://pypi.org/help/#apitoken). You can use secrets to store the access tokens or credentials needed to publish your package. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." - For more information about the template workflow, see [\`python-publish\`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml). + For more information about the starter workflow, see [\`python-publish\`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml). `, }, ], diff --git a/content/actions/automating-builds-and-tests/about-continuous-integration.md b/content/actions/automating-builds-and-tests/about-continuous-integration.md index 393d8c7c60..5c660e6ecb 100644 --- a/content/actions/automating-builds-and-tests/about-continuous-integration.md +++ b/content/actions/automating-builds-and-tests/about-continuous-integration.md @@ -39,19 +39,19 @@ You can configure your CI workflow to run when a {% data variables.product.prodn {% data variables.product.product_name %} runs your CI tests and provides the results of each test in the pull request, so you can see whether the change in your branch introduces an error. When all CI tests in a workflow pass, the changes you pushed are ready to be reviewed by a team member or merged. When a test fails, one of your changes may have caused the failure. -When you set up CI in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends CI workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests. You can use the CI workflow template suggested by {% data variables.product.product_name %}, customize the suggested template, or create your own custom workflow file to run your CI tests. +When you set up CI in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends CI workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a starter workflow that installs your Node.js packages and runs your tests. You can use the CI starter workflow suggested by {% data variables.product.product_name %}, customize the suggested starter workflow, or create your own custom workflow file to run your CI tests. -![Screenshot of suggested continuous integration templates](/assets/images/help/repository/ci-with-actions-template-picker.png) +![Screenshot of suggested continuous integration starter workflows](/assets/images/help/repository/ci-with-actions-template-picker.png) In addition to helping you set up CI workflows for your project, you can use {% data variables.product.prodname_actions %} to create workflows across the full software development life cycle. For example, you can use actions to deploy, package, or release your project. For more information, see "[About {% data variables.product.prodname_actions %}](/articles/about-github-actions)." For a definition of common terms, see "[Core concepts for {% data variables.product.prodname_actions %}](/github/automating-your-workflow-with-github-actions/core-concepts-for-github-actions)." -## Workflow templates +## Starter workflow -{% data variables.product.product_name %} offers CI workflow templates for a variety of languages and frameworks. +{% data variables.product.product_name %} offers CI starter workflow for a variety of languages and frameworks. -Browse the complete list of CI workflow templates offered by {% data variables.product.company_short %} in the {% ifversion fpt or ghec %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}. +Browse the complete list of CI starter workflow offered by {% data variables.product.company_short %} in the {% ifversion fpt or ghec %}[actions/starter-workflows](https://github.com/actions/starter-workflows/tree/main/ci) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}. ## Further reading diff --git a/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md b/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md index e064761894..ccf04b5c79 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-java-with-ant.md @@ -40,11 +40,11 @@ We recommend that you have a basic understanding of Java and the Ant framework. {% data reusables.actions.enterprise-setup-prereq %} -## Starting with an Ant workflow template +## Using the Ant starter workflow -{% data variables.product.prodname_dotcom %} provides an Ant workflow template that will work for most Ant-based Java projects. For more information, see the [Ant workflow template](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml). +{% data variables.product.prodname_dotcom %} provides an Ant starter workflow that will work for most Ant-based Java projects. For more information, see the [Ant starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/ant.yml). -To get started quickly, you can choose the preconfigured Ant template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." +To get started quickly, you can choose the preconfigured Ant starter workflow when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository. @@ -76,7 +76,7 @@ This workflow performs the following steps: 2. The `setup-java` step configures the Java 11 JDK by Adoptium. 3. The "Build with Ant" step runs the default target in your `build.xml` in non-interactive mode. -The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs. +The default starter workflows are excellent starting points when creating your build and test workflow, and you can customize the starter workflow to suit your project’s needs. {% data reusables.github-actions.example-github-runner %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md b/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md index 74fb4ffb74..53d8174806 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-java-with-gradle.md @@ -40,11 +40,11 @@ We recommend that you have a basic understanding of Java and the Gradle framewor {% data reusables.actions.enterprise-setup-prereq %} -## Starting with a Gradle workflow template +## Using the Gradle starter workflow -{% data variables.product.prodname_dotcom %} provides a Gradle workflow template that will work for most Gradle-based Java projects. For more information, see the [Gradle workflow template](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml). +{% data variables.product.prodname_dotcom %} provides a Gradle starter workflow that will work for most Gradle-based Java projects. For more information, see the [Gradle starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/gradle.yml). -To get started quickly, you can choose the preconfigured Gradle template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." +To get started quickly, you can choose the preconfigured Gradle starter workflow when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository. @@ -79,7 +79,7 @@ This workflow performs the following steps: 3. The "Validate Gradle wrapper" step validates the checksums of Gradle Wrapper JAR files present in the source tree. 4. The "Build with Gradle" step runs the `gradlew` wrapper script to ensure that your code builds, tests pass, and a package can be created. -The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs. +The default starter workflows are excellent starting points when creating your build and test workflow, and you can customize the starter workflow to suit your project’s needs. {% data reusables.github-actions.example-github-runner %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md b/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md index a8403ce752..bc44e08de5 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-java-with-maven.md @@ -40,11 +40,11 @@ We recommend that you have a basic understanding of Java and the Maven framework {% data reusables.actions.enterprise-setup-prereq %} -## Starting with a Maven workflow template +## Using the Maven starter workflow -{% data variables.product.prodname_dotcom %} provides a Maven workflow template that will work for most Maven-based Java projects. For more information, see the [Maven workflow template](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml). +{% data variables.product.prodname_dotcom %} provides a Maven starter workflow that will work for most Maven-based Java projects. For more information, see the [Maven starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/maven.yml). -To get started quickly, you can choose the preconfigured Maven template when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." +To get started quickly, you can choose the preconfigured Maven starter workflow when you create a new workflow. For more information, see the "[{% data variables.product.prodname_actions %} quickstart](/actions/quickstart)." You can also add this workflow manually by creating a new file in the `.github/workflows` directory of your repository. @@ -76,7 +76,7 @@ This workflow performs the following steps: 2. The `setup-java` step configures the Java 11 JDK by Adoptium. 3. The "Build with Maven" step runs the Maven `package` target in non-interactive mode to ensure that your code builds, tests pass, and a package can be created. -The default workflow templates are excellent starting points when creating your build and test workflow, and you can customize the template to suit your project’s needs. +The default starter workflows are excellent starting points when creating your build and test workflow, and you can customize the starter workflow to suit your project’s needs. {% data reusables.github-actions.example-github-runner %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-net.md b/content/actions/automating-builds-and-tests/building-and-testing-net.md index ba114a3e74..774d757556 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-net.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-net.md @@ -28,11 +28,11 @@ You should already be familiar with YAML syntax and how it's used with {% data v We recommend that you have a basic understanding of the .NET Core SDK. For more information, see [Getting started with .NET](https://dotnet.microsoft.com/learn). -## Starting with the .NET workflow template +## Using the .NET starter workflow -{% data variables.product.prodname_dotcom %} provides a .NET workflow template that should work for most .NET projects, and this guide includes examples that show you how to customize this template. For more information, see the [.NET workflow template](https://github.com/actions/setup-dotnet). +{% data variables.product.prodname_dotcom %} provides a .NET starter workflow that should work for most .NET projects, and this guide includes examples that show you how to customize this starter workflow. For more information, see the [.NET starter workflow](https://github.com/actions/setup-dotnet). -To get started quickly, add the template to the `.github/workflows` directory of your repository. +To get started quickly, add the starter workflow to the `.github/workflows` directory of your repository. {% raw %} ```yaml diff --git a/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md b/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md index 8460d39730..ecb2e61aa8 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-nodejs.md @@ -36,11 +36,11 @@ We recommend that you have a basic understanding of Node.js, YAML, workflow conf {% data reusables.actions.enterprise-setup-prereq %} -## Starting with the Node.js workflow template +## Using the Node.js starter workflow -{% data variables.product.prodname_dotcom %} provides a Node.js workflow template that will work for most Node.js projects. This guide includes npm and Yarn examples that you can use to customize the template. For more information, see the [Node.js workflow template](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml). +{% data variables.product.prodname_dotcom %} provides a Node.js starter workflow that will work for most Node.js projects. This guide includes npm and Yarn examples that you can use to customize the starter workflow. For more information, see the [Node.js starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/node.js.yml). -To get started quickly, add the template to the `.github/workflows` directory of your repository. The workflow shown below assumes that the default branch for your repository is `main`. +To get started quickly, add the starter workflow to the `.github/workflows` directory of your repository. The workflow shown below assumes that the default branch for your repository is `main`. {% raw %} ```yaml{:copy} @@ -81,7 +81,7 @@ The easiest way to specify a Node.js version is by using the `setup-node` action The `setup-node` action takes a Node.js version as an input and configures that version on the runner. The `setup-node` action finds a specific version of Node.js from the tools cache on each runner and adds the necessary binaries to `PATH`, which persists for the rest of the job. Using the `setup-node` action is the recommended way of using Node.js with {% data variables.product.prodname_actions %} because it ensures consistent behavior across different runners and different versions of Node.js. If you are using a self-hosted runner, you must install Node.js and add it to `PATH`. -The template includes a matrix strategy that builds and tests your code with four Node.js versions: 10.x, 12.x, 14.x, and 15.x. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Each version of Node.js specified in the `node-version` array creates a job that runs the same steps. +The starter workflow includes a matrix strategy that builds and tests your code with four Node.js versions: 10.x, 12.x, 14.x, and 15.x. The 'x' is a wildcard character that matches the latest minor and patch release available for a version. Each version of Node.js specified in the `node-version` array creates a job that runs the same steps. Each job can access the value defined in the matrix `node-version` array using the `matrix` context. The `setup-node` action uses the context as the `node-version` input. The `setup-node` action configures each job with a different Node.js version before building and testing code. For more information about matrix strategies and contexts, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix)" and "[Contexts](/actions/learn-github-actions/contexts)." diff --git a/content/actions/automating-builds-and-tests/building-and-testing-python.md b/content/actions/automating-builds-and-tests/building-and-testing-python.md index bdbeef71ff..c67f6a545b 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-python.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-python.md @@ -42,11 +42,11 @@ We recommend that you have a basic understanding of Python, PyPy, and pip. For m {% data reusables.actions.enterprise-setup-prereq %} -## Starting with the Python workflow template +## Using the Python starter workflow -{% data variables.product.prodname_dotcom %} provides a Python workflow template that should work for most Python projects. This guide includes examples that you can use to customize the template. For more information, see the [Python workflow template](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml). +{% data variables.product.prodname_dotcom %} provides a Python starter workflow that should work for most Python projects. This guide includes examples that you can use to customize the starter workflow. For more information, see the [Python starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/python-package.yml). -To get started quickly, add the template to the `.github/workflows` directory of your repository. +To get started quickly, add the starter workflow to the `.github/workflows` directory of your repository. {% raw %} ```yaml{:copy} @@ -426,4 +426,4 @@ jobs: password: {% raw %}${{ secrets.PYPI_API_TOKEN }}{% endraw %} ``` -For more information about the template workflow, see [`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml). +For more information about the starter workflow, see [`python-publish`](https://github.com/actions/starter-workflows/blob/main/ci/python-publish.yml). diff --git a/content/actions/automating-builds-and-tests/building-and-testing-ruby.md b/content/actions/automating-builds-and-tests/building-and-testing-ruby.md index 6da09a7717..09d888b839 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-ruby.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-ruby.md @@ -29,11 +29,11 @@ We recommend that you have a basic understanding of Ruby, YAML, workflow configu - [Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions) - [Ruby in 20 minutes](https://www.ruby-lang.org/en/documentation/quickstart/) -## Starting with the Ruby workflow template +## Using the Ruby starter workflow -{% data variables.product.prodname_dotcom %} provides a Ruby workflow template that will work for most Ruby projects. For more information, see the [Ruby workflow template](https://github.com/actions/starter-workflows/blob/master/ci/ruby.yml). +{% data variables.product.prodname_dotcom %} provides a Ruby starter workflow that will work for most Ruby projects. For more information, see the [Ruby starter workflow](https://github.com/actions/starter-workflows/blob/master/ci/ruby.yml). -To get started quickly, add the template to the `.github/workflows` directory of your repository. The workflow shown below assumes that the default branch for your repository is `main`. +To get started quickly, add the starter workflow to the `.github/workflows` directory of your repository. The workflow shown below assumes that the default branch for your repository is `main`. ```yaml {% data reusables.actions.actions-not-certified-by-github-comment %} diff --git a/content/actions/automating-builds-and-tests/building-and-testing-swift.md b/content/actions/automating-builds-and-tests/building-and-testing-swift.md index 8bbcaef747..c343875e70 100644 --- a/content/actions/automating-builds-and-tests/building-and-testing-swift.md +++ b/content/actions/automating-builds-and-tests/building-and-testing-swift.md @@ -31,11 +31,11 @@ You should already be familiar with YAML syntax and how it's used with {% data v We recommend that you have a basic understanding of Swift packages. For more information, see "[Swift Packages](https://developer.apple.com/documentation/swift_packages)" in the Apple developer documentation. -## Starting with the Swift workflow template +## Using the Swift starter workflow -{% data variables.product.prodname_dotcom %} provides a Swift workflow template that should work for most Swift projects, and this guide includes examples that show you how to customize this template. For more information, see the [Swift workflow template](https://github.com/actions/starter-workflows/blob/main/ci/swift.yml). +{% data variables.product.prodname_dotcom %} provides a Swift starter workflow that should work for most Swift projects, and this guide includes examples that show you how to customize this starter workflow. For more information, see the [Swift starter workflow](https://github.com/actions/starter-workflows/blob/main/ci/swift.yml). -To get started quickly, add the template to the `.github/workflows` directory of your repository. +To get started quickly, add the starter workflow to the `.github/workflows` directory of your repository. {% raw %} ```yaml{:copy} diff --git a/content/actions/deployment/about-deployments/about-continuous-deployment.md b/content/actions/deployment/about-deployments/about-continuous-deployment.md index cf534d337e..e941449aa8 100644 --- a/content/actions/deployment/about-deployments/about-continuous-deployment.md +++ b/content/actions/deployment/about-deployments/about-continuous-deployment.md @@ -40,7 +40,7 @@ You can configure your CD workflow to run when a {% data variables.product.produ {% endif %} -## Workflow templates and third party actions +## Starter workflows and third party actions {% data reusables.actions.cd-templates-actions %} diff --git a/content/actions/guides.md b/content/actions/guides.md index 3a445c387b..f6cec21fcb 100644 --- a/content/actions/guides.md +++ b/content/actions/guides.md @@ -20,7 +20,7 @@ includeGuides: - /actions/quickstart - /actions/learn-github-actions/introduction-to-github-actions - /actions/creating-actions/creating-a-docker-container-action - - /actions/learn-github-actions/using-workflow-templates + - /actions/learn-github-actions/using-starter-workflows - /actions/automating-builds-and-tests/building-and-testing-python - /actions/automating-builds-and-tests/building-and-testing-nodejs - /actions/publishing-packages/about-packaging-with-github-actions diff --git a/content/actions/index.md b/content/actions/index.md index 874053eb2b..8828a7a41c 100644 --- a/content/actions/index.md +++ b/content/actions/index.md @@ -13,7 +13,7 @@ featuredLinks: - /actions/guides/about-packaging-with-github-actions - /actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting guideCards: - - /actions/guides/setting-up-continuous-integration-using-workflow-templates + - /actions/learn-github-actions/using-starter-workflows - /actions/guides/publishing-nodejs-packages - /actions/guides/building-and-testing-powershell popular: diff --git a/content/actions/learn-github-actions/creating-starter-workflows-for-your-organization.md b/content/actions/learn-github-actions/creating-starter-workflows-for-your-organization.md new file mode 100644 index 0000000000..4be314080b --- /dev/null +++ b/content/actions/learn-github-actions/creating-starter-workflows-for-your-organization.md @@ -0,0 +1,99 @@ +--- +title: Creating starter workflows for your organization +shortTitle: Creating starter workflows +intro: Learn how you can create starter workflows to help people in your team add new workflows more easily. +redirect_from: + - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization + - /actions/learn-github-actions/creating-workflow-templates +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +type: tutorial +topics: + - Workflows + - CI +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +## Overview + +{% data reusables.actions.workflow-organization-templates %} + +## Creating a starter workflow + +Starter workflows can be created by users with write access to the organization's `.github` repository. These can then be used by organization members who have permission to create workflows. + +{% ifversion fpt %} +Starter workflows created by users can only be used to create workflows in public repositories. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use starter workflows to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/learn-github-actions/creating-starter-workflows-for-your-organization). +{% endif %} + +{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} +{% note %} + +**Note:** To avoid duplication among starter workflows you can call reusable workflows from within a workflow. This can help make your workflows easier to maintain. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." + +{% endnote %} +{% endif %} + +This procedure demonstrates how to create a starter workflow and metadata file. The metadata file describes how the starter workflows will be presented to users when they are creating a new workflow. + +1. If it doesn't already exist, create a new public repository named `.github` in your organization. +2. Create a directory named `workflow-templates`. +3. Create your new workflow file inside the `workflow-templates` directory. + + If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created the placeholder will be automatically replaced with the name of the repository's default branch. + + For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. + + ```yaml + name: Octo Organization CI + + on: + push: + branches: [ $default-branch ] + pull_request: + branches: [ $default-branch ] + + jobs: + build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v2 + + - name: Run a one-line script + run: echo Hello from Octo Organization + ``` +4. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: + ```yaml + { + "name": "Octo Organization Workflow", + "description": "Octo Organization CI starter workflow.", + "iconName": "example-icon", + "categories": [ + "Go" + ], + "filePatterns": [ + "package.json$", + "^Dockerfile", + ".*\\.md$" + ] + } + ``` + * `name` - **Required.** The name of the workflow. This is displayed in the list of available workflows. + * `description` - **Required.** The description of the workflow. This is displayed in the list of available workflows. + * `iconName` - **Optional.** Specifies an icon for the workflow that's displayed in the list of workflows. The `iconName` must be the name of an SVG file, without the file name extension, stored in the `workflow-templates` directory. For example, an SVG file named `example-icon.svg` is referenced as `example-icon`. + * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available starter workflows for a repository, the workflows that match the identified language for the project are featured more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. + * `filePatterns` - **Optional.** Allows the workflow to be used if the user's repository has a file in its root directory that matches a defined regular expression. + +To add another starter workflow, add your files to the same `workflow-templates` directory. For example: + +![Workflow files](/assets/images/help/images/workflow-template-files.png) + +## Next steps + +To continue learning about {% data variables.product.prodname_actions %}, see "[Using workflow ](/actions/learn-github-actions/using-starter-workflows)." diff --git a/content/actions/learn-github-actions/creating-workflow-templates.md b/content/actions/learn-github-actions/creating-workflow-templates.md deleted file mode 100644 index 3ad83990c7..0000000000 --- a/content/actions/learn-github-actions/creating-workflow-templates.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Creating workflow templates -shortTitle: Creating templates -intro: Learn how you can create workflow templates to help people in your team add new workflows more easily. -redirect_from: - - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## Overview - -{% data reusables.actions.workflow-organization-templates %} - -## Creating a workflow template - -Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. - -{% ifversion fpt %} -Your workflow templates can be used to create workflows in public repositories only. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/learn-github-actions/creating-workflow-templates). -{% endif %} - -{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -{% note %} - -**Note:** To avoid duplication in workflows created from a template you can call reusable workflows from within a workflow template. This can help make your workflows easier to maintain. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." - -{% endnote %} -{% endif %} - -This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. - -1. If it doesn't already exist, create a new public repository named `.github` in your organization. -2. Create a directory named `workflow-templates`. -3. Create your new workflow file inside the `workflow-templates` directory. - - If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. - - For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -4. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. - * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. - * `iconName` - **Optional.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. - * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. - -To add another workflow template, add your files to the same `workflow-templates` directory. For example: - -![Workflow template files](/assets/images/help/images/workflow-template-files.png) - -## Next steps - -To continue learning about {% data variables.product.prodname_actions %}, see "[Using workflow templates](/actions/learn-github-actions/using-workflow-templates)." diff --git a/content/actions/learn-github-actions/index.md b/content/actions/learn-github-actions/index.md index e45322bcff..a6a2c06226 100644 --- a/content/actions/learn-github-actions/index.md +++ b/content/actions/learn-github-actions/index.md @@ -34,8 +34,8 @@ children: - /essential-features-of-github-actions - /managing-complex-workflows - /sharing-workflows-secrets-and-runners-with-your-organization - - /creating-workflow-templates - - /using-workflow-templates + - /creating-starter-workflows-for-your-organization + - /using-starter-workflows - /reusing-workflows - /events-that-trigger-workflows - /expressions diff --git a/content/actions/learn-github-actions/managing-complex-workflows.md b/content/actions/learn-github-actions/managing-complex-workflows.md index e44a1d367c..ed8322bb5a 100644 --- a/content/actions/learn-github-actions/managing-complex-workflows.md +++ b/content/actions/learn-github-actions/managing-complex-workflows.md @@ -170,7 +170,7 @@ To learn more about {% data variables.product.prodname_dotcom %}-hosted runner l You can configure environments with protection rules and secrets. Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. For more information, see "[Using environments for deployment](/actions/deployment/using-environments-for-deployment)." {% endif %} -## Using a workflow template +## Using starter workflows {% data reusables.actions.workflow-template-overview %} @@ -178,7 +178,7 @@ You can configure environments with protection rules and secrets. Each job in a {% data reusables.repositories.actions-tab %} 1. If your repository already has existing workflows: In the upper-left corner, click **New workflow**. ![Create a new workflow](/assets/images/help/repository/actions-new-workflow.png) -1. Under the name of the template you'd like to use, click **Set up this workflow**. +1. Under the name of the starter workflow you'd like to use, click **Set up this workflow**. ![Set up this workflow](/assets/images/help/settings/actions-create-starter-workflow.png) ## Next steps diff --git a/content/actions/learn-github-actions/reusing-workflows.md b/content/actions/learn-github-actions/reusing-workflows.md index 9bf5bb7bdf..33a4d0e6a9 100644 --- a/content/actions/learn-github-actions/reusing-workflows.md +++ b/content/actions/learn-github-actions/reusing-workflows.md @@ -32,11 +32,11 @@ If you reuse a workflow from a different repository, any actions in the called w When a reusable workflow is triggered by a caller workflow, the `github` context is always associated with the caller workflow. The called workflow is automatically granted access to `github.token` and `secrets.GITHUB_TOKEN`. For more information about the `github` context, see "[Context and expression syntax for GitHub Actions](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)." -### Reusable workflows and workflow templates +### Reusable workflows and starter workflow -Workflow templates allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When people create a new workflow, they can choose a template and some or all of the work of writing the workflow will be done for them. Inside workflow templates, you can also reference reusable workflows to make it easy for people to benefit from reusing centrally managed workflow code. If you use a tag or branch name when referencing the reusable workflow then you can ensure that everyone who reuses that workflow will always be using the same YAML code. However, if you reference a reusable workflow by a tag or branch, be sure that you can trust that version of the workflow. For more information, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/security-guides/security-hardening-for-github-actions#reusing-third-party-workflows)." +Starter workflow allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When people create a new workflow, they can choose a starter workflow and some or all of the work of writing the workflow will be done for them. Inside starter workflow, you can also reference reusable workflows to make it easy for people to benefit from reusing centrally managed workflow code. If you use a tag or branch name when referencing the reusable workflow then you can ensure that everyone who reuses that workflow will always be using the same YAML code. However, if you reference a reusable workflow by a tag or branch, be sure that you can trust that version of the workflow. For more information, see "[Security hardening for {% data variables.product.prodname_actions %}](/actions/security-guides/security-hardening-for-github-actions#reusing-third-party-workflows)." -For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." +For more information, see "[Creating starter workflows for your organization](/actions/learn-github-actions/creating-starter-workflows-for-your-organization)." ## Access to reusable workflows diff --git a/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md b/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md index f48ee6acd8..7ce98f5613 100644 --- a/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md +++ b/content/actions/learn-github-actions/sharing-workflows-secrets-and-runners-with-your-organization.md @@ -1,7 +1,7 @@ --- title: 'Sharing workflows, secrets, and runners with your organization' shortTitle: Sharing workflows with your organization -intro: 'Learn how you can use organization features to collaborate with your team, by sharing workflow templates, secrets, and self-hosted runners.' +intro: 'Learn how you can use organization features to collaborate with your team, by sharing starter workflow, secrets, and self-hosted runners.' redirect_from: - /actions/learn-github-actions/sharing-workflows-with-your-organization versions: @@ -17,11 +17,11 @@ type: how_to ## Overview -If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and manage secrets, artifacts, and self-hosted runners. You can also create workflow templates in the `.github` repository and share them with other users in your organization. +If you need to share workflows and other {% data variables.product.prodname_actions %} features with your team, then consider collaborating within a {% data variables.product.prodname_dotcom %} organization. An organization allows you to centrally store and manage secrets, artifacts, and self-hosted runners. You can also create starter workflow in the `.github` repository and share them with other users in your organization. -## Using workflow templates +## Using starter workflows -{% data reusables.actions.workflow-organization-templates %} For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." +{% data reusables.actions.workflow-organization-templates %} For more information, see "[Creating starter workflows for your organization](/actions/learn-github-actions/creating-starter-workflows-for-your-organization)." {% data reusables.actions.reusable-workflows %} @@ -51,4 +51,4 @@ For more information, see "[Managing access to self-hosted runners using groups] ## Next steps -To continue learning about {% data variables.product.prodname_actions %}, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." +To continue learning about {% data variables.product.prodname_actions %}, see "[Creating starter workflows for your organization](/actions/learn-github-actions/creating-starter-workflows-for-your-organization)." diff --git a/content/actions/learn-github-actions/using-starter-workflows.md b/content/actions/learn-github-actions/using-starter-workflows.md new file mode 100644 index 0000000000..9af782bd97 --- /dev/null +++ b/content/actions/learn-github-actions/using-starter-workflows.md @@ -0,0 +1,54 @@ +--- +title: Using starter workflows +intro: '{% data variables.product.product_name %} provides starter workflows for a variety of languages and tooling.' +redirect_from: + - /articles/setting-up-continuous-integration-using-github-actions + - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions + - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions + - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions + - /actions/guides/setting-up-continuous-integration-using-workflow-templates + - /actions/learn-github-actions/using-workflow-templates +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +type: tutorial +topics: + - Workflows + - CI + - CD +--- + +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} + +## About starter workflows + +{% data variables.product.product_name %} offers starter workflows for a variety of languages and tooling. When you set up workflows in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a starter workflow file that installs your Node.js packages and runs your tests.{% if actions-starter-template-ui %} You can search and filter to find relevant starter workflows.{% endif %} + +You can also create your own starter workflow to share with your organization. These starter workflows will appear alongside the {% data variables.product.product_name %}-provided starter workflows. For more information, see "[Creating starter workflows for your organization](/actions/learn-github-actions/creating-starter-workflows-for-your-organization)." + +## Using starter workflows + +Anyone with write permission to a repository can set up {% data variables.product.prodname_actions %} starter workflows for CI/CD or other automation. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. If you already have a workflow in your repository, click **New workflow**. +1. Find the starter workflow that you want to use, then click **Set up this workflow**.{% if actions-starter-template-ui %} To help you find the starter workflow that you want, you can search for keywords or filter by category.{% endif %} +1. If the starter workflow contains comments detailing additional setup steps, follow these steps. Many of the starter workflow have corresponding guides. For more information, see [the {% data variables.product.prodname_actions %} guides](/actions/guides)." +1. Some starter workflows use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the starter workflow uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." +1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs. +1. Click **Start commit**. +1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request. + +## Further reading + +- "[About continuous integration](/articles/about-continuous-integration)" +- "[Managing workflow runs](/actions/managing-workflow-runs)" +- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)" +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" +{% ifversion fpt or ghec %} +- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" +{% endif %} diff --git a/content/actions/learn-github-actions/using-workflow-templates.md b/content/actions/learn-github-actions/using-workflow-templates.md deleted file mode 100644 index f7685fa3f0..0000000000 --- a/content/actions/learn-github-actions/using-workflow-templates.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Using workflow templates -shortTitle: Using templates -intro: '{% data variables.product.product_name %} provides workflow templates for a variety of languages and tooling.' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions - - /actions/guides/setting-up-continuous-integration-using-workflow-templates -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI - - CD ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## About workflow templates - -{% data variables.product.product_name %} offers workflow templates for a variety of languages and tooling. When you set up workflows in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests.{% if actions-starter-template-ui %} You can search and filter to find relevant workflow templates.{% endif %} - -You can also create your own workflow templates to share with your organization. These templates will appear alongside the {% data variables.product.product_name %} workflow templates. For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." - -## Using workflow templates - -Anyone with write permission to a repository can set up {% data variables.product.prodname_actions %} workflows for CI/CD or other automation. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. If you already have a workflow in your repository, click **New workflow**. -1. Find the template that you want to use, then click **Set up this workflow**.{% if actions-starter-template-ui %} To help you find the template that you want, you can search for keywords or filter by category.{% endif %} -1. If the workflow template contains comments detailing additional setup steps, follow these steps. Many of the templates have corresponding guides. For more information, see [the {% data variables.product.prodname_actions %} guides](/actions/guides)." -1. Some workflow templates use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the workflow template uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." -1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs. -1. Click **Start commit**. -1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request. - -## Further reading - -- "[About continuous integration](/articles/about-continuous-integration)" -- "[Managing workflow runs](/actions/managing-workflow-runs)" -- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)" -- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" -{% ifversion fpt or ghec %} -- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" -{% endif %} diff --git a/content/actions/quickstart.md b/content/actions/quickstart.md index 38bf3fdf13..28d20b78f7 100644 --- a/content/actions/quickstart.md +++ b/content/actions/quickstart.md @@ -76,7 +76,7 @@ Committing the workflow file to a branch in your repository triggers the `push` For example, you can see the list of files in your repository: ![Example action detail](/assets/images/help/repository/actions-quickstart-log-detail.png) -## More workflow templates +## More starter workflows {% data reusables.actions.workflow-template-overview %} diff --git a/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md b/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md index 6114f313f6..4d3112bf29 100644 --- a/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md +++ b/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise.md @@ -72,7 +72,7 @@ Think about how your enterprise can use features of {% data variables.product.pr With reusable workflows, your team can call one workflow from another workflow, avoiding exact duplication. Reusable workflows promote best practice by helping your team use workflows that are well designed and have already been tested. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." {% endif %} -To provide a starting place for developers building new workflows, you can use workflow templates. This not only saves time for your developers, but promotes consistency and best practice across your enterprise. For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." +To provide a starting place for developers building new workflows, you can use starter workflows. This not only saves time for your developers, but promotes consistency and best practice across your enterprise. For more information, see "[Creating starter workflows for your organization](/actions/learn-github-actions/creating-starter-workflows-for-your-organization)." Whenever your workflow developers want to use an action that's stored in a private repository, they must configure the workflow to clone the repository first. To reduce the number of repositories that must be cloned, consider grouping commonly used actions in a single repository. For more information, see "[About custom actions](/actions/creating-actions/about-custom-actions#choosing-a-location-for-your-action)." diff --git a/content/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace.md b/content/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace.md new file mode 100644 index 0000000000..1eb32e030f --- /dev/null +++ b/content/codespaces/developing-in-codespaces/default-environment-variables-for-your-codespace.md @@ -0,0 +1,40 @@ +--- +title: Default environment variables for your codespace +shortTitle: Default environment variables +product: '{% data reusables.gated-features.codespaces %}' +permissions: '{% data reusables.codespaces.availability %}' +intro: '{% data variables.product.prodname_dotcom %} sets default environment variables for each codespace.' +versions: + fpt: '*' + ghec: '*' +type: overview +topics: + - Codespaces + - Fundamentals + - Developer +--- + +## About default environment variables + +{% data variables.product.prodname_dotcom %} sets default environment variables for every codespace. Commands run in codespaces can create, read, and modify environment variables. + +{% note %} + +**Note**: Environment variables are case-sensitive. + +{% endnote %} + +## List of default environment variables + +| Environment variable | Description | +| ---------------------|------------ | +| `CODESPACE_NAME` | The name of the codespace For example, `monalisa-github-hello-world-2f2fsdf2e` | +| `CODESPACES` | Always `true` while in a codespace | +| `GIT_COMMITTER_EMAIL` | The email for the "author" field of future `git` commits. | +| `GIT_COMMITTER_NAME` | The name for the "committer" field of future `git` commits. | +| `GITHUB_API_URL` | Returns the API URL. For example, `{% data variables.product.api_url_code %}`. | +| `GITHUB_GRAPHQL_URL` | Returns the GraphQL API URL. For example, `{% data variables.product.graphql_url_code %}`. | +| `GITHUB_REPOSITORY` | The owner and repository name. For example, `octocat/Hello-World`. | +| `GITHUB_SERVER_URL`| Returns the URL of the {% data variables.product.product_name %} server. For example, `https://{% data variables.product.product_url %}`. | +| `GITHUB_TOKEN` | A signed auth token representing the user in the codespace. You can use this to make authenticated calls to the GitHub API. For more information, see "[Authentication](/codespaces/codespaces-reference/security-in-codespaces#authentication)." | +| `GITHUB_USER` | The name of the user that initiated the codespace. For example, `octocat`. | \ No newline at end of file diff --git a/content/codespaces/developing-in-codespaces/index.md b/content/codespaces/developing-in-codespaces/index.md index 0558dd88ff..64e671622b 100644 --- a/content/codespaces/developing-in-codespaces/index.md +++ b/content/codespaces/developing-in-codespaces/index.md @@ -15,6 +15,7 @@ children: - /using-codespaces-for-pull-requests - /deleting-a-codespace - /forwarding-ports-in-your-codespace + - /default-environment-variables-for-your-codespace - /connecting-to-a-private-network - /using-codespaces-in-visual-studio-code - /using-codespaces-with-github-cli diff --git a/content/issues/trying-out-the-new-projects-experience/creating-a-project.md b/content/issues/trying-out-the-new-projects-experience/creating-a-project.md index e68a41f2ed..c3e5acb974 100644 --- a/content/issues/trying-out-the-new-projects-experience/creating-a-project.md +++ b/content/issues/trying-out-the-new-projects-experience/creating-a-project.md @@ -82,7 +82,7 @@ You can archive an item to keep the context about the item in the project but re 1. Select the item(s) to archive or delete. To select multiple items, do one of the following: - `cmd + click` (Mac) or `ctrl + click` (Windows/Linux) each item. - - Select an item then `shift + arrow-up` or `shift + arrow-down` to select additional items above or below the intitially selected item. + - Select an item then `shift + arrow-up` or `shift + arrow-down` to select additional items above or below the initially selected item. - Select an item then `shift + click` another item to select all items between the two items. - Enter `cmd + a` (Mac) or `ctrl + a` (Windows/Linux) to select all items in a column in a board layout or all items in a table layout. 2. To archive all selected items, enter `e`. To delete all selected items, enter `del`. Alternatively, select the {% octicon "triangle-down" aria-label="the item menu" %} (in table layout) or the {% octicon "kebab-horizontal" aria-label="the item menu" %} (in board layout), then select the desired action. diff --git a/content/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects.md b/content/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects.md index 07843a55d9..4b00391366 100644 --- a/content/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects.md +++ b/content/issues/trying-out-the-new-projects-experience/using-the-api-to-manage-projects.md @@ -310,7 +310,7 @@ gh api graphql -f query=' ``` {% endcli %} -A project may contain items that a user does not have permission to view. In this case, the response will include redacted item. +A project may contain items that a user does not have permission to view. In this case, the response will include a redacted item. ```shell { @@ -373,7 +373,7 @@ The response will contain the node ID of the newly created item. } ``` -If you try add an item that already exists, the existing item ID is returned instead. +If you try to add an item that already exists, the existing item ID is returned instead. ### Updating a custom text, number, or date field diff --git a/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md b/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md index a996ed33d9..d8e0ad69f7 100644 --- a/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md +++ b/content/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https.md @@ -37,6 +37,12 @@ All {% data variables.product.prodname_pages %} sites, including sites that are 3. Under "{% data variables.product.prodname_pages %}," select **Enforce HTTPS**. ![Enforce HTTPS checkbox](/assets/images/help/pages/enforce-https-checkbox.png) +## Troubleshooting certificate provisioning ("Certificate not yet created" error") + +When you set or change your custom domain in the Pages settings, an automatic DNS check begins. This check determines if your DNS settings are configured to allow {% data variables.product.prodname_dotcom %} to obtain a certificate automatically. If the check is successful, {% data variables.product.prodname_dotcom %} queues a job to request a TLS certificate from [Let's Encrypt](https://letsencrypt.org/). On receiving receiving a valid certificate, {% data variables.product.prodname_dotcom %} automatically uploads it to the servers that handle TLS termination for Pages. When this process completes successfully, a check mark is displayed beside your custom domain name. + +The process may take some time. If the process has not completed several minutes after you clicked **Save**, try clicking **Remove** next to your custom domain name. Retype the domain name and click **Save** again. This will cancel and restart the provisioning process. + ## Resolving problems with mixed content If you enable HTTPS for your {% data variables.product.prodname_pages %} site but your site's HTML still references images, CSS, or JavaScript over HTTP, then your site is serving *mixed content*. Serving mixed content may make your site less secure and cause trouble loading assets. diff --git a/data/reusables/actions/cd-templates-actions.md b/data/reusables/actions/cd-templates-actions.md index 8bc2c82226..7bc93daf9a 100644 --- a/data/reusables/actions/cd-templates-actions.md +++ b/data/reusables/actions/cd-templates-actions.md @@ -1,3 +1,3 @@ -{% data variables.product.product_name %} offers CD workflow templates for several popular services, such as Azure Web App. To learn how to get started using a workflow template, see "[Using workflow templates](/actions/learn-github-actions/using-workflow-templates)" or [browse the full list of deployment workflow templates](https://github.com/actions/starter-workflows/tree/main/deployments). You can also check out our more detailed guides for specific deployment workflows, such as "[Deploying to Azure App Service](/actions/deployment/deploying-to-azure-app-service)." +{% data variables.product.product_name %} offers CD starter workflow for several popular services, such as Azure Web App. To learn how to get started using a starter workflow, see "[Using starter workflows](/actions/learn-github-actions/using-starter-workflows)" or [browse the full list of deployment starter workflows](https://github.com/actions/starter-workflows/tree/main/deployments). You can also check out our more detailed guides for specific deployment workflows, such as "[Deploying to Azure App Service](/actions/deployment/deploying-to-azure-app-service)." Many service providers also offer actions on {% data variables.product.prodname_marketplace %} for deploying to their service. For the full list, see [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace?category=deployment&type=actions). diff --git a/data/reusables/actions/workflow-organization-templates.md b/data/reusables/actions/workflow-organization-templates.md index c1a9412f34..0dc4dc05b0 100644 --- a/data/reusables/actions/workflow-organization-templates.md +++ b/data/reusables/actions/workflow-organization-templates.md @@ -1 +1 @@ -Workflow templates allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When you create a new workflow, you can choose a template and some or all of the work of writing the workflow will be done for you. You can use workflow templates as a starting place to build your custom workflow or use them as-is. This not only saves time, it promotes consistency and best practice across your organization. +Starter workflows allow everyone in your organization who has permission to create workflows to do so more quickly and easily. When you create a new workflow, you can choose a starter workflow and some or all of the work of writing the workflow will be done for you. You can use starter workflows as a starting place to build your custom workflow or use them as-is. This not only saves time, it promotes consistency and best practice across your organization. diff --git a/data/reusables/actions/workflow-template-overview.md b/data/reusables/actions/workflow-template-overview.md index 88eff614a2..bf926adfc4 100644 --- a/data/reusables/actions/workflow-template-overview.md +++ b/data/reusables/actions/workflow-template-overview.md @@ -1,3 +1,3 @@ -{% data variables.product.prodname_dotcom %} provides preconfigured workflow templates that you can customize to create your own continuous integration workflow. {% data variables.product.product_name %} analyzes your code and shows you CI templates that might be useful for your repository. For example, if your repository contains Node.js code, you'll see suggestions for Node.js projects. You can use workflow templates as a starting place to build your custom workflow or use them as-is. +{% data variables.product.prodname_dotcom %} provides preconfigured starter workflow that you can customize to create your own continuous integration workflow. {% data variables.product.product_name %} analyzes your code and shows you CI starter workflow that might be useful for your repository. For example, if your repository contains Node.js code, you'll see suggestions for Node.js projects. You can use starter workflow as a starting place to build your custom workflow or use them as-is. -You can browse the full list of workflow templates in the {% ifversion fpt or ghec %}[actions/starter-workflows](https://github.com/actions/starter-workflows) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}. +You can browse the full list of starter workflow in the {% ifversion fpt or ghec %}[actions/starter-workflows](https://github.com/actions/starter-workflows) repository{% else %} `actions/starter-workflows` repository on {% data variables.product.product_location %}{% endif %}. diff --git a/data/reusables/github-actions/example-github-runner.md b/data/reusables/github-actions/example-github-runner.md index be49136efd..f4da555d66 100644 --- a/data/reusables/github-actions/example-github-runner.md +++ b/data/reusables/github-actions/example-github-runner.md @@ -1,6 +1,6 @@ ### Running on a different operating system -The starter workflow template configures jobs to run on Linux, using the {% data variables.product.prodname_dotcom %}-hosted `ubuntu-latest` runners. You can change the `runs-on` key to run your jobs on a different operating system. For example, you can use the {% data variables.product.prodname_dotcom %}-hosted Windows runners. +The starter workflow configures jobs to run on Linux, using the {% data variables.product.prodname_dotcom %}-hosted `ubuntu-latest` runners. You can change the `runs-on` key to run your jobs on a different operating system. For example, you can use the {% data variables.product.prodname_dotcom %}-hosted Windows runners. {% raw %} ```yaml diff --git a/data/reusables/github-actions/java-jvm-architecture.md b/data/reusables/github-actions/java-jvm-architecture.md index 2814ee964b..bffbb05631 100644 --- a/data/reusables/github-actions/java-jvm-architecture.md +++ b/data/reusables/github-actions/java-jvm-architecture.md @@ -1,6 +1,6 @@ ### Specifying the JVM version and architecture -The starter workflow template sets up the `PATH` to contain OpenJDK 8 for the x64 platform. If you want to use a different version of Java, or target a different architecture (`x64` or `x86`), you can use the `setup-java` action to choose a different Java runtime environment. +The starter workflow sets up the `PATH` to contain OpenJDK 8 for the x64 platform. If you want to use a different version of Java, or target a different architecture (`x64` or `x86`), you can use the `setup-java` action to choose a different Java runtime environment. For example, to use version 11 of the JDK provided by Adoptium for the x64 platform, you can use the `setup-java` action and configure the `java-version`, `distribution` and `architecture` parameters to `'11'`, `'adopt'` and `x64`. diff --git a/lib/search/indexes/github-docs-3.0-cn-records.json.br b/lib/search/indexes/github-docs-3.0-cn-records.json.br index fb92f33bde..c9361ef0c2 100644 --- 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:ba63424e655241e3e38a94f420a78ed7f0ee78902a508917105502de57ec0a26 -size 614834 +oid sha256:c45b5dd0cc71b1008eb4a8095d88680df328beb85b64ddef63992ded71cc82d7 +size 615474 diff --git a/lib/search/indexes/github-docs-3.0-cn.json.br b/lib/search/indexes/github-docs-3.0-cn.json.br index 5f08f783dd..975d48ccd3 100644 --- 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:5b6894ed341431b032b7764dac182dde1490b9fd830fb41e8257d04aac676697 -size 1749146 +oid sha256:1c0a1e1c8f09f6c03f5ecbed5a8221f320a7823ba8c25da0e80e75cc8ac63397 +size 1751683 diff --git a/lib/search/indexes/github-docs-3.0-en-records.json.br b/lib/search/indexes/github-docs-3.0-en-records.json.br index c168da0715..c4e31f2d30 100644 --- 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:6bfe12a26bce84b7e842f1f3e78c3c84cb9747f739d7f01b069268aa571c90d2 -size 952415 +oid sha256:bd178ebc0adeae783df0f2d75296a7ae0f07cc885a0c57ccd54147a91f74bd2a +size 952926 diff --git a/lib/search/indexes/github-docs-3.0-en.json.br b/lib/search/indexes/github-docs-3.0-en.json.br index d6b73fc49a..404bd77966 100644 --- 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:f7d73076b1fbe3ac0d253b20f1371b8a1061912e7ccce6885758aa5b143df9c5 -size 3902998 +oid sha256:4495cd73cc0ead97b9a14e362154702b5bd84d378e02598e1b7cf05892173aaf +size 3906962 diff --git a/lib/search/indexes/github-docs-3.0-es-records.json.br b/lib/search/indexes/github-docs-3.0-es-records.json.br index 4bf55361c4..aab83dcb63 100644 --- 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:0ae7fab9b21abab9422091684e726ec64be53a5a614dd9c74cc434674f57de16 -size 584247 +oid sha256:840ebd46f6e647efdbeb9b0fdc8246a232922f6aa7b47c13baecd63d1b4fe23a +size 584605 diff --git a/lib/search/indexes/github-docs-3.0-es.json.br b/lib/search/indexes/github-docs-3.0-es.json.br index 96c1aaa371..5734feacae 100644 --- 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:30c1e134cb77c95e697a34ec7a01780ee4859030af0ef3037cd05b198ad3b7e5 -size 2703527 +oid sha256:88b4c3414f93d1fe9b21e63ed6ceccec3b7bc639a09f2109646a8d87353c89fd +size 2703155 diff --git a/lib/search/indexes/github-docs-3.0-ja-records.json.br b/lib/search/indexes/github-docs-3.0-ja-records.json.br index d50c0e9502..404f305ad1 100644 --- 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:bd986a35943bb3154c74899988fca3b2a346b00bef9d93e857baf60f4fc0c698 -size 616512 +oid sha256:b53a068b8040866332a466e2fd1f6f250636e20cecf7ee0bff5961623e68f921 +size 618723 diff --git a/lib/search/indexes/github-docs-3.0-ja.json.br b/lib/search/indexes/github-docs-3.0-ja.json.br index 7273b2c91f..e482c724aa 100644 --- 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:9197ca861f357cf5f7ab6038f08261afe185df7881d460911df22604aa461358 -size 3419595 +oid sha256:21e5cc4b33e5be40bfb9cc7bcb846d5b8cc16f9210766ac039d40c58c2187e4b +size 3476256 diff --git a/lib/search/indexes/github-docs-3.0-pt-records.json.br b/lib/search/indexes/github-docs-3.0-pt-records.json.br index 2a94b6422e..227a9a7ce9 100644 --- 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:458a67ebc297b81314aff1f00b64153917abe9cb8e36feb5fd7b094991555185 -size 596350 +oid sha256:f24b3ca528d17890e1500dd60771c7fee1afeb942030d4d4a7a0b0fb09ac074f +size 596532 diff --git a/lib/search/indexes/github-docs-3.0-pt.json.br b/lib/search/indexes/github-docs-3.0-pt.json.br index 16e6f877cc..d38323cb89 100644 --- 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:897a6d997b1956da8d063e6b9f59bae9718d36aebb34df25627481219c8669c3 -size 2807774 +oid sha256:cbc3ab95ea5cd4b62be8b9657966c51888ea645e0b1f8fb4c1d57517cf871dc9 +size 2811397 diff --git a/lib/search/indexes/github-docs-3.1-cn-records.json.br b/lib/search/indexes/github-docs-3.1-cn-records.json.br index 7c74db5d98..259100876c 100644 --- 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:f7d8dafd4a6a81fac52ccb371492d0855e7229d5b972c6c7812dbdf27f320c18 -size 628183 +oid sha256:da668cfe259887b7af9ecea33e280db7e84dfdaf5ceda11fb53832a57414d81b +size 628876 diff --git a/lib/search/indexes/github-docs-3.1-cn.json.br b/lib/search/indexes/github-docs-3.1-cn.json.br index 1f8eab2ed8..b176fc7e4e 100644 --- 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:25c50ae009018dc7ca124e15b64b960038dfa93f39d624d0f99bd1fefa8573d7 -size 1790305 +oid sha256:1b9dc17d50a6f205391e1072b8ba3a193b49f405972f2f51909546e9b1944a95 +size 1792888 diff --git a/lib/search/indexes/github-docs-3.1-en-records.json.br b/lib/search/indexes/github-docs-3.1-en-records.json.br index 830ca46117..60c48bc9a3 100644 --- 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:761d1f757aa89f988e1be85e74d48a09b6ae6076dfb12d3fa94baf95b3cf2d34 -size 977133 +oid sha256:b1fc57998661b06f817e9df91015827c9c08438f3345080b9d4d8e00794e489f +size 977958 diff --git a/lib/search/indexes/github-docs-3.1-en.json.br b/lib/search/indexes/github-docs-3.1-en.json.br index 7d2f0e9726..098419e1a4 100644 --- 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:8a81c697cf9d75ed7665f7a47335b30a8664cbab16e681093639c17437abbafa -size 3995535 +oid sha256:9d3726307fe46c5239e3584c4c561d790ca05b417864ee7b8d4b1ab34c464fb1 +size 3997315 diff --git a/lib/search/indexes/github-docs-3.1-es-records.json.br b/lib/search/indexes/github-docs-3.1-es-records.json.br index 83b1c42138..1cafd32d1c 100644 --- 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:bf65498813a28240a8bf3e13aef7ecbd698bd4f05705ca4cb4c107ab0361b869 -size 596585 +oid sha256:a38e198dec7d9777e62f802309fe37784ab18e145e03832be5647e0ed5b1866a +size 596635 diff --git a/lib/search/indexes/github-docs-3.1-es.json.br b/lib/search/indexes/github-docs-3.1-es.json.br index d3d783ddb7..f4c4e20d58 100644 --- 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:fc001ee9a46277f7b933e4db449a4972cb2772d909831f759a84a8a88a26544c -size 2766592 +oid sha256:5229af510d576887b3717267866f8fc2997a57513cd8c6b250c19cd4104b974d +size 2766737 diff --git a/lib/search/indexes/github-docs-3.1-ja-records.json.br b/lib/search/indexes/github-docs-3.1-ja-records.json.br index a596775d86..298ff9fbce 100644 --- 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:1feb8f4e9bde9e05b42da9ee62a6a74509538d7c6deb8e2c652eecd13aaf93d0 -size 629996 +oid sha256:dc034ea5e62ef6df29d9347e6a1495464cab5a6b8688ca465c2cb43107f68abd +size 632068 diff --git a/lib/search/indexes/github-docs-3.1-ja.json.br b/lib/search/indexes/github-docs-3.1-ja.json.br index 1122c0932d..1499adef09 100644 --- 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:62ca153865f594c853a8b0a543aa0c40d0184225f31b66f9ace5b882157073c3 -size 3496641 +oid sha256:23d6523b0738686505b761f13453d7767a77b4158f14155ba223fa24d86f0147 +size 3555138 diff --git a/lib/search/indexes/github-docs-3.1-pt-records.json.br b/lib/search/indexes/github-docs-3.1-pt-records.json.br index f8a146dbdc..6bf3a9a8e0 100644 --- 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:eab5a54c613e91d5b64dc8e2bbb7cac301558a9c162186082fba76a8c3bd7722 -size 608496 +oid sha256:b59f762d340672990b340211dffcc699931544eee7fa1345c8a149758741d337 +size 608984 diff --git a/lib/search/indexes/github-docs-3.1-pt.json.br b/lib/search/indexes/github-docs-3.1-pt.json.br index aeb51945ae..48710acc28 100644 --- 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:2eb0babfc7f2e7e42b5387f475c08e2353c8bf6987eeb514d4e51d87dc94ffe6 -size 2870208 +oid sha256:c57bc3e8e9d50c9ba1a8a2e64b2e63c8a598e4082313508de1094f933b79ac68 +size 2875290 diff --git a/lib/search/indexes/github-docs-3.2-cn-records.json.br b/lib/search/indexes/github-docs-3.2-cn-records.json.br index 64ff3a4b2d..ed90bf6ee5 100644 --- 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:e7173b959f159911f7e5d2f31536e3d6e3904fa8e2b8daea8cf2280c70e18021 -size 639648 +oid sha256:0a882d77b62d642db501fe271772c56bea657adefc628dbcd5983f0d948488aa +size 640166 diff --git a/lib/search/indexes/github-docs-3.2-cn.json.br b/lib/search/indexes/github-docs-3.2-cn.json.br index a18f20c616..1966168b73 100644 --- 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:e4f0e3a05b44d6606b8c4facde5289d9942e63b7d852345fa12b3948a37d6377 -size 1817938 +oid sha256:d5e8697d95b61c12feec4fb6b47db17828097e427dae19f98a93efb9fae25c26 +size 1819679 diff --git a/lib/search/indexes/github-docs-3.2-en-records.json.br b/lib/search/indexes/github-docs-3.2-en-records.json.br index 50ab0de882..f35faa3d3b 100644 --- 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:a0d87166a2a6a752d26f51690facd303ef9d68f15ed0edf388394bbb9642b256 -size 1008114 +oid sha256:745fa8d2473cc9fb39ef398b0168decaef47571fdcc35d9cb70f3d65545e3bf6 +size 1008925 diff --git a/lib/search/indexes/github-docs-3.2-en.json.br b/lib/search/indexes/github-docs-3.2-en.json.br index 2aa4adbc5d..7d21a93472 100644 --- 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:0ae6485df2a47d5f18557e5c7d8d4c1559581482b3d7a571ffe97b4f448dc51f -size 4116233 +oid sha256:6e4b777715092d7d35ace264b14a5fc254ad43969d8402e543e38f55bcf3bab3 +size 4120222 diff --git a/lib/search/indexes/github-docs-3.2-es-records.json.br b/lib/search/indexes/github-docs-3.2-es-records.json.br index 6a57f93a8b..1cf3166291 100644 --- 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:1270223a589aba5821d768e20e7cfaacb649ba7560d930f4cf5a3b372f97e7d4 -size 606885 +oid sha256:c66b9ef8ffd1117af2378add9dfa2f5fc751dfa307ce075122c89e26fd8db9ee +size 607090 diff --git a/lib/search/indexes/github-docs-3.2-es.json.br b/lib/search/indexes/github-docs-3.2-es.json.br index 75b341b6b4..cfda76f3ea 100644 --- 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:cbbe2c2b79814892c5392f7ba76342029eb03ff5c33ea08917d26f491d34dba9 -size 2821528 +oid sha256:73dad5abe189260649e97a27aae869a1f3ff8d37d55fa160cffe565166a6c9b0 +size 2821599 diff --git a/lib/search/indexes/github-docs-3.2-ja-records.json.br b/lib/search/indexes/github-docs-3.2-ja-records.json.br index 22b892b2de..26aa0869bf 100644 --- 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:fbc5164d6b9076480409a5aa8cad1828acf8ef06b62989fcf77ede0982b0c9ec -size 641656 +oid sha256:c89ebdfef90b9747ed76d88a526f71126f833768289c66d9fd23e8ad2edfa92f +size 643544 diff --git a/lib/search/indexes/github-docs-3.2-ja.json.br b/lib/search/indexes/github-docs-3.2-ja.json.br index 628e6d1752..41de86525c 100644 --- 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:a2d4bd6e4d19ce02c6b07269bf060f75325dc601ce68a14faf98df830e8fd7dc -size 3564053 +oid sha256:e335d9bbc5cc236a13159e6b05a4fcf891801fcad7258f9932f3050c0b220fbd +size 3622460 diff --git a/lib/search/indexes/github-docs-3.2-pt-records.json.br b/lib/search/indexes/github-docs-3.2-pt-records.json.br index 30da42187d..6cf9d561cb 100644 --- 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:e7d6668cf8968acd48ce81a7d816db15e5d76c0efcaf4f8562d3987ff1aafa96 -size 620039 +oid sha256:8b1c9a3fce256cbba714806bdffb05c9b2cf5567eff6ecc97e2814c59c6365cd +size 620319 diff --git a/lib/search/indexes/github-docs-3.2-pt.json.br b/lib/search/indexes/github-docs-3.2-pt.json.br index b30aeeb4d3..c49b61b97f 100644 --- 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:5b36de2bbbd214a92233cbeee774591d1204d3b3efb87194180e7ed7f8983c9e -size 2920246 +oid sha256:fc8d57e72e1c4b835fa4163a2ae8fb30ad0d5780bd9a306f124a09a809de6e17 +size 2924448 diff --git a/lib/search/indexes/github-docs-3.3-cn-records.json.br b/lib/search/indexes/github-docs-3.3-cn-records.json.br index 019f9705bd..d4d3e49bf8 100644 --- a/lib/search/indexes/github-docs-3.3-cn-records.json.br +++ b/lib/search/indexes/github-docs-3.3-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6c27842e019ffca682d313fe6e31af80806c00344c3570ddf8731679993b16b7 -size 660046 +oid sha256:cce3cb66fce26748cef0bc020746a51186e748e62807f9d51b52cf211a4047e7 +size 660673 diff --git a/lib/search/indexes/github-docs-3.3-cn.json.br b/lib/search/indexes/github-docs-3.3-cn.json.br index 3096d707c6..f23d283c8c 100644 --- a/lib/search/indexes/github-docs-3.3-cn.json.br +++ b/lib/search/indexes/github-docs-3.3-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:ec7a35f2efc1395da4cfb334101b003e0807832fddac20b48b110a12c1963ce3 -size 1874723 +oid sha256:1ed968e480f885c77d1f62fb35cbe6ae50317e0e59bb26d09aa425d158741a69 +size 1876950 diff --git a/lib/search/indexes/github-docs-3.3-en-records.json.br b/lib/search/indexes/github-docs-3.3-en-records.json.br index ff7d26d4e4..1c22d3a6ee 100644 --- a/lib/search/indexes/github-docs-3.3-en-records.json.br +++ b/lib/search/indexes/github-docs-3.3-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:912b4120b4bcae806200e913fba26bbe72f8b9d5260a49af3727c5ae20c3dbc9 -size 1042421 +oid sha256:c216bad4df15954a7b719ae6a84a0141c3ed7ad5cdb142d6292cabd2d8414857 +size 1043131 diff --git a/lib/search/indexes/github-docs-3.3-en.json.br b/lib/search/indexes/github-docs-3.3-en.json.br index 5d9f58a142..5100df7fff 100644 --- a/lib/search/indexes/github-docs-3.3-en.json.br +++ b/lib/search/indexes/github-docs-3.3-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6dbccafc1cdb53cc594a4bc82dc39c16480b4227c3364373389f3ce86ccc4942 -size 4216977 +oid sha256:febf26f7686cc5678a77c8a0ea8fab942e29a9033563aa3db9c3b96748989f37 +size 4222148 diff --git a/lib/search/indexes/github-docs-3.3-es-records.json.br b/lib/search/indexes/github-docs-3.3-es-records.json.br index 13553985f5..8e89d43e5e 100644 --- a/lib/search/indexes/github-docs-3.3-es-records.json.br +++ b/lib/search/indexes/github-docs-3.3-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:bdf94e1cc477c70c17641340462446694d39e251db0e37a89aa4a0bf79cec87a -size 625350 +oid sha256:d543eb98245d449a2417a1b950529d13d50d00708f15ef398eadab945c36bdeb +size 625366 diff --git a/lib/search/indexes/github-docs-3.3-es.json.br b/lib/search/indexes/github-docs-3.3-es.json.br index 004faf6ecb..b7c9920bce 100644 --- a/lib/search/indexes/github-docs-3.3-es.json.br +++ b/lib/search/indexes/github-docs-3.3-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:85dcfef9b2fb72df8aaba13709957a21c2dc51f669d2eb1477486ae789f6d3fd -size 2919284 +oid sha256:7c3c4abaa7ee7df30b8cd4e78b58caf3118b4344f92206e386784bc061afe9ba +size 2919324 diff --git a/lib/search/indexes/github-docs-3.3-ja-records.json.br b/lib/search/indexes/github-docs-3.3-ja-records.json.br index 233737ba80..1e2a1e907b 100644 --- a/lib/search/indexes/github-docs-3.3-ja-records.json.br +++ b/lib/search/indexes/github-docs-3.3-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:9b725ee470ade2fdd6308ed38af50f573de870d6e7e35176c2b7ee72e2bbd47d -size 663177 +oid sha256:8fcf38a2e8f6a9440d4c3c8de7597a78af54357ef30e4db77ece4bcc1e523785 +size 665156 diff --git a/lib/search/indexes/github-docs-3.3-ja.json.br b/lib/search/indexes/github-docs-3.3-ja.json.br index 155fb7e7c4..4066eae9e7 100644 --- a/lib/search/indexes/github-docs-3.3-ja.json.br +++ b/lib/search/indexes/github-docs-3.3-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:8caa309f7d6b17fa4784827692de087a17838482d85e5bb4dcab4416f2fd3998 -size 3682194 +oid sha256:2c9555d8c33308e0542edd6a37300418e9f12f2ff8bdd8dc469b03e81413c0b5 +size 3739528 diff --git a/lib/search/indexes/github-docs-3.3-pt-records.json.br b/lib/search/indexes/github-docs-3.3-pt-records.json.br index 36a48a1676..1153bc95ce 100644 --- a/lib/search/indexes/github-docs-3.3-pt-records.json.br +++ b/lib/search/indexes/github-docs-3.3-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:921e51241d43638f61e3682eb63b099eb99dfc2f71e8e9ce9e634f350f0ade69 -size 638966 +oid sha256:a6bbdbf2ff6025b8dd7e860310df22afcda1e24f1c4cc814e000ba4a9e33348c +size 639455 diff --git a/lib/search/indexes/github-docs-3.3-pt.json.br b/lib/search/indexes/github-docs-3.3-pt.json.br index c86c7852a2..ccf78c4102 100644 --- a/lib/search/indexes/github-docs-3.3-pt.json.br +++ b/lib/search/indexes/github-docs-3.3-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:802182fa700c368b9257b8c82cc98fc0c1d564c5ef4a0543bcb649ed5becdc97 -size 3006886 +oid sha256:75924965aad8bc776233fdc002823b33c4195034beea6386185deb604f1a5e93 +size 3011478 diff --git a/lib/search/indexes/github-docs-dotcom-cn-records.json.br b/lib/search/indexes/github-docs-dotcom-cn-records.json.br index 87faaa9ee6..cdcfd75e6b 100644 --- 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:f258b056420f9a4d13e9813d79222d0d8a3f3cb9dcf608b7fde309bd8c4d6ff2 -size 848919 +oid sha256:f545b67edd8edc2af12ae311bca11e42152c4d54dac6a3e443eb5b50eac83e8a +size 849430 diff --git a/lib/search/indexes/github-docs-dotcom-cn.json.br b/lib/search/indexes/github-docs-dotcom-cn.json.br index 6d4af8bc2d..920af7769e 100644 --- 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:46e739db9f648f64949b031cbcc605f74ea5e64159df47a01844fd24449dc3a2 -size 2095635 +oid sha256:8e93ca342828d286ddd8067eddb5cf2a8f5037f6b3e1284b9f7f33c667bd0c2d +size 2097488 diff --git a/lib/search/indexes/github-docs-dotcom-en-records.json.br b/lib/search/indexes/github-docs-dotcom-en-records.json.br index c2152d91c9..b913b1064c 100644 --- 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:a901dd2091e80c2d1cfb9d03916a877e2d830700680887a43885a8a12afe78ff -size 1325379 +oid sha256:e5f9e022bc3cbabf01bf2a18166d3d0eb1a8c18b14ef665bdc204d4921f2c7f1 +size 1326513 diff --git a/lib/search/indexes/github-docs-dotcom-en.json.br b/lib/search/indexes/github-docs-dotcom-en.json.br index d9ead3fc81..2bfe4f6a9b 100644 --- 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:2d04379c75163bcf3c1201f15fad76b79e922fe53ad2e76fb9b395b8b3ba2464 -size 5061693 +oid sha256:4f23788b4c8533d25be65a2bcd9a3f3de4ec45942b1dce3e4998595bc9a8ee0e +size 5066816 diff --git a/lib/search/indexes/github-docs-dotcom-es-records.json.br b/lib/search/indexes/github-docs-dotcom-es-records.json.br index 24ed7c6c02..c01e8f9573 100644 --- 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:c6f0bd9f49a8a5bb4b19fd684a7052adaa2e645d37522ed9e4b2f79e7b06fde8 -size 795993 +oid sha256:3f2756bb3ca8b5f709102386c47d6532faf40d4f4c8024541393ac029b352e62 +size 795812 diff --git a/lib/search/indexes/github-docs-dotcom-es.json.br b/lib/search/indexes/github-docs-dotcom-es.json.br index d339ddfb1b..3941078291 100644 --- 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:86da3e54c226f450c9f369165de9b7a3678cf4b17ba80c33bed2c990ac04e5e0 -size 3504970 +oid sha256:e95eeebeb5261355c32f6a985e1fd921decaa2975ba4f03756eb98b650f33b60 +size 3503520 diff --git a/lib/search/indexes/github-docs-dotcom-ja-records.json.br b/lib/search/indexes/github-docs-dotcom-ja-records.json.br index a59ac9e971..8235ce72c0 100644 --- 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:b51bf0ea6db143ffdfaf65caf528f5a7d85953e72c0d3b87e7953071ef4bd5d1 -size 858793 +oid sha256:d93c6ad1b3b02db08daa6fefd5edf251b494ed77c57a392f7f7995c905a957cb +size 857724 diff --git a/lib/search/indexes/github-docs-dotcom-ja.json.br b/lib/search/indexes/github-docs-dotcom-ja.json.br index 3b2fafdad4..0a47473bd7 100644 --- 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:f3d2aa96eac36f62e7212c0a056f9f942f2dd24f8a4cbceaed20aee569111675 -size 4501082 +oid sha256:f03f7baa2540fe727a177ae6a207fb33be4549110ed9ce6f723767820a8e3c40 +size 4558989 diff --git a/lib/search/indexes/github-docs-dotcom-pt-records.json.br b/lib/search/indexes/github-docs-dotcom-pt-records.json.br index e550e27ed6..dc83d8cb9c 100644 --- 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:e110589a5c62623f24d475c12b12d34bedabd3f240b52eed50222bf496350818 -size 810363 +oid sha256:10eb00d5b6f2afc8ee883893cc6b827673d6fe966e73fe2f287cf46448a9efcc +size 810676 diff --git a/lib/search/indexes/github-docs-dotcom-pt.json.br b/lib/search/indexes/github-docs-dotcom-pt.json.br index 04d3eae4c0..f04d34bf3a 100644 --- 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:a173b2eeb89b33822e4cd59382e7919f16294a0e45d386de51882a56df18625f -size 3594503 +oid sha256:bc8edb1d49109e969de6afa51faecfa7645692557130bb5e5df523020765b580 +size 3599393 diff --git a/lib/search/indexes/github-docs-ghae-cn-records.json.br b/lib/search/indexes/github-docs-ghae-cn-records.json.br index 397caa1e25..1e5ebf038b 100644 --- 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:7e3f857d301d0e9fddd8ba40c6cda80c85c04dc99690a1a1b6428c08b18af028 -size 513586 +oid sha256:5117fbcc79e8c50ffc50a0b6b953b75ef2fd40b40cae11b09b6ab32e0e5488dc +size 514242 diff --git a/lib/search/indexes/github-docs-ghae-cn.json.br b/lib/search/indexes/github-docs-ghae-cn.json.br index f399c1b4ff..a641f55f6b 100644 --- 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:a5eed125fd19a7aee0af16dd7100ca114dd9af84ea3453e0059040ef5144f610 -size 1418187 +oid sha256:8a370e43527f8b0dd318941bcd4868244f6805eb2b9cbfa04af1d974a4c2f47b +size 1420382 diff --git a/lib/search/indexes/github-docs-ghae-en-records.json.br b/lib/search/indexes/github-docs-ghae-en-records.json.br index 7d57ad2e2b..ceaf2065bd 100644 --- 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:92e4919814cb079f58d3b811ac27ba1fb4bba2d64ec35972c95fa1c98c8c2f92 -size 831021 +oid sha256:01e24534ca659d39691bdc94682fe0e3fdebf74dcea4b04541dc236d114813b7 +size 831549 diff --git a/lib/search/indexes/github-docs-ghae-en.json.br b/lib/search/indexes/github-docs-ghae-en.json.br index 3ae6fd6e36..8b2b3ec67c 100644 --- 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:494889641c52116f1220666a4e049c08c1cf76a73ab8cecbd39d25780999018c -size 3335302 +oid sha256:c810adfb9eaa1543e65057be4ec1398c7d1ec2150b9ab542c23ffbb65f57565a +size 3338257 diff --git a/lib/search/indexes/github-docs-ghae-es-records.json.br b/lib/search/indexes/github-docs-ghae-es-records.json.br index 595f07e91c..da96a02bac 100644 --- 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:deb7da7863e054f643676fd77c52bdaea7766962176451783613cba09faf58bb -size 487892 +oid sha256:e3351c8e9749580049ed507751db432309602e9cb8219193e32f7456736a4a32 +size 488081 diff --git a/lib/search/indexes/github-docs-ghae-es.json.br b/lib/search/indexes/github-docs-ghae-es.json.br index 3837986fba..522365349e 100644 --- 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:144030cf95558d36132a35dfd2658180754215c240a89698a295a65043bf61a0 -size 2195501 +oid sha256:245947cb6b51ddb04d1f5490543a1a3f4db0428be177d603d9d24a76a122609e +size 2195968 diff --git a/lib/search/indexes/github-docs-ghae-ja-records.json.br b/lib/search/indexes/github-docs-ghae-ja-records.json.br index 037210f353..a1b028f666 100644 --- 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:7e948a164aa9c58ce3d502deb5d88f4b45c091fb12fb67d44665ff24fa831746 -size 515623 +oid sha256:f9e6a4fc9763aa45e254b6c2706c21cb52d486a1e93c223e204113f9bbe2c4d9 +size 517244 diff --git a/lib/search/indexes/github-docs-ghae-ja.json.br b/lib/search/indexes/github-docs-ghae-ja.json.br index a48972e8d1..7ca0e8c03c 100644 --- 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:f3a3a6890b4017726948ad91a7ae542c09141a56da884105e9fde8e185831ba9 -size 2745977 +oid sha256:d0d06c9a34ed047586afcbc3d1991ec62e274cca9bc496dc63190d52cd0c2233 +size 2802247 diff --git a/lib/search/indexes/github-docs-ghae-pt-records.json.br b/lib/search/indexes/github-docs-ghae-pt-records.json.br index cd08c7d974..1260499a6c 100644 --- 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:cd5000dfc1a3876ffcc8f79da6d3613c95be4bfe68fdde05c25a4e7055b38412 -size 500200 +oid sha256:9ee90809e0f85d69faa5184d2be465912fa2253fb88475d01677181171c7c32c +size 500718 diff --git a/lib/search/indexes/github-docs-ghae-pt.json.br b/lib/search/indexes/github-docs-ghae-pt.json.br index c8c55e40c5..6908866cc5 100644 --- 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:26ca982a44044d8c51cc8d8cb3e605bef90491f06c6dc01fb664f2da141f3b6e -size 2277571 +oid sha256:172c3b44ad07d7932e596cc002ebe6c7bffdfbfb3124d4602ec7ee4febe1fedf +size 2280887 diff --git a/lib/search/indexes/github-docs-ghec-cn-records.json.br b/lib/search/indexes/github-docs-ghec-cn-records.json.br index 722f812ff0..ad7c33967b 100644 --- a/lib/search/indexes/github-docs-ghec-cn-records.json.br +++ b/lib/search/indexes/github-docs-ghec-cn-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:b258af814ba990a63d100b85ab8346a1b0ed28fa11f6f5882bb3f2a0d2650aa6 -size 772820 +oid sha256:3476c9e1de9956fb6cbbc487829c766ee39c1a2cf745fcd800d0d8eed6154f23 +size 773627 diff --git a/lib/search/indexes/github-docs-ghec-cn.json.br b/lib/search/indexes/github-docs-ghec-cn.json.br index 0198d51c40..395722ba3f 100644 --- a/lib/search/indexes/github-docs-ghec-cn.json.br +++ b/lib/search/indexes/github-docs-ghec-cn.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:f5a9aaa4f43cfebffaf1766ca2d99993338e7c3061596115da97cd3719ded5bb -size 2112927 +oid sha256:536a3399cff30b77c6271b92c21fe882a894a85a5f03fc93fb6d18f643aa1f93 +size 2116047 diff --git a/lib/search/indexes/github-docs-ghec-en-records.json.br b/lib/search/indexes/github-docs-ghec-en-records.json.br index 0c3fa705cb..757d1e0d90 100644 --- a/lib/search/indexes/github-docs-ghec-en-records.json.br +++ b/lib/search/indexes/github-docs-ghec-en-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:a6583f2ffc33315f0de687af004f35fd62745564ab8db5d713dfb6ba2709d12e -size 1186399 +oid sha256:9f0b6dbd695324e1a37373b9d8c600c114abab0b1dc29fbc1e09a767dae9d805 +size 1187842 diff --git a/lib/search/indexes/github-docs-ghec-en.json.br b/lib/search/indexes/github-docs-ghec-en.json.br index 1552d47215..96930382ab 100644 --- a/lib/search/indexes/github-docs-ghec-en.json.br +++ b/lib/search/indexes/github-docs-ghec-en.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:86596ca15f044cb650e0be6a226eb02ae981ecbe8be4ce9ea38af0f13912f0fe -size 4791020 +oid sha256:d37633f9555ce290cc7ab112a4517989d01ab9c26ddea4d847c6a586b8423a5c +size 4793594 diff --git a/lib/search/indexes/github-docs-ghec-es-records.json.br b/lib/search/indexes/github-docs-ghec-es-records.json.br index 4145712798..c7f34aa890 100644 --- a/lib/search/indexes/github-docs-ghec-es-records.json.br +++ b/lib/search/indexes/github-docs-ghec-es-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:fef8d27922fc063e6ffa64c134d2c83ac32cecc630795a395e00c9e501de078f -size 740711 +oid sha256:cea70cbb37c96669e8287d80a380258a368a4ac2cc12d1aa638b8a10ee99a153 +size 740413 diff --git a/lib/search/indexes/github-docs-ghec-es.json.br b/lib/search/indexes/github-docs-ghec-es.json.br index 49613cf327..f839be614e 100644 --- a/lib/search/indexes/github-docs-ghec-es.json.br +++ b/lib/search/indexes/github-docs-ghec-es.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:b102a5fd62a58efac489cf15153cdde3f0d7051212b182bd4408bfef60d96836 -size 3448084 +oid sha256:58f44df8eea0c534ba9d755c00f6bc88d294831f446775cd80e1b8c6d3fb5557 +size 3447880 diff --git a/lib/search/indexes/github-docs-ghec-ja-records.json.br b/lib/search/indexes/github-docs-ghec-ja-records.json.br index 07d9ffd907..81968c5cd3 100644 --- a/lib/search/indexes/github-docs-ghec-ja-records.json.br +++ b/lib/search/indexes/github-docs-ghec-ja-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:44e2145e2d8f63f0637180bfd6f4bb018734916ac21ddeb12b550fd429325af6 -size 785350 +oid sha256:f49e1e3d3cc1b832260ce968162b47804f91adc8c96740601047789c3dc126dc +size 783791 diff --git a/lib/search/indexes/github-docs-ghec-ja.json.br b/lib/search/indexes/github-docs-ghec-ja.json.br index e8c1b8842d..b8390d4408 100644 --- a/lib/search/indexes/github-docs-ghec-ja.json.br +++ b/lib/search/indexes/github-docs-ghec-ja.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:6527c45712fed85b52f59997cf81d48864dc1627bbf30dc9ce4a3d8dedf327a9 -size 4340888 +oid sha256:70b68e69696da52c5e8a013d7ea097ab15aa5ed8d6d73506efe39cf3e1221e67 +size 4398284 diff --git a/lib/search/indexes/github-docs-ghec-pt-records.json.br b/lib/search/indexes/github-docs-ghec-pt-records.json.br index c987e94a8f..b06c682b65 100644 --- a/lib/search/indexes/github-docs-ghec-pt-records.json.br +++ b/lib/search/indexes/github-docs-ghec-pt-records.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:09a3df7272e1f67c722fd2d02128c0a78bac52d2df7da473ea8d39c46108fd83 -size 754726 +oid sha256:4d7c210f7a5845575e6da2ba6579296ef254305950fab00f31009e3951af2a50 +size 755238 diff --git a/lib/search/indexes/github-docs-ghec-pt.json.br b/lib/search/indexes/github-docs-ghec-pt.json.br index f11f84e623..f77b92e95b 100644 --- a/lib/search/indexes/github-docs-ghec-pt.json.br +++ b/lib/search/indexes/github-docs-ghec-pt.json.br @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:cefa91b9da025de181586f0fdc99746ccb52dfd7e939bb5945ba6be732e16e5f -size 3529024 +oid sha256:bbec231dfc15ceab9ee4635ab7a763d7c7ec6f1f9d64aa324239f41c059fb1f9 +size 3534586 diff --git a/translations/es-ES/content/actions/learn-github-actions/creating-workflow-templates.md b/translations/es-ES/content/actions/learn-github-actions/creating-workflow-templates.md deleted file mode 100644 index 3ad83990c7..0000000000 --- a/translations/es-ES/content/actions/learn-github-actions/creating-workflow-templates.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Creating workflow templates -shortTitle: Creating templates -intro: Learn how you can create workflow templates to help people in your team add new workflows more easily. -redirect_from: - - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## Overview - -{% data reusables.actions.workflow-organization-templates %} - -## Creating a workflow template - -Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. - -{% ifversion fpt %} -Your workflow templates can be used to create workflows in public repositories only. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/learn-github-actions/creating-workflow-templates). -{% endif %} - -{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -{% note %} - -**Note:** To avoid duplication in workflows created from a template you can call reusable workflows from within a workflow template. This can help make your workflows easier to maintain. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." - -{% endnote %} -{% endif %} - -This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. - -1. If it doesn't already exist, create a new public repository named `.github` in your organization. -2. Create a directory named `workflow-templates`. -3. Create your new workflow file inside the `workflow-templates` directory. - - If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. - - For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -4. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. - * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. - * `iconName` - **Optional.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. - * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. - -To add another workflow template, add your files to the same `workflow-templates` directory. For example: - -![Workflow template files](/assets/images/help/images/workflow-template-files.png) - -## Next steps - -To continue learning about {% data variables.product.prodname_actions %}, see "[Using workflow templates](/actions/learn-github-actions/using-workflow-templates)." diff --git a/translations/es-ES/content/actions/learn-github-actions/using-workflow-templates.md b/translations/es-ES/content/actions/learn-github-actions/using-workflow-templates.md deleted file mode 100644 index 8bdb52e763..0000000000 --- a/translations/es-ES/content/actions/learn-github-actions/using-workflow-templates.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Using workflow templates -shortTitle: Using templates -intro: '{% data variables.product.product_name %} provides workflow templates for a variety of languages and tooling.' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions - - /actions/guides/setting-up-continuous-integration-using-workflow-templates -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI - - CD ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## About workflow templates - -{% data variables.product.product_name %} offers workflow templates for a variety of languages and tooling. When you set up workflows in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests. - -You can also create your own workflow templates to share with your organization. For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." - -## Using workflow templates - -Anyone with write permission to a repository can set up {% data variables.product.prodname_actions %} workflows for CI/CD or other automation. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. If you already have a workflow in your repository, click **New workflow**. -1. Find the template that you want to use, then click **Set up this workflow**. -1. If the workflow template contains comments detailing additional setup steps, follow these steps. -1. Some workflow templates use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the workflow template uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." -1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs. -1. Click **Start commit**. -1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request. - -## Further reading - -- "[About continuous integration](/articles/about-continuous-integration)" -- "[Managing workflow runs](/actions/managing-workflow-runs)" -- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)" -- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" -{% ifversion fpt or ghec %} -- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/ja-JP/content/actions/learn-github-actions/creating-workflow-templates.md b/translations/ja-JP/content/actions/learn-github-actions/creating-workflow-templates.md deleted file mode 100644 index 3ad83990c7..0000000000 --- a/translations/ja-JP/content/actions/learn-github-actions/creating-workflow-templates.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Creating workflow templates -shortTitle: Creating templates -intro: Learn how you can create workflow templates to help people in your team add new workflows more easily. -redirect_from: - - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## Overview - -{% data reusables.actions.workflow-organization-templates %} - -## Creating a workflow template - -Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. - -{% ifversion fpt %} -Your workflow templates can be used to create workflows in public repositories only. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/learn-github-actions/creating-workflow-templates). -{% endif %} - -{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -{% note %} - -**Note:** To avoid duplication in workflows created from a template you can call reusable workflows from within a workflow template. This can help make your workflows easier to maintain. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." - -{% endnote %} -{% endif %} - -This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. - -1. If it doesn't already exist, create a new public repository named `.github` in your organization. -2. Create a directory named `workflow-templates`. -3. Create your new workflow file inside the `workflow-templates` directory. - - If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. - - For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -4. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. - * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. - * `iconName` - **Optional.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. - * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. - -To add another workflow template, add your files to the same `workflow-templates` directory. For example: - -![Workflow template files](/assets/images/help/images/workflow-template-files.png) - -## Next steps - -To continue learning about {% data variables.product.prodname_actions %}, see "[Using workflow templates](/actions/learn-github-actions/using-workflow-templates)." diff --git a/translations/ja-JP/content/actions/learn-github-actions/using-workflow-templates.md b/translations/ja-JP/content/actions/learn-github-actions/using-workflow-templates.md deleted file mode 100644 index f7685fa3f0..0000000000 --- a/translations/ja-JP/content/actions/learn-github-actions/using-workflow-templates.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Using workflow templates -shortTitle: Using templates -intro: '{% data variables.product.product_name %} provides workflow templates for a variety of languages and tooling.' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions - - /actions/guides/setting-up-continuous-integration-using-workflow-templates -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI - - CD ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## About workflow templates - -{% data variables.product.product_name %} offers workflow templates for a variety of languages and tooling. When you set up workflows in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests.{% if actions-starter-template-ui %} You can search and filter to find relevant workflow templates.{% endif %} - -You can also create your own workflow templates to share with your organization. These templates will appear alongside the {% data variables.product.product_name %} workflow templates. For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." - -## Using workflow templates - -Anyone with write permission to a repository can set up {% data variables.product.prodname_actions %} workflows for CI/CD or other automation. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. If you already have a workflow in your repository, click **New workflow**. -1. Find the template that you want to use, then click **Set up this workflow**.{% if actions-starter-template-ui %} To help you find the template that you want, you can search for keywords or filter by category.{% endif %} -1. If the workflow template contains comments detailing additional setup steps, follow these steps. Many of the templates have corresponding guides. For more information, see [the {% data variables.product.prodname_actions %} guides](/actions/guides)." -1. Some workflow templates use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the workflow template uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." -1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs. -1. Click **Start commit**. -1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request. - -## Further reading - -- "[About continuous integration](/articles/about-continuous-integration)" -- "[Managing workflow runs](/actions/managing-workflow-runs)" -- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)" -- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" -{% ifversion fpt or ghec %} -- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/ja-JP/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md b/translations/ja-JP/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md index b3c1173329..20a2edd4b6 100644 --- a/translations/ja-JP/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md +++ b/translations/ja-JP/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md @@ -45,7 +45,7 @@ In the tutorial, you will first make a workflow file that uses the [`andymckay/l issues: write{% endif %} steps: - name: Label issues - uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414 + uses: andymckay/labeler@e6c4322d0397f3240f0e7e30a33b5c5df2d39e90 with: add-labels: "triage" repo-token: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %} diff --git a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md index 88ca60761c..2122636727 100644 --- a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md +++ b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md @@ -161,6 +161,13 @@ This workflow scans: If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% ifversion ghes %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} +``` yaml +jobs: + analyze: + name: Analyze + runs-on: [ubuntu-latest] +``` + If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml @@ -170,12 +177,14 @@ jobs: runs-on: [self-hosted, ubuntu-latest] ``` -{% ifversion fpt or ghec %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} - {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% ifversion ghes %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." {% ifversion ghes %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} +For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." + +For recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis{% ifversion not ghes %} on self-hosted machines{% endif %}, see "[Recommended hardware resources for running {% data variables.product.prodname_codeql %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql)." + {% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Specifying the location for {% data variables.product.prodname_codeql %} databases diff --git a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md index 4f9478f221..622a6eb37f 100644 --- a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md +++ b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md @@ -22,6 +22,7 @@ children: - /tracking-code-scanning-alerts-in-issues-using-task-lists - /configuring-code-scanning - /about-code-scanning-with-codeql + - /recommended-hardware-resources-for-running-codeql - /configuring-the-codeql-workflow-for-compiled-languages - /troubleshooting-the-codeql-workflow - /running-codeql-code-scanning-in-a-container diff --git a/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md new file mode 100644 index 0000000000..4ea514673d --- /dev/null +++ b/translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md @@ -0,0 +1,32 @@ +--- +title: Recommended hardware resources for running CodeQL +shortTitle: Hardware resources for CodeQL +intro: 'Recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis on self-hosted machines, based on the size of your codebase.' +product: '{% data reusables.gated-features.code-scanning %}' +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Advanced Security + - Code scanning + - CodeQL + - Repositories + - Integration + - CI + +--- +You can set up {% data variables.product.prodname_codeql %} on {% data variables.product.prodname_actions %} or on an external CI system. {% data variables.product.prodname_codeql %} is fully compatible with {% data variables.product.prodname_dotcom %}-hosted runners on {% data variables.product.prodname_actions %}. + +If you're using an external CI system, or self-hosted runners on {% data variables.product.prodname_actions %} for private repositories, you're responsible for configuring your own hardware. The optimal hardware configuration for running {% data variables.product.prodname_codeql %} may vary based on the size and complexity of your codebase, the programming languages and build systems being used, and your CI workflow setup. + +The table below provides recommended hardware specifications for running {% data variables.product.prodname_codeql %} analysis, based on the size of your codebase. Use these as a starting point for determining your choice of hardware or virtual machine. A machine with greater resources may improve analysis performance, but may also be more expensive to maintain. + +| Codebase size | RAM | CPU | +|--------|--------|--------| +| Small (<100 K lines of code) | 8 GB or higher | 2 cores | +| Medium (100 K to 1 M lines of code) | 16 GB or higher | 4 or 8 cores | +| Large (>1 M lines of code) | 64 GB or higher | 8 cores | + +For all codebase sizes, we recommend using an SSD with 14 GB or more of disk space. There must be enough disk space to check out and build your code, plus additional space for data produced by {% data variables.product.prodname_codeql %}. diff --git a/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md b/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md index 1099495b71..8528c045c6 100644 --- a/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md +++ b/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md @@ -28,7 +28,7 @@ redirect_from: ## About using the {% data variables.product.prodname_codeql_cli %} for {% data variables.product.prodname_code_scanning %} -You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)." +You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)." For recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis, see "[Recommended hardware resources for running {% data variables.product.prodname_codeql %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql)." {% data reusables.code-scanning.what-is-codeql-cli %} diff --git a/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md b/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md index f6f88a8066..c2c3020329 100644 --- a/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md +++ b/translations/ja-JP/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md @@ -39,6 +39,8 @@ A typical workflow that uses the {% data variables.product.prodname_codeql_cli % - `codeql database analyze` to run queries to analyze each {% data variables.product.prodname_codeql %} database and summarize the results in a SARIF file. This command must be run once for each language or database. - `codeql github upload-results` to upload the resulting SARIF files to {% data variables.product.prodname_dotcom %}, to be displayed as code scanning alerts. This command must be run once for each language or SARIF file. +The {% data variables.product.prodname_codeql_runner %} is multithreaded by default. The {% data variables.product.prodname_codeql_cli %} only uses a single thread by default, but allows you to specify the amount of threads you want it to use. If you want to replicate the behavior of the {% data variables.product.prodname_codeql_runner %} to use all threads available on the machine when using the {% data variables.product.prodname_codeql_cli %}, you can pass `--threads 0` to `codeql database analyze`. + For more information, see "[Configuring {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system)." ## Examples of common uses for the {% data variables.product.prodname_codeql_cli %} diff --git a/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md b/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md index 820352f6af..7fd44389ce 100644 --- a/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md +++ b/translations/ja-JP/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md @@ -1,7 +1,7 @@ --- title: Renaming a branch intro: You can change the name of a branch in a repository. -permissions: People with write permissions to a repository can rename a branch in the repository. People with admin permissions can rename the default branch. +permissions: 'People with write permissions to a repository can rename a branch in the repository unless it is the [default branch](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches#about-the-default-branch){% ifversion fpt or ghec %} or a [protected branch](/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches){% endif %}. People with admin permissions can rename the default branch{% ifversion fpt or ghec %} and protected branches{% endif %}.' versions: fpt: '*' ghes: '>=3.1' diff --git a/translations/ja-JP/content/search-github/searching-on-github/searching-commits.md b/translations/ja-JP/content/search-github/searching-on-github/searching-commits.md index e7f31a7604..e0e772a5f7 100644 --- a/translations/ja-JP/content/search-github/searching-on-github/searching-commits.md +++ b/translations/ja-JP/content/search-github/searching-on-github/searching-commits.md @@ -109,11 +109,9 @@ The `is` qualifier matches commits from repositories with the specified visibili {%- ifversion fpt or ghes or ghec %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Commits) matches commits to public repositories. {%- endif %} - {%- ifversion ghes or ghec or ghae %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Commits) matches commits to internal repositories. {%- endif %} - | `is:private` | [**is:private**](https://github.com/search?q=is%3Aprivate&type=Commits) matches commits to private repositories. ## Further reading diff --git a/translations/log/cn-resets.csv b/translations/log/cn-resets.csv index 6b8e2855b6..d58b3bbe01 100644 --- a/translations/log/cn-resets.csv +++ b/translations/log/cn-resets.csv @@ -400,6 +400,7 @@ translations/zh-CN/content/code-security/code-scanning/automatically-scanning-yo translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-the-codeql-workflow-for-compiled-languages.md,rendering error translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md,rendering error translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository.md,rendering error +translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md,rendering error translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container.md,rendering error translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md,parsing error translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists.md,rendering error @@ -429,7 +430,6 @@ translations/zh-CN/content/code-security/supply-chain-security/keeping-your-depe translations/zh-CN/content/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/keeping-your-actions-up-to-date-with-dependabot.md,rendering error translations/zh-CN/content/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies.md,Listed in localization-support#489 translations/zh-CN/content/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies.md,parsing error -translations/zh-CN/content/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies.md,rendering error translations/zh-CN/content/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates.md,rendering error translations/zh-CN/content/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/browsing-security-vulnerabilities-in-the-github-advisory-database.md,rendering error translations/zh-CN/content/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/configuring-dependabot-security-updates.md,rendering error diff --git a/translations/log/ja-resets.csv b/translations/log/ja-resets.csv index 84ac5ae748..5f2dc19e63 100644 --- a/translations/log/ja-resets.csv +++ b/translations/log/ja-resets.csv @@ -414,6 +414,7 @@ translations/ja-JP/content/code-security/code-scanning/automatically-scanning-yo translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-the-codeql-workflow-for-compiled-languages.md,rendering error translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md,rendering error translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/managing-code-scanning-alerts-for-your-repository.md,rendering error +translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md,rendering error translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/running-codeql-code-scanning-in-a-container.md,rendering error translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/setting-up-code-scanning-for-a-repository.md,rendering error translations/ja-JP/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists.md,rendering error diff --git a/translations/pt-BR/content/actions/learn-github-actions/creating-workflow-templates.md b/translations/pt-BR/content/actions/learn-github-actions/creating-workflow-templates.md deleted file mode 100644 index 3ad83990c7..0000000000 --- a/translations/pt-BR/content/actions/learn-github-actions/creating-workflow-templates.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Creating workflow templates -shortTitle: Creating templates -intro: Learn how you can create workflow templates to help people in your team add new workflows more easily. -redirect_from: - - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## Overview - -{% data reusables.actions.workflow-organization-templates %} - -## Creating a workflow template - -Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. - -{% ifversion fpt %} -Your workflow templates can be used to create workflows in public repositories only. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/learn-github-actions/creating-workflow-templates). -{% endif %} - -{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -{% note %} - -**Note:** To avoid duplication in workflows created from a template you can call reusable workflows from within a workflow template. This can help make your workflows easier to maintain. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." - -{% endnote %} -{% endif %} - -This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. - -1. If it doesn't already exist, create a new public repository named `.github` in your organization. -2. Create a directory named `workflow-templates`. -3. Create your new workflow file inside the `workflow-templates` directory. - - If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. - - For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -4. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. - * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. - * `iconName` - **Optional.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. - * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. - -To add another workflow template, add your files to the same `workflow-templates` directory. For example: - -![Workflow template files](/assets/images/help/images/workflow-template-files.png) - -## Next steps - -To continue learning about {% data variables.product.prodname_actions %}, see "[Using workflow templates](/actions/learn-github-actions/using-workflow-templates)." diff --git a/translations/pt-BR/content/actions/learn-github-actions/using-workflow-templates.md b/translations/pt-BR/content/actions/learn-github-actions/using-workflow-templates.md deleted file mode 100644 index f7685fa3f0..0000000000 --- a/translations/pt-BR/content/actions/learn-github-actions/using-workflow-templates.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Using workflow templates -shortTitle: Using templates -intro: '{% data variables.product.product_name %} provides workflow templates for a variety of languages and tooling.' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions - - /actions/guides/setting-up-continuous-integration-using-workflow-templates -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI - - CD ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## About workflow templates - -{% data variables.product.product_name %} offers workflow templates for a variety of languages and tooling. When you set up workflows in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests.{% if actions-starter-template-ui %} You can search and filter to find relevant workflow templates.{% endif %} - -You can also create your own workflow templates to share with your organization. These templates will appear alongside the {% data variables.product.product_name %} workflow templates. For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." - -## Using workflow templates - -Anyone with write permission to a repository can set up {% data variables.product.prodname_actions %} workflows for CI/CD or other automation. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. If you already have a workflow in your repository, click **New workflow**. -1. Find the template that you want to use, then click **Set up this workflow**.{% if actions-starter-template-ui %} To help you find the template that you want, you can search for keywords or filter by category.{% endif %} -1. If the workflow template contains comments detailing additional setup steps, follow these steps. Many of the templates have corresponding guides. For more information, see [the {% data variables.product.prodname_actions %} guides](/actions/guides)." -1. Some workflow templates use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the workflow template uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." -1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs. -1. Click **Start commit**. -1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request. - -## Further reading - -- "[About continuous integration](/articles/about-continuous-integration)" -- "[Managing workflow runs](/actions/managing-workflow-runs)" -- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)" -- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" -{% ifversion fpt or ghec %} -- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/zh-CN/content/actions/learn-github-actions/creating-workflow-templates.md b/translations/zh-CN/content/actions/learn-github-actions/creating-workflow-templates.md deleted file mode 100644 index 3ad83990c7..0000000000 --- a/translations/zh-CN/content/actions/learn-github-actions/creating-workflow-templates.md +++ /dev/null @@ -1,98 +0,0 @@ ---- -title: Creating workflow templates -shortTitle: Creating templates -intro: Learn how you can create workflow templates to help people in your team add new workflows more easily. -redirect_from: - - /actions/configuring-and-managing-workflows/sharing-workflow-templates-within-your-organization -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## Overview - -{% data reusables.actions.workflow-organization-templates %} - -## Creating a workflow template - -Workflow templates can be created by users with write access to the organization's `.github` repository. The templates can then be used by organization members who have permission to create workflows. - -{% ifversion fpt %} -Your workflow templates can be used to create workflows in public repositories only. Organizations using {% data variables.product.prodname_ghe_cloud %} can also use workflow templates to create workflows in private repositories. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/actions/learn-github-actions/creating-workflow-templates). -{% endif %} - -{% ifversion fpt or ghes > 3.3 or ghae-issue-4757 or ghec %} -{% note %} - -**Note:** To avoid duplication in workflows created from a template you can call reusable workflows from within a workflow template. This can help make your workflows easier to maintain. For more information, see "[Reusing workflows](/actions/learn-github-actions/reusing-workflows)." - -{% endnote %} -{% endif %} - -This procedure demonstrates how to create a workflow template and metadata file. The metadata file describes how the template is presented to users when they are creating a new workflow. - -1. If it doesn't already exist, create a new public repository named `.github` in your organization. -2. Create a directory named `workflow-templates`. -3. Create your new workflow file inside the `workflow-templates` directory. - - If you need to refer to a repository's default branch, you can use the `$default-branch` placeholder. When a workflow is created using your template, the placeholder will be automatically replaced with the name of the repository's default branch. - - For example, this file named `octo-organization-ci.yml` demonstrates a basic workflow. - - ```yaml - name: Octo Organization CI - - on: - push: - branches: [ $default-branch ] - pull_request: - branches: [ $default-branch ] - - jobs: - build: - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - - name: Run a one-line script - run: echo Hello from Octo Organization - ``` -4. Create a metadata file inside the `workflow-templates` directory. The metadata file must have the same name as the workflow file, but instead of the `.yml` extension, it must be appended with `.properties.json`. For example, this file named `octo-organization-ci.properties.json` contains the metadata for a workflow file named `octo-organization-ci.yml`: - ```yaml - { - "name": "Octo Organization Workflow", - "description": "Octo Organization CI workflow template.", - "iconName": "example-icon", - "categories": [ - "Go" - ], - "filePatterns": [ - "package.json$", - "^Dockerfile", - ".*\\.md$" - ] - } - ``` - * `name` - **Required.** The name of the workflow template. This is displayed in the list of available templates. - * `description` - **Required.** The description of the workflow template. This is displayed in the list of available templates. - * `iconName` - **Optional.** Defines an icon for the workflow's entry in the template list. The `iconName` must be an SVG icon of the same name, and must be stored in the `workflow-templates` directory. For example, a SVG file named `example-icon.svg` is referenced as `example-icon`. - * `categories` - **Optional.** Defines the language category of the workflow. When a user views the available templates, those templates that match the same language will feature more prominently. For information on the available language categories, see https://github.com/github/linguist/blob/master/lib/linguist/languages.yml. - * `filePatterns` - **Optional.** Allows the template to be used if the user's repository has a file in its root directory that matches a defined regular expression. - -To add another workflow template, add your files to the same `workflow-templates` directory. For example: - -![Workflow template files](/assets/images/help/images/workflow-template-files.png) - -## Next steps - -To continue learning about {% data variables.product.prodname_actions %}, see "[Using workflow templates](/actions/learn-github-actions/using-workflow-templates)." diff --git a/translations/zh-CN/content/actions/learn-github-actions/using-workflow-templates.md b/translations/zh-CN/content/actions/learn-github-actions/using-workflow-templates.md deleted file mode 100644 index f7685fa3f0..0000000000 --- a/translations/zh-CN/content/actions/learn-github-actions/using-workflow-templates.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Using workflow templates -shortTitle: Using templates -intro: '{% data variables.product.product_name %} provides workflow templates for a variety of languages and tooling.' -redirect_from: - - /articles/setting-up-continuous-integration-using-github-actions - - /github/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/automating-your-workflow-with-github-actions/setting-up-continuous-integration-using-github-actions - - /actions/building-and-testing-code-with-continuous-integration/setting-up-continuous-integration-using-github-actions - - /actions/guides/setting-up-continuous-integration-using-workflow-templates -versions: - fpt: '*' - ghes: '*' - ghae: '*' - ghec: '*' -type: tutorial -topics: - - Workflows - - CI - - CD ---- - -{% data reusables.actions.enterprise-beta %} -{% data reusables.actions.enterprise-github-hosted-runners %} - -## About workflow templates - -{% data variables.product.product_name %} offers workflow templates for a variety of languages and tooling. When you set up workflows in your repository, {% data variables.product.product_name %} analyzes the code in your repository and recommends workflows based on the language and framework in your repository. For example, if you use [Node.js](https://nodejs.org/en/), {% data variables.product.product_name %} will suggest a template file that installs your Node.js packages and runs your tests.{% if actions-starter-template-ui %} You can search and filter to find relevant workflow templates.{% endif %} - -You can also create your own workflow templates to share with your organization. These templates will appear alongside the {% data variables.product.product_name %} workflow templates. For more information, see "[Creating workflow templates](/actions/learn-github-actions/creating-workflow-templates)." - -## Using workflow templates - -Anyone with write permission to a repository can set up {% data variables.product.prodname_actions %} workflows for CI/CD or other automation. - -{% data reusables.repositories.navigate-to-repo %} -{% data reusables.repositories.actions-tab %} -1. If you already have a workflow in your repository, click **New workflow**. -1. Find the template that you want to use, then click **Set up this workflow**.{% if actions-starter-template-ui %} To help you find the template that you want, you can search for keywords or filter by category.{% endif %} -1. If the workflow template contains comments detailing additional setup steps, follow these steps. Many of the templates have corresponding guides. For more information, see [the {% data variables.product.prodname_actions %} guides](/actions/guides)." -1. Some workflow templates use secrets. For example, {% raw %}`${{ secrets.npm_token }}`{% endraw %}. If the workflow template uses a secret, store the value described in the secret name as a secret in your repository. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." -1. Optionally, make additional changes. For example, you might want to change the value of `on` to change when the workflow runs. -1. Click **Start commit**. -1. Write a commit message and decide whether to commit directly to the default branch or to open a pull request. - -## Further reading - -- "[About continuous integration](/articles/about-continuous-integration)" -- "[Managing workflow runs](/actions/managing-workflow-runs)" -- "[About monitoring and troubleshooting](/actions/monitoring-and-troubleshooting-workflows/about-monitoring-and-troubleshooting)" -- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" -{% ifversion fpt or ghec %} -- "[Managing billing for {% data variables.product.prodname_actions %}](/billing/managing-billing-for-github-actions)" -{% endif %} diff --git a/translations/zh-CN/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md b/translations/zh-CN/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md index b3c1173329..20a2edd4b6 100644 --- a/translations/zh-CN/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md +++ b/translations/zh-CN/content/actions/managing-issues-and-pull-requests/adding-labels-to-issues.md @@ -45,7 +45,7 @@ In the tutorial, you will first make a workflow file that uses the [`andymckay/l issues: write{% endif %} steps: - name: Label issues - uses: andymckay/labeler@5c59dabdfd4dd5bd9c6e6d255b01b9d764af4414 + uses: andymckay/labeler@e6c4322d0397f3240f0e7e30a33b5c5df2d39e90 with: add-labels: "triage" repo-token: {% raw %}${{ secrets.GITHUB_TOKEN }}{% endraw %} diff --git a/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md b/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md index 88ca60761c..2122636727 100644 --- a/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md +++ b/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning.md @@ -161,6 +161,13 @@ This workflow scans: If your code requires a specific operating system to compile, you can configure the operating system in your {% data variables.product.prodname_codeql_workflow %}. Edit the value of `jobs.analyze.runs-on` to specify the operating system for the machine that runs your {% data variables.product.prodname_code_scanning %} actions. {% ifversion ghes %}You specify the operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% else %} +``` yaml +jobs: + analyze: + name: Analyze + runs-on: [ubuntu-latest] +``` + If you choose to use a self-hosted runner for code scanning, you can specify an operating system by using an appropriate label as the second element in a two-element array, after `self-hosted`.{% endif %} ``` yaml @@ -170,12 +177,14 @@ jobs: runs-on: [self-hosted, ubuntu-latest] ``` -{% ifversion fpt or ghec %}For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)."{% endif %} - {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} supports the latest versions of Ubuntu, Windows, and macOS. Typical values for this setting are therefore: `ubuntu-latest`, `windows-latest`, and `macos-latest`. For more information, see {% ifversion ghes %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#self-hosted-runners)" and "[Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners){% else %}"[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idruns-on){% endif %}." {% ifversion ghes %}You must ensure that Git is in the PATH variable on your self-hosted runners.{% else %}If you use a self-hosted runner, you must ensure that Git is in the PATH variable.{% endif %} +For more information, see "[About self-hosted runners](/actions/hosting-your-own-runners/about-self-hosted-runners)" and "[Adding self-hosted runners](/actions/hosting-your-own-runners/adding-self-hosted-runners)." + +For recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis{% ifversion not ghes %} on self-hosted machines{% endif %}, see "[Recommended hardware resources for running {% data variables.product.prodname_codeql %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql)." + {% ifversion fpt or ghes > 3.1 or ghae or ghec %} ## Specifying the location for {% data variables.product.prodname_codeql %} databases diff --git a/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md b/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md index 4f9478f221..622a6eb37f 100644 --- a/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md +++ b/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/index.md @@ -22,6 +22,7 @@ children: - /tracking-code-scanning-alerts-in-issues-using-task-lists - /configuring-code-scanning - /about-code-scanning-with-codeql + - /recommended-hardware-resources-for-running-codeql - /configuring-the-codeql-workflow-for-compiled-languages - /troubleshooting-the-codeql-workflow - /running-codeql-code-scanning-in-a-container diff --git a/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md b/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md new file mode 100644 index 0000000000..4ea514673d --- /dev/null +++ b/translations/zh-CN/content/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql.md @@ -0,0 +1,32 @@ +--- +title: Recommended hardware resources for running CodeQL +shortTitle: Hardware resources for CodeQL +intro: 'Recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis on self-hosted machines, based on the size of your codebase.' +product: '{% data reusables.gated-features.code-scanning %}' +versions: + fpt: '*' + ghes: '*' + ghae: '*' + ghec: '*' +topics: + - Advanced Security + - Code scanning + - CodeQL + - Repositories + - Integration + - CI + +--- +You can set up {% data variables.product.prodname_codeql %} on {% data variables.product.prodname_actions %} or on an external CI system. {% data variables.product.prodname_codeql %} is fully compatible with {% data variables.product.prodname_dotcom %}-hosted runners on {% data variables.product.prodname_actions %}. + +If you're using an external CI system, or self-hosted runners on {% data variables.product.prodname_actions %} for private repositories, you're responsible for configuring your own hardware. The optimal hardware configuration for running {% data variables.product.prodname_codeql %} may vary based on the size and complexity of your codebase, the programming languages and build systems being used, and your CI workflow setup. + +The table below provides recommended hardware specifications for running {% data variables.product.prodname_codeql %} analysis, based on the size of your codebase. Use these as a starting point for determining your choice of hardware or virtual machine. A machine with greater resources may improve analysis performance, but may also be more expensive to maintain. + +| Codebase size | RAM | CPU | +|--------|--------|--------| +| Small (<100 K lines of code) | 8 GB or higher | 2 cores | +| Medium (100 K to 1 M lines of code) | 16 GB or higher | 4 or 8 cores | +| Large (>1 M lines of code) | 64 GB or higher | 8 cores | + +For all codebase sizes, we recommend using an SSD with 14 GB or more of disk space. There must be enough disk space to check out and build your code, plus additional space for data produced by {% data variables.product.prodname_codeql %}. diff --git a/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md b/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md index 1099495b71..8528c045c6 100644 --- a/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md +++ b/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/installing-codeql-cli-in-your-ci-system.md @@ -28,7 +28,7 @@ redirect_from: ## About using the {% data variables.product.prodname_codeql_cli %} for {% data variables.product.prodname_code_scanning %} -You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)." +You can use the {% data variables.product.prodname_codeql_cli %} to run {% data variables.product.prodname_code_scanning %} on code that you're processing in a third-party continuous integration (CI) system. {% data reusables.code-scanning.about-code-scanning %} For information, see "[About {% data variables.product.prodname_code_scanning %} with {% data variables.product.prodname_codeql %}](/code-security/secure-coding/automatically-scanning-your-code-for-vulnerabilities-and-errors/about-code-scanning-with-codeql)." For recommended specifications (RAM, CPU cores, and disk) for running {% data variables.product.prodname_codeql %} analysis, see "[Recommended hardware resources for running {% data variables.product.prodname_codeql %}](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/recommended-hardware-resources-for-running-codeql)." {% data reusables.code-scanning.what-is-codeql-cli %} diff --git a/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md b/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md index f6f88a8066..c2c3020329 100644 --- a/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md +++ b/translations/zh-CN/content/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/migrating-from-the-codeql-runner-to-codeql-cli.md @@ -39,6 +39,8 @@ A typical workflow that uses the {% data variables.product.prodname_codeql_cli % - `codeql database analyze` to run queries to analyze each {% data variables.product.prodname_codeql %} database and summarize the results in a SARIF file. This command must be run once for each language or database. - `codeql github upload-results` to upload the resulting SARIF files to {% data variables.product.prodname_dotcom %}, to be displayed as code scanning alerts. This command must be run once for each language or SARIF file. +The {% data variables.product.prodname_codeql_runner %} is multithreaded by default. The {% data variables.product.prodname_codeql_cli %} only uses a single thread by default, but allows you to specify the amount of threads you want it to use. If you want to replicate the behavior of the {% data variables.product.prodname_codeql_runner %} to use all threads available on the machine when using the {% data variables.product.prodname_codeql_cli %}, you can pass `--threads 0` to `codeql database analyze`. + For more information, see "[Configuring {% data variables.product.prodname_codeql_cli %} in your CI system](/code-security/code-scanning/using-codeql-code-scanning-with-your-existing-ci-system/configuring-codeql-cli-in-your-ci-system)." ## Examples of common uses for the {% data variables.product.prodname_codeql_cli %} diff --git a/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md b/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md index 820352f6af..7fd44389ce 100644 --- a/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md +++ b/translations/zh-CN/content/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/renaming-a-branch.md @@ -1,7 +1,7 @@ --- title: Renaming a branch intro: You can change the name of a branch in a repository. -permissions: People with write permissions to a repository can rename a branch in the repository. People with admin permissions can rename the default branch. +permissions: 'People with write permissions to a repository can rename a branch in the repository unless it is the [default branch](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches#about-the-default-branch){% ifversion fpt or ghec %} or a [protected branch](/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/about-protected-branches){% endif %}. People with admin permissions can rename the default branch{% ifversion fpt or ghec %} and protected branches{% endif %}.' versions: fpt: '*' ghes: '>=3.1' diff --git a/translations/zh-CN/content/search-github/searching-on-github/searching-commits.md b/translations/zh-CN/content/search-github/searching-on-github/searching-commits.md index e7f31a7604..e0e772a5f7 100644 --- a/translations/zh-CN/content/search-github/searching-on-github/searching-commits.md +++ b/translations/zh-CN/content/search-github/searching-on-github/searching-commits.md @@ -109,11 +109,9 @@ The `is` qualifier matches commits from repositories with the specified visibili {%- ifversion fpt or ghes or ghec %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Commits) matches commits to public repositories. {%- endif %} - {%- ifversion ghes or ghec or ghae %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Commits) matches commits to internal repositories. {%- endif %} - | `is:private` | [**is:private**](https://github.com/search?q=is%3Aprivate&type=Commits) matches commits to private repositories. ## Further reading