From a8c7801607b1a22483a6dde45ae14cac3c64d742 Mon Sep 17 00:00:00 2001 From: Roniece Ricardo <33437850+RonRicardo@users.noreply.github.com> Date: Fri, 20 Dec 2024 15:01:52 -0500 Subject: [PATCH 1/2] [Quote removal] Remove quotes from data/reusables/actions and data/reusables/accounts (#53657) Co-authored-by: Ashish Keshan Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> --- .../accounts/accounts-billed-separately.md | 2 +- .../accounts/create-personal-access-tokens.md | 2 +- .../accounts/you-must-know-your-password.md | 2 +- .../actions/about-artifact-attestations.md | 2 +- .../about-deployment-with-github-actions.md | 2 +- data/reusables/actions/about-environments.md | 2 +- .../actions/about-oidc-short-overview.md | 2 +- data/reusables/actions/about-runner-groups.md | 4 +-- .../about-security-hardening-for-worklows.md | 2 +- .../actions/action-bundled-actions.md | 2 +- .../actions/actions-activity-types.md | 2 +- .../actions-runner-controller-about-arc.md | 2 +- ...ons-secrets-variables-repository-access.md | 2 +- .../actions/actions-tab-new-runners-note.md | 4 +-- ...tions-usage-metrics-not-billing-metrics.md | 2 +- .../actions/add-hosted-runner-overview.md | 2 +- .../actions/allow-specific-actions-intro.md | 8 +++--- .../actions/arc-runners-namespace.md | 2 +- .../artifact-attestations-step-explanation.md | 2 +- .../artifact-log-retention-statement.md | 2 +- .../azure-vnet-about-larger-runners.md | 4 +-- .../azure-vnet-configuring-overview.md | 2 +- ...-creating-network-configuration-prereqs.md | 4 +-- .../actions/azure-vnet-enterprise-policy.md | 2 +- ...ure-vnet-hosted-compute-troubleshooting.md | 2 +- .../actions/azure-vnet-intro-capabilities.md | 2 +- .../actions/azure-vnet-next-steps-links.md | 6 ++-- .../actions/azure-vnet-procedures-prereqs.md | 4 +-- .../actions/azure-vnet-supported-regions.md | 2 +- .../reusables/actions/cd-templates-actions.md | 2 +- data/reusables/actions/choose-repo.md | 2 +- data/reusables/actions/commit-workflow.md | 2 +- .../actions/context-injection-warning.md | 2 +- .../actions/create-azure-app-plan.md | 4 +-- .../actions/create-azure-publish-profile.md | 4 +-- ...eating-a-runner-group-for-an-enterprise.md | 2 +- ...ting-a-runner-group-for-an-organization.md | 8 +++--- ...endabot-version-updates-actions-caveats.md | 2 +- .../dependabot-version-updates-for-actions.md | 2 +- .../disable-selfhosted-runners-crossrefs.md | 4 +-- .../actions/enabling-actions-metrics.md | 2 +- .../actions/enterprise-common-prereqs.md | 4 +-- ...nterprise-gcp-storage-credential-fields.md | 2 +- .../actions/enterprise-http-proxy.md | 2 +- .../actions/enterprise-limit-actions-use.md | 2 +- .../actions/enterprise-marketplace-actions.md | 2 +- .../enterprise-postinstall-nextsteps.md | 2 +- ...enterprise-s3-storage-credential-fields.md | 2 +- .../actions/enterprise-setup-prereq.md | 2 +- .../actions/enterprise-storage-about.md | 2 +- .../actions/forked-write-permission.md | 2 +- .../gai-config-environment-variables.md | 2 +- .../actions/gai-custom-transformers-rec.md | 2 +- data/reusables/actions/gai-inspect-audit.md | 2 +- .../actions/general-security-hardening.md | 2 +- ...github-hosted-runners-check-concurrency.md | 2 +- .../actions/github-token-permissions.md | 2 +- .../github-token-scope-descriptions.md | 28 +++++++++---------- .../actions/github_sha_description.md | 2 +- .../actions/if-supported-contexts.md | 2 +- .../actions/internal-actions-summary.md | 2 +- .../actions/introducing-enterprise.md | 2 +- .../ip-allow-list-self-hosted-runners.md | 2 +- .../jobs/choosing-runner-github-hosted.md | 6 ++-- .../actions/jobs/choosing-runner-overview.md | 2 +- .../jobs/choosing-runner-self-hosted.md | 2 +- .../actions/jobs/matrix-from-context.md | 4 +-- ...-assigning-permissions-to-jobs-specific.md | 2 +- .../section-assigning-permissions-to-jobs.md | 2 +- .../jobs/section-defining-outputs-for-jobs.md | 2 +- ...ion-running-jobs-in-a-container-options.md | 2 +- .../jobs/section-using-concurrency-jobs.md | 2 +- .../actions/jobs/section-using-concurrency.md | 2 +- ...ing-conditions-to-control-job-execution.md | 2 +- .../section-using-environments-for-jobs.md | 8 +++--- .../section-using-jobs-in-a-workflow-needs.md | 2 +- .../jobs/section-using-jobs-in-a-workflow.md | 4 +-- .../actions/jobs/using-matrix-strategy.md | 2 +- .../actions/larger-runner-name-note.md | 2 +- ...r-runners-troubleshooting-linux-windows.md | 8 +++--- .../actions/learn-more-about-yaml.md | 2 +- data/reusables/actions/make-workflow-file.md | 2 +- .../reusables/actions/migrating-enterprise.md | 2 +- .../actions/more-resources-for-ghes.md | 2 +- .../oidc-deployment-protection-rules.md | 2 +- data/reusables/actions/oidc-link-to-intro.md | 2 +- data/reusables/actions/oidc-on-ghecom.md | 2 +- .../actions/oidc-permissions-token.md | 4 +-- .../reusables/actions/oidc-security-notice.md | 2 +- .../actions/onboarding-next-steps.md | 14 +++++----- .../org-access-to-github-hosted-runners.md | 2 +- .../org-to-enterprise-actions-permissions.md | 2 +- .../actions/partial-reruns-with-reusable.md | 6 ++-- ...ment-secrets-and-variables-organization.md | 2 +- ...rmissions-statement-secrets-environment.md | 2 +- .../actions/postgres-environment-variables.md | 2 +- ...pull-request-target-permissions-warning.md | 2 +- .../actions/redis-environment-variables.md | 2 +- data/reusables/actions/reusable-keyword.md | 2 +- .../reusable-workflow-calling-syntax.md | 2 +- data/reusables/actions/reusable-workflows.md | 2 +- .../actions/run-jobs-larger-runners.md | 2 +- data/reusables/actions/runner-labels.md | 2 +- .../actions/runner-tool-cache-description.md | 2 +- .../secrets-and-variables-org-permissions.md | 2 +- .../actions/self-hosted-runner-configure.md | 2 +- ...self-hosted-runner-networking-to-dotcom.md | 2 +- .../self-hosted-runner-ports-protocols.md | 2 +- .../self-hosted-runner-public-repo-access.md | 2 +- .../actions/self-hosted-runner-reqs-docker.md | 2 +- .../self-hosted-runner-security-admonition.md | 2 +- .../self-hosted-runners-prerequisites.md | 2 +- .../actions/service-container-prereqs.md | 2 +- .../settings-actions-pages-custom-workflow.md | 2 +- .../actions/supported-github-runners.md | 2 +- data/reusables/actions/third-party-actions.md | 2 +- .../upgrade-runners-before-upgrade-ghes.md | 2 +- .../reusables/actions/use-request-body-api.md | 2 +- .../actions/viewing-actions-metrics.md | 4 +-- .../workflow-basic-example-and-explanation.md | 4 +-- .../actions/workflow-permissions-intro.md | 2 +- .../actions/workflow-run-approve-link.md | 2 +- .../workflow-run-approve-public-fork.md | 4 +-- .../actions/workflow-runs-dependabot-note.md | 2 +- .../actions/workflow-templates-categories.md | 6 ++-- ...workflow-templates-for-more-information.md | 2 +- .../actions/workflow-templates-repo-link.md | 2 +- .../workflows-from-public-fork-setting.md | 2 +- .../workflows/required-workflow-beta.md | 4 +-- .../required-workflow-prerequisites.md | 8 +++--- .../required-workflow-source-notes.md | 4 +-- .../run-on-specific-branches-or-tags1.md | 2 +- .../workflows/section-specifying-branches.md | 2 +- .../section-triggering-a-workflow-schedule.md | 2 +- .../section-triggering-a-workflow-types.md | 2 +- .../section-triggering-a-workflow.md | 2 +- .../workflows/triggering-a-workflow-paths1.md | 2 +- .../workflows/triggering-a-workflow-paths5.md | 2 +- .../triggering-workflow-branches1.md | 2 +- 139 files changed, 198 insertions(+), 198 deletions(-) diff --git a/data/reusables/accounts/accounts-billed-separately.md b/data/reusables/accounts/accounts-billed-separately.md index e345b271fe13..9e417e9ed1b1 100644 --- a/data/reusables/accounts/accounts-billed-separately.md +++ b/data/reusables/accounts/accounts-billed-separately.md @@ -1 +1 @@ -Each account on {% data variables.product.product_name %} is billed separately. Upgrading an organization account enables paid features for the organization's repositories only and does not affect the features available in repositories owned by any associated personal accounts. Similarly, upgrading a personal account enables paid features for the personal account's repositories only and does not affect the repositories of any organization accounts. For more information about account types, see "[AUTOTITLE](/get-started/learning-about-github/types-of-github-accounts)." +Each account on {% data variables.product.product_name %} is billed separately. Upgrading an organization account enables paid features for the organization's repositories only and does not affect the features available in repositories owned by any associated personal accounts. Similarly, upgrading a personal account enables paid features for the personal account's repositories only and does not affect the repositories of any organization accounts. For more information about account types, see [AUTOTITLE](/get-started/learning-about-github/types-of-github-accounts). diff --git a/data/reusables/accounts/create-personal-access-tokens.md b/data/reusables/accounts/create-personal-access-tokens.md index d5f4dc61abb9..2c556616b31f 100644 --- a/data/reusables/accounts/create-personal-access-tokens.md +++ b/data/reusables/accounts/create-personal-access-tokens.md @@ -1 +1 @@ -1. For each of your accounts, create a dedicated {% data variables.product.pat_v1 %} with `repo` scope. {% ifversion pat-v2 %}Or, for each of your accounts and for each organization that you are a member of, create a {% data variables.product.pat_v2 %} that can access the desired repositories and that has read and write permissions on repository contents.{% endif %} For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." +1. For each of your accounts, create a dedicated {% data variables.product.pat_v1 %} with `repo` scope. {% ifversion pat-v2 %}Or, for each of your accounts and for each organization that you are a member of, create a {% data variables.product.pat_v2 %} that can access the desired repositories and that has read and write permissions on repository contents.{% endif %} For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token). diff --git a/data/reusables/accounts/you-must-know-your-password.md b/data/reusables/accounts/you-must-know-your-password.md index fb12d1309ac1..e0daa499b49d 100644 --- a/data/reusables/accounts/you-must-know-your-password.md +++ b/data/reusables/accounts/you-must-know-your-password.md @@ -1 +1 @@ -If you protect your personal account with two-factor authentication but do not know your password, {% ifversion 2fa-recovery-flow %} you will need to start a two-factor authentication recovery request. For more information, see "[Request help with two-factor authentication](/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials#requesting-help-with-two-factor-authentication)."{% else %}you will not be able to follow these steps to recover your account.{% data variables.product.company_short %} can send a password reset email to a verified address associated with your account. For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials#requesting-a-new-password)."{% endif %} +If you protect your personal account with two-factor authentication but do not know your password, {% ifversion 2fa-recovery-flow %} you will need to start a two-factor authentication recovery request. For more information, see [Request help with two-factor authentication](/authentication/securing-your-account-with-two-factor-authentication-2fa/recovering-your-account-if-you-lose-your-2fa-credentials#requesting-help-with-two-factor-authentication).{% else %}you will not be able to follow these steps to recover your account.{% data variables.product.company_short %} can send a password reset email to a verified address associated with your account. For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/updating-your-github-access-credentials#requesting-a-new-password).{% endif %} diff --git a/data/reusables/actions/about-artifact-attestations.md b/data/reusables/actions/about-artifact-attestations.md index 0860a1904871..ab2e90fa79c9 100644 --- a/data/reusables/actions/about-artifact-attestations.md +++ b/data/reusables/actions/about-artifact-attestations.md @@ -4,6 +4,6 @@ When you generate artifact attestations with your software, you create cryptogra * A link to the workflow associated with the artifact. * The repository, organization, environment, commit SHA, and triggering event for the artifact. -* Other information from the OIDC token used to establish provenance. For more information, see "[AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)." +* Other information from the OIDC token used to establish provenance. For more information, see [AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect). You can also generate artifact attestations that include an associated software bill of materials (SBOM). Associating your builds with a list of the open source dependencies used in them provides transparency and enables consumers to comply with data protection standards. diff --git a/data/reusables/actions/about-deployment-with-github-actions.md b/data/reusables/actions/about-deployment-with-github-actions.md index d53b435cb81c..b07d10a6d78d 100644 --- a/data/reusables/actions/about-deployment-with-github-actions.md +++ b/data/reusables/actions/about-deployment-with-github-actions.md @@ -1 +1 @@ -You can deliver deployments through {% data variables.product.prodname_actions %} and environments or with the REST API and third party apps. For more information about using environments to deploy with {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment)." For more information about deployments with the REST API, see "[AUTOTITLE](/rest/repos#deployments)." +You can deliver deployments through {% data variables.product.prodname_actions %} and environments or with the REST API and third party apps. For more information about using environments to deploy with {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment). For more information about deployments with the REST API, see [AUTOTITLE](/rest/repos#deployments). diff --git a/data/reusables/actions/about-environments.md b/data/reusables/actions/about-environments.md index b8c0d8d7144f..998b2b1c39e0 100644 --- a/data/reusables/actions/about-environments.md +++ b/data/reusables/actions/about-environments.md @@ -1 +1 @@ -Environments are used to describe a general deployment target like `production`, `staging`, or `development`. When a {% data variables.product.prodname_actions %} workflow deploys to an environment, the environment is displayed on the main page of the repository. You can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow{% ifversion actions-custom-deployment-protection-rules-beta %}, gate deployments with custom deployment protection rules{% endif %}, or limit access to secrets. For more information about creating environments, see "[AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment)." +Environments are used to describe a general deployment target like `production`, `staging`, or `development`. When a {% data variables.product.prodname_actions %} workflow deploys to an environment, the environment is displayed on the main page of the repository. You can use environments to require approval for a job to proceed, restrict which branches can trigger a workflow{% ifversion actions-custom-deployment-protection-rules-beta %}, gate deployments with custom deployment protection rules{% endif %}, or limit access to secrets. For more information about creating environments, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment). diff --git a/data/reusables/actions/about-oidc-short-overview.md b/data/reusables/actions/about-oidc-short-overview.md index 9e62e3e0d175..2bbcbd9cd490 100644 --- a/data/reusables/actions/about-oidc-short-overview.md +++ b/data/reusables/actions/about-oidc-short-overview.md @@ -1,2 +1,2 @@ -If your {% data variables.product.prodname_actions %} workflows need to access resources from a cloud provider that supports OpenID Connect (OIDC), you can configure your workflows to authenticate directly to the cloud provider. This will let you stop storing these credentials as long-lived secrets and provide other security benefits. For more information, see "[AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)" +If your {% data variables.product.prodname_actions %} workflows need to access resources from a cloud provider that supports OpenID Connect (OIDC), you can configure your workflows to authenticate directly to the cloud provider. This will let you stop storing these credentials as long-lived secrets and provide other security benefits. For more information, see [AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect) diff --git a/data/reusables/actions/about-runner-groups.md b/data/reusables/actions/about-runner-groups.md index e3c5aa373a07..124d4df4cf2d 100644 --- a/data/reusables/actions/about-runner-groups.md +++ b/data/reusables/actions/about-runner-groups.md @@ -2,8 +2,8 @@ To control access to runners at the organization{% ifversion ghec or ghes %} and When you grant access to a runner group, you can see the runner group listed in the organization's runner settings. Optionally, you can assign additional granular repository{% ifversion restrict-groups-to-workflows %} and workflow{% endif %} access policies to the runner group. -When new runners are created, they are automatically assigned to the default group unless otherwise specified. Runners can only be in one group at a time. You can move runners from one runner group to another. For more information, see "[Moving a runner to a group](#moving-a-runner-to-a-group)." +When new runners are created, they are automatically assigned to the default group unless otherwise specified. Runners can only be in one group at a time. You can move runners from one runner group to another. For more information, see [Moving a runner to a group](#moving-a-runner-to-a-group). {% ifversion target-runner-groups %} -For information on how to route jobs to runners in a specific group, see "[AUTOTITLE](/actions/using-jobs/choosing-the-runner-for-a-job#choosing-runners-in-a-group)." +For information on how to route jobs to runners in a specific group, see [AUTOTITLE](/actions/using-jobs/choosing-the-runner-for-a-job#choosing-runners-in-a-group). {% endif %} diff --git a/data/reusables/actions/about-security-hardening-for-worklows.md b/data/reusables/actions/about-security-hardening-for-worklows.md index e26dba732b1e..f8e7011b1ed6 100644 --- a/data/reusables/actions/about-security-hardening-for-worklows.md +++ b/data/reusables/actions/about-security-hardening-for-worklows.md @@ -1 +1 @@ -{% data variables.product.prodname_dotcom %} provides security features that you can use to increase the security of your workflows. You can use {% data variables.product.prodname_dotcom %}'s built-in features to ensure you are notified about vulnerabilities in the actions you consume, or to automate the process of keeping the actions in your workflows up to date. For more information, see "[AUTOTITLE](/actions/security-guides/using-githubs-security-features-to-secure-your-use-of-github-actions)." +{% data variables.product.prodname_dotcom %} provides security features that you can use to increase the security of your workflows. You can use {% data variables.product.prodname_dotcom %}'s built-in features to ensure you are notified about vulnerabilities in the actions you consume, or to automate the process of keeping the actions in your workflows up to date. For more information, see [AUTOTITLE](/actions/security-guides/using-githubs-security-features-to-secure-your-use-of-github-actions). diff --git a/data/reusables/actions/action-bundled-actions.md b/data/reusables/actions/action-bundled-actions.md index 5df11302d5a6..90d8c73fabcf 100644 --- a/data/reusables/actions/action-bundled-actions.md +++ b/data/reusables/actions/action-bundled-actions.md @@ -1 +1 @@ -For more information about the action, and for instructions about how to download the most recent version, see "[AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions)." +For more information about the action, and for instructions about how to download the most recent version, see [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/using-the-latest-version-of-the-official-bundled-actions). diff --git a/data/reusables/actions/actions-activity-types.md b/data/reusables/actions/actions-activity-types.md index 79b6f089ef0e..fc71bab10683 100644 --- a/data/reusables/actions/actions-activity-types.md +++ b/data/reusables/actions/actions-activity-types.md @@ -19,4 +19,4 @@ on: - labeled ``` -For more information about each event and their activity types, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows)." +For more information about each event and their activity types, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows). diff --git a/data/reusables/actions/actions-runner-controller-about-arc.md b/data/reusables/actions/actions-runner-controller-about-arc.md index ecb1da200fd5..6ba8ea90df37 100644 --- a/data/reusables/actions/actions-runner-controller-about-arc.md +++ b/data/reusables/actions/actions-runner-controller-about-arc.md @@ -1,3 +1,3 @@ {% data variables.product.prodname_actions_runner_controller %} (ARC) is a Kubernetes operator that orchestrates and scales self-hosted runners for {% data variables.product.prodname_actions %}. For more information, see [Operator pattern](https://kubernetes.io/docs/concepts/extend-kubernetes/operator/) in the Kubernetes documentation. -With ARC, you can create runner scale sets that automatically scale based on the number of workflows running in your repository, organization, or enterprise. Because controlled runners can be ephemeral and based on containers, new runner instances can scale up or down rapidly and cleanly. For more information about autoscaling, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/autoscaling-with-self-hosted-runners)." +With ARC, you can create runner scale sets that automatically scale based on the number of workflows running in your repository, organization, or enterprise. Because controlled runners can be ephemeral and based on containers, new runner instances can scale up or down rapidly and cleanly. For more information about autoscaling, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/autoscaling-with-self-hosted-runners). diff --git a/data/reusables/actions/actions-secrets-variables-repository-access.md b/data/reusables/actions/actions-secrets-variables-repository-access.md index e62085078305..86800fda2e21 100644 --- a/data/reusables/actions/actions-secrets-variables-repository-access.md +++ b/data/reusables/actions/actions-secrets-variables-repository-access.md @@ -2,7 +2,7 @@ {% ifversion fpt %} > [!NOTE] -> Organization-level secrets and variables are not accessible by private repositories for {% data variables.product.prodname_free_user %}. For more information about upgrading your {% data variables.product.company_short %} subscription, see "[AUTOTITLE](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription)". +> Organization-level secrets and variables are not accessible by private repositories for {% data variables.product.prodname_free_user %}. For more information about upgrading your {% data variables.product.company_short %} subscription, see [AUTOTITLE](/billing/managing-billing-for-your-github-account/upgrading-your-github-subscription). {% endif %} diff --git a/data/reusables/actions/actions-tab-new-runners-note.md b/data/reusables/actions/actions-tab-new-runners-note.md index 336daa78c6ae..7fe033d8b901 100644 --- a/data/reusables/actions/actions-tab-new-runners-note.md +++ b/data/reusables/actions/actions-tab-new-runners-note.md @@ -1,7 +1,7 @@ > [!NOTE] > Enterprise and organization owners{% ifversion custom-org-roles %} and users with the "Manage organization runners and runner groups" permission{% endif %} can create runners from this page. To create a new runner, click **New runner** at the top right of the list of runners to add runners to the repository. > -> For more information, see {% ifversion actions-hosted-runners %}"[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners)" and {% endif %}"[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners)." +> For more information, see {% ifversion actions-hosted-runners %}[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners) and {% endif %}[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners). {% ifversion custom-org-roles %} ->For more information about custom organization roles, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)." +>For more information about custom organization roles, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles). {% endif %} diff --git a/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md b/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md index 6607b252b664..9402fad4c976 100644 --- a/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md +++ b/data/reusables/actions/actions-usage-metrics-not-billing-metrics.md @@ -1,3 +1,3 @@ {% data variables.product.prodname_actions %} usage metrics do not apply minute multipliers to the metrics displayed. While they _can_ help you understand your bill, their primary purpose is to help you understand how and where Actions minutes are being used in your organization. -For more information about minute multipliers, see "[AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#minute-multipliers)." +For more information about minute multipliers, see [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#minute-multipliers). diff --git a/data/reusables/actions/add-hosted-runner-overview.md b/data/reusables/actions/add-hosted-runner-overview.md index 1d8f7e774089..7a3194dcfd9b 100644 --- a/data/reusables/actions/add-hosted-runner-overview.md +++ b/data/reusables/actions/add-hosted-runner-overview.md @@ -1,3 +1,3 @@ You can choose an operating system and a hardware configuration from the list of available options. When new instances of this runner are deployed through autoscaling, they'll use the same operating system and hardware configuration you've defined here. -New runners are automatically assigned to the default group, or you can choose which group the runners must join during the runner creation process. In addition, you can modify the runner's group membership after you've registered the runner. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/controlling-access-to-larger-runners)." +New runners are automatically assigned to the default group, or you can choose which group the runners must join during the runner creation process. In addition, you can modify the runner's group membership after you've registered the runner. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/controlling-access-to-larger-runners). diff --git a/data/reusables/actions/allow-specific-actions-intro.md b/data/reusables/actions/allow-specific-actions-intro.md index 4147bcd251ed..5101bfd92624 100644 --- a/data/reusables/actions/allow-specific-actions-intro.md +++ b/data/reusables/actions/allow-specific-actions-intro.md @@ -8,17 +8,17 @@ When you choose {% data reusables.actions.policy-label-for-select-actions-workfl {% data reusables.repositories.settings-permissions-org-policy-note %} * **Allow actions created by {% data variables.product.prodname_dotcom %}:** You can allow all actions created by {% data variables.product.prodname_dotcom %} to be used by workflows. Actions created by {% data variables.product.prodname_dotcom %} are located in the `actions` and `github` organizations. For more information, see the [`actions`](https://github.com/actions) and [`github`](https://github.com/github) organizations. -* **Allow Marketplace actions by verified creators:** {% ifversion ghes %}This option is available if you have {% data variables.product.prodname_github_connect %} enabled and configured with {% data variables.product.prodname_actions %}. For more information, see "[AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect)."{% endif %} You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. +* **Allow Marketplace actions by verified creators:** {% ifversion ghes %}This option is available if you have {% data variables.product.prodname_github_connect %} enabled and configured with {% data variables.product.prodname_actions %}. For more information, see [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/enabling-automatic-access-to-githubcom-actions-using-github-connect).{% endif %} You can allow all {% data variables.product.prodname_marketplace %} actions created by verified creators to be used by workflows. When GitHub has verified the creator of the action as a partner organization, the {% octicon "verified" aria-label="The verified badge" %} badge is displayed next to the action in {% data variables.product.prodname_marketplace %}. * **Allow specified actions{% ifversion actions-workflow-policy %} and reusable workflows{% endif %}:** You can restrict workflows to use actions{% ifversion actions-workflow-policy %} and reusable workflows{% endif %} in specific organizations and repositories. Specified actions cannot be set to more than 1000. To restrict access to specific tags or commit SHAs of an action{% ifversion actions-workflow-policy %} or reusable workflow{% endif %}, use the same syntax used in the workflow to select the action{% ifversion actions-workflow-policy %} or reusable workflow{% endif %}. - * For an action, the syntax is `OWNER/REPOSITORY@TAG-OR-SHA`. For example, use `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f` to select a SHA. For more information, see "[AUTOTITLE](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions)." + * For an action, the syntax is `OWNER/REPOSITORY@TAG-OR-SHA`. For example, use `actions/javascript-action@v1.0.1` to select a tag or `actions/javascript-action@a824008085750b8e136effc585c3cd6082bd575f` to select a SHA. For more information, see [AUTOTITLE](/actions/learn-github-actions/finding-and-customizing-actions#using-release-management-for-your-custom-actions). {%- ifversion actions-workflow-policy %} - * For a reusable workflow, the syntax is `OWNER/REPOSITORY/PATH/FILENAME@TAG-OR-SHA`. For example, `octo-org/another-repo/.github/workflows/workflow.yml@v1`. For more information, see "[AUTOTITLE](/actions/using-workflows/reusing-workflows#calling-a-reusable-workflow)." + * For a reusable workflow, the syntax is `OWNER/REPOSITORY/PATH/FILENAME@TAG-OR-SHA`. For example, `octo-org/another-repo/.github/workflows/workflow.yml@v1`. For more information, see [AUTOTITLE](/actions/using-workflows/reusing-workflows#calling-a-reusable-workflow). {%- endif %} - You can use the `*` wildcard character to match patterns. For example, to allow all actions{% ifversion actions-workflow-policy %} and reusable workflows{% endif %} in organizations that start with `space-org`, you can specify `space-org*/*`. To allow all actions{% ifversion actions-workflow-policy %} and reusable workflows{% endif %} in repositories that start with octocat, you can use `*/octocat**@*`. For more information about using the `*` wildcard, see "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." + You can use the `*` wildcard character to match patterns. For example, to allow all actions{% ifversion actions-workflow-policy %} and reusable workflows{% endif %} in organizations that start with `space-org`, you can specify `space-org*/*`. To allow all actions{% ifversion actions-workflow-policy %} and reusable workflows{% endif %} in repositories that start with octocat, you can use `*/octocat**@*`. For more information about using the `*` wildcard, see [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet). Use `,` to separate patterns. For example, to allow `octocat` and `octokit`, you can specify `octocat/*, octokit/*`. diff --git a/data/reusables/actions/arc-runners-namespace.md b/data/reusables/actions/arc-runners-namespace.md index 320248b16ffe..a65e73e57896 100644 --- a/data/reusables/actions/arc-runners-namespace.md +++ b/data/reusables/actions/arc-runners-namespace.md @@ -1,2 +1,2 @@ > [!NOTE] -> Create the secret in the same namespace where the `gha-runner-scale-set` chart is installed. In this example, the namespace is `arc-runners` to match the quickstart documentation. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller#configuring-a-runner-scale-set)." +> Create the secret in the same namespace where the `gha-runner-scale-set` chart is installed. In this example, the namespace is `arc-runners` to match the quickstart documentation. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller#configuring-a-runner-scale-set). diff --git a/data/reusables/actions/artifact-attestations-step-explanation.md b/data/reusables/actions/artifact-attestations-step-explanation.md index 393fcdd3edd0..bb07276e1764 100644 --- a/data/reusables/actions/artifact-attestations-step-explanation.md +++ b/data/reusables/actions/artifact-attestations-step-explanation.md @@ -1 +1 @@ -In the last step, it generates an artifact attestation for the image, which increases supply chain security. For more information, see "[AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds)." +In the last step, it generates an artifact attestation for the image, which increases supply chain security. For more information, see [AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds). diff --git a/data/reusables/actions/artifact-log-retention-statement.md b/data/reusables/actions/artifact-log-retention-statement.md index 677a8b7dd28c..65c0f8236f82 100644 --- a/data/reusables/actions/artifact-log-retention-statement.md +++ b/data/reusables/actions/artifact-log-retention-statement.md @@ -1 +1 @@ -By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see "[AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration#artifact-and-log-retention-policy)." +By default, {% data variables.product.product_name %} stores build logs and artifacts for 90 days, and this retention period can be customized. For more information, see [AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration#artifact-and-log-retention-policy). diff --git a/data/reusables/actions/azure-vnet-about-larger-runners.md b/data/reusables/actions/azure-vnet-about-larger-runners.md index 6acb63f09b6a..1bcc96606ea1 100644 --- a/data/reusables/actions/azure-vnet-about-larger-runners.md +++ b/data/reusables/actions/azure-vnet-about-larger-runners.md @@ -1,3 +1,3 @@ -2-64 vCPU Ubuntu and Windows runners are supported with Azure VNET. For more information on these runner types, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/about-larger-runners#about-ubuntu-and-windows-larger-runners)." +2-64 vCPU Ubuntu and Windows runners are supported with Azure VNET. For more information on these runner types, see [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/about-larger-runners#about-ubuntu-and-windows-larger-runners). -{% data reusables.actions.static-ip-limitation-vnet %} You must use dynamic IP addresses, which is the default configuration for larger runners. For more information about networking for larger runners, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/about-larger-runners#networking-for-larger-runners)." +{% data reusables.actions.static-ip-limitation-vnet %} You must use dynamic IP addresses, which is the default configuration for larger runners. For more information about networking for larger runners, see [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/about-larger-runners#networking-for-larger-runners). diff --git a/data/reusables/actions/azure-vnet-configuring-overview.md b/data/reusables/actions/azure-vnet-configuring-overview.md index 0b5d423d0ea6..5a69640a9153 100644 --- a/data/reusables/actions/azure-vnet-configuring-overview.md +++ b/data/reusables/actions/azure-vnet-configuring-overview.md @@ -2,4 +2,4 @@ To use {% data variables.product.company_short %}-hosted runners with Azure VNET The following procedures will lead you through both steps. -For more information about troubleshooting common issues with using {% data variables.product.company_short %}-hosted runners with Azure VNET, see {% ifversion ghec %}"[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise)."{% else %}"[AUTOTITLE](/organizations/managing-organization-settings/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-organization)."{% endif %} +For more information about troubleshooting common issues with using {% data variables.product.company_short %}-hosted runners with Azure VNET, see {% ifversion ghec %}[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-enterprise).{% else %}[AUTOTITLE](/organizations/managing-organization-settings/troubleshooting-azure-private-network-configurations-for-github-hosted-runners-in-your-organization).{% endif %} diff --git a/data/reusables/actions/azure-vnet-creating-network-configuration-prereqs.md b/data/reusables/actions/azure-vnet-creating-network-configuration-prereqs.md index c46bb0dee1af..7ae6c90a5895 100644 --- a/data/reusables/actions/azure-vnet-creating-network-configuration-prereqs.md +++ b/data/reusables/actions/azure-vnet-creating-network-configuration-prereqs.md @@ -1,7 +1,7 @@ -After configuring your Azure resources, you can use an Azure Virtual Network (VNET) for private networking by creating a network configuration{% ifversion ghec %} at the enterprise or organization level{% else %} at the organization level{% endif %}. Then, you can associate that network configuration to runner groups. For more information about runner groups, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners)." +After configuring your Azure resources, you can use an Azure Virtual Network (VNET) for private networking by creating a network configuration{% ifversion ghec %} at the enterprise or organization level{% else %} at the organization level{% endif %}. Then, you can associate that network configuration to runner groups. For more information about runner groups, see [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners). Once the network configuration is associated with a runner group, all runners in that group will have access to the Azure VNET that has been connected to the underlying configuration. ### Prerequisites -Ensure your Azure resources have been configured _before_ adding a network configuration in {% data variables.product.company_short %}. For more information, see {% ifversion ghec %}"[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners#configuring-your-azure-resources)."{% else %}For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization#configuring-your-azure-resources)."{% endif %} +Ensure your Azure resources have been configured _before_ adding a network configuration in {% data variables.product.company_short %}. For more information, see {% ifversion ghec %}[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners#configuring-your-azure-resources).{% else %}[AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization#configuring-your-azure-resources).{% endif %} diff --git a/data/reusables/actions/azure-vnet-enterprise-policy.md b/data/reusables/actions/azure-vnet-enterprise-policy.md index d8286fbe75d8..13975ddc3644 100644 --- a/data/reusables/actions/azure-vnet-enterprise-policy.md +++ b/data/reusables/actions/azure-vnet-enterprise-policy.md @@ -1 +1 @@ -By default, organizations in an enterprise cannot create new network configurations and only inherit enterprise-level network configurations. Enterprise owners can set a policy that allows organizations in the enterprise to create network configurations that are independent of the enterprise. For more information, see "[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise#enabling-creation-of-network-configurations-for-organizations)." +By default, organizations in an enterprise cannot create new network configurations and only inherit enterprise-level network configurations. Enterprise owners can set a policy that allows organizations in the enterprise to create network configurations that are independent of the enterprise. For more information, see [AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise#enabling-creation-of-network-configurations-for-organizations). diff --git a/data/reusables/actions/azure-vnet-hosted-compute-troubleshooting.md b/data/reusables/actions/azure-vnet-hosted-compute-troubleshooting.md index 7ef8f8d8ecfb..2947005dbb36 100644 --- a/data/reusables/actions/azure-vnet-hosted-compute-troubleshooting.md +++ b/data/reusables/actions/azure-vnet-hosted-compute-troubleshooting.md @@ -70,7 +70,7 @@ To fix this, either increase the size of the subnet you are using or reduce the ### Cannot delete subnet -In some cases, a subnet cannot be deleted because it has a Service Association Link (SAL) applied to it. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization#deleting-a-subnet)." +In some cases, a subnet cannot be deleted because it has a Service Association Link (SAL) applied to it. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization#deleting-a-subnet). If you need to identify the network settings resource associated with the subnet, you can run the following `curl` command. To obtain an Azure Entra token, please refer to the [Azure documentation](https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli). Use the same `api-version` you used to create the resource. diff --git a/data/reusables/actions/azure-vnet-intro-capabilities.md b/data/reusables/actions/azure-vnet-intro-capabilities.md index cab3e06703fb..bc7deaab9a62 100644 --- a/data/reusables/actions/azure-vnet-intro-capabilities.md +++ b/data/reusables/actions/azure-vnet-intro-capabilities.md @@ -1,4 +1,4 @@ -You can connect multiple VNET subnets to {% data variables.product.github %} and manage private resource access for your runners via runner groups. For more information about runner groups, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners)." +You can connect multiple VNET subnets to {% data variables.product.github %} and manage private resource access for your runners via runner groups. For more information about runner groups, see [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners). Using {% data variables.product.company_short %}-hosted runners within Azure VNET allows you to perform the following actions. * Privately connect a runner to resources inside an Azure VNET without opening internet ports, including on-premises resources accessible from the Azure VNET. diff --git a/data/reusables/actions/azure-vnet-next-steps-links.md b/data/reusables/actions/azure-vnet-next-steps-links.md index b8d55fb5365c..38834b4c658c 100644 --- a/data/reusables/actions/azure-vnet-next-steps-links.md +++ b/data/reusables/actions/azure-vnet-next-steps-links.md @@ -2,7 +2,7 @@ To use {% data variables.product.company_short %}-hosted runners with an Azure V {% ifversion fpt %} -For procedures to configure Azure private networking at the organization level, see "[AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization)." +For procedures to configure Azure private networking at the organization level, see [AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization). {% endif %} @@ -10,8 +10,8 @@ For procedures to configure Azure private networking at the organization level, {% data reusables.actions.azure-vnet-enterprise-policy %} -For procedures to configure Azure private networking at the enterprise level, see "[AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise)." +For procedures to configure Azure private networking at the enterprise level, see [AUTOTITLE](/admin/configuration/configuring-private-networking-for-hosted-compute-products/configuring-private-networking-for-github-hosted-runners-in-your-enterprise). -For procedures to configure Azure private networking at the organization level, see "[AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization)." +For procedures to configure Azure private networking at the organization level, see [AUTOTITLE](/organizations/managing-organization-settings/configuring-private-networking-for-github-hosted-runners-in-your-organization). {% endif %} diff --git a/data/reusables/actions/azure-vnet-procedures-prereqs.md b/data/reusables/actions/azure-vnet-procedures-prereqs.md index e868838f4708..209909becde6 100644 --- a/data/reusables/actions/azure-vnet-procedures-prereqs.md +++ b/data/reusables/actions/azure-vnet-procedures-prereqs.md @@ -12,10 +12,10 @@ You will use a script to automate configuring your Azure resources. The `.bicep` file we provide contains the minimal set of rules to use {% data variables.product.company_short %}-hosted runners with Azure VNET. You may need to add rules for your specific use case. - If you use {% data variables.enterprise.data_residency %}, in the `AllowOutBoundGitHub` section, you must also include the egress IP ranges for {% data variables.enterprise.data_residency_site %}. See "[AUTOTITLE](/admin/data-residency/network-details-for-ghecom#ranges-for-egress-traffic)." + If you use {% data variables.enterprise.data_residency %}, in the `AllowOutBoundGitHub` section, you must also include the egress IP ranges for {% data variables.enterprise.data_residency_site %}. See [AUTOTITLE](/admin/data-residency/network-details-for-ghecom#ranges-for-egress-traffic). > [!NOTE] - > As an alternative to using the following file, to allow {% data variables.product.prodname_actions %} to communicate with the runners, you can allow the same firewall domains that are required for communication between self-hosted runners and {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#communication-between-self-hosted-runners-and-github-enterprise-cloud)." To determine the appropriate subnet IP address range, we recommend adding a 30% buffer to the maximum job concurrency you anticipate. For instance, if your network configuration's runners are set to a maximum job concurrency of 300, it's recommended to utilize a subnet IP address range that can accommodate at least 390 runners. This buffer helps ensure that your network can handle unexpected increases in VM needs to meet job concurrency without running out of IP addresses. + > As an alternative to using the following file, to allow {% data variables.product.prodname_actions %} to communicate with the runners, you can allow the same firewall domains that are required for communication between self-hosted runners and {% data variables.product.product_name %}. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#communication-between-self-hosted-runners-and-github-enterprise-cloud). To determine the appropriate subnet IP address range, we recommend adding a 30% buffer to the maximum job concurrency you anticipate. For instance, if your network configuration's runners are set to a maximum job concurrency of 300, it's recommended to utilize a subnet IP address range that can accommodate at least 390 runners. This buffer helps ensure that your network can handle unexpected increases in VM needs to meet job concurrency without running out of IP addresses. ```bicep copy @description('NSG for outbound rules') diff --git a/data/reusables/actions/azure-vnet-supported-regions.md b/data/reusables/actions/azure-vnet-supported-regions.md index 7b7712b5bacd..5d38f727205e 100644 --- a/data/reusables/actions/azure-vnet-supported-regions.md +++ b/data/reusables/actions/azure-vnet-supported-regions.md @@ -1,6 +1,6 @@ The {% data variables.product.prodname_actions %} service supports a subset of all the regions that Azure provides. To facilitate communication between the {% data variables.product.prodname_actions %} service and your subnet, your subnet must be in one of the supported regions. -> [!NOTE] If you use {% data variables.enterprise.data_residency_short %} on {% data variables.enterprise.data_residency_site %}, the supported regions are different. See "[AUTOTITLE](/admin/data-residency/network-details-for-ghecom#supported-regions-for-azure-private-networking)." +> [!NOTE] If you use {% data variables.enterprise.data_residency_short %} on {% data variables.enterprise.data_residency_site %}, the supported regions are different. See [AUTOTITLE](/admin/data-residency/network-details-for-ghecom#supported-regions-for-azure-private-networking). The following regions are supported on {% data variables.product.prodname_dotcom_the_website %}. diff --git a/data/reusables/actions/cd-templates-actions.md b/data/reusables/actions/cd-templates-actions.md index 7e9cf34d8504..db3b02b47783 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 deployment workflow templates for several popular services, such as Azure Web App. To learn how to get started using a workflow template, see "[AUTOTITLE](/actions/learn-github-actions/using-starter-workflows)" 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 "[AUTOTITLE](/actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure/deploying-nodejs-to-azure-app-service)." +{% data variables.product.product_name %} offers deployment workflow templates for several popular services, such as Azure Web App. To learn how to get started using a workflow template, see [AUTOTITLE](/actions/learn-github-actions/using-starter-workflows) 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 [AUTOTITLE](/actions/deployment/deploying-to-your-cloud-provider/deploying-to-azure/deploying-nodejs-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/choose-repo.md b/data/reusables/actions/choose-repo.md index 0697e9cc6855..669cbc801168 100644 --- a/data/reusables/actions/choose-repo.md +++ b/data/reusables/actions/choose-repo.md @@ -1 +1 @@ -Choose a repository where you want to apply this project management workflow. You can use an existing repository that you have write access to, or you can create a new repository. For more information about creating a repository, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/creating-a-new-repository)." +Choose a repository where you want to apply this project management workflow. You can use an existing repository that you have write access to, or you can create a new repository. For more information about creating a repository, see [AUTOTITLE](/repositories/creating-and-managing-repositories/creating-a-new-repository). diff --git a/data/reusables/actions/commit-workflow.md b/data/reusables/actions/commit-workflow.md index e7192ed011a4..dca89c5f0386 100644 --- a/data/reusables/actions/commit-workflow.md +++ b/data/reusables/actions/commit-workflow.md @@ -1 +1 @@ -Commit your workflow file to the default branch of your repository. For more information, see "[AUTOTITLE](/repositories/working-with-files/managing-files/creating-new-files)." +Commit your workflow file to the default branch of your repository. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-files/creating-new-files). diff --git a/data/reusables/actions/context-injection-warning.md b/data/reusables/actions/context-injection-warning.md index 74c4d3dce0ee..1d2958cbd3a9 100644 --- a/data/reusables/actions/context-injection-warning.md +++ b/data/reusables/actions/context-injection-warning.md @@ -1,2 +1,2 @@ > [!WARNING] -> When creating workflows and actions, you should always consider whether your code might execute untrusted input from possible attackers. Certain contexts should be treated as untrusted input, as an attacker could insert their own malicious content. For more information, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#understanding-the-risk-of-script-injections)." +> When creating workflows and actions, you should always consider whether your code might execute untrusted input from possible attackers. Certain contexts should be treated as untrusted input, as an attacker could insert their own malicious content. For more information, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#understanding-the-risk-of-script-injections). diff --git a/data/reusables/actions/create-azure-app-plan.md b/data/reusables/actions/create-azure-app-plan.md index 9f3bec8aed90..3fc7e779b32c 100644 --- a/data/reusables/actions/create-azure-app-plan.md +++ b/data/reusables/actions/create-azure-app-plan.md @@ -13,5 +13,5 @@ See the Azure documentation for more information on using the [Azure CLI](https://docs.microsoft.com/cli/azure/): - * For authentication, see "[Sign in with Azure CLI](https://docs.microsoft.com/cli/azure/authenticate-azure-cli)." - * If you need to create a new resource group, see "[az group](https://docs.microsoft.com/cli/azure/group?view=azure-cli-latest#az_group_create)." + * For authentication, see [Sign in with Azure CLI](https://docs.microsoft.com/cli/azure/authenticate-azure-cli). + * If you need to create a new resource group, see [az group](https://docs.microsoft.com/cli/azure/group?view=azure-cli-latest#az_group_create). diff --git a/data/reusables/actions/create-azure-publish-profile.md b/data/reusables/actions/create-azure-publish-profile.md index b2d540aa1684..a476d06f89fc 100644 --- a/data/reusables/actions/create-azure-publish-profile.md +++ b/data/reusables/actions/create-azure-publish-profile.md @@ -1,5 +1,5 @@ 1. Configure an Azure publish profile and create an `AZURE_WEBAPP_PUBLISH_PROFILE` secret. - Generate your Azure deployment credentials using a publish profile. For more information, see "[Generate deployment credentials](https://docs.microsoft.com/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)" in the Azure documentation. + Generate your Azure deployment credentials using a publish profile. For more information, see [Generate deployment credentials](https://docs.microsoft.com/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials) in the Azure documentation. - In your {% data variables.product.prodname_dotcom %} repository, create a secret named `AZURE_WEBAPP_PUBLISH_PROFILE` that contains the contents of the publish profile. For more information on creating secrets, see "[AUTOTITLE](/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository)." + In your {% data variables.product.prodname_dotcom %} repository, create a secret named `AZURE_WEBAPP_PUBLISH_PROFILE` that contains the contents of the publish profile. For more information on creating secrets, see [AUTOTITLE](/actions/security-guides/using-secrets-in-github-actions#creating-secrets-for-a-repository). diff --git a/data/reusables/actions/creating-a-runner-group-for-an-enterprise.md b/data/reusables/actions/creating-a-runner-group-for-an-enterprise.md index 66f89442da0b..6b07063d03e1 100644 --- a/data/reusables/actions/creating-a-runner-group-for-an-enterprise.md +++ b/data/reusables/actions/creating-a-runner-group-for-an-enterprise.md @@ -9,7 +9,7 @@ Always include a security admonition above this procedure. This is either one of Enterprises can add their runners to groups for access management. Enterprises can create groups of runners that are accessible to specific organizations in the enterprise account{% ifversion restrict-groups-to-workflows %} or to specific workflows{% endif %}. Organization owners can then assign additional granular repository{% ifversion restrict-groups-to-workflows %} or workflow{% endif %} access policies to the enterprise runner groups. For information about how to create a runner group with the REST API, see the enterprise endpoints in the [{% data variables.product.prodname_actions %} REST API](/rest/actions#self-hosted-runner-groups). -If no group is specified during the registration process, runners are automatically added to a default group. You can later move the runner from the default group to a custom group. For more information, see "[Moving a runner to a group](#moving-a-runner-to-a-group)." +If no group is specified during the registration process, runners are automatically added to a default group. You can later move the runner from the default group to a custom group. For more information, see [Moving a runner to a group](#moving-a-runner-to-a-group). When creating a group, you must choose a policy that defines which organizations have access to the runner group. diff --git a/data/reusables/actions/creating-a-runner-group-for-an-organization.md b/data/reusables/actions/creating-a-runner-group-for-an-organization.md index 0061add99f36..6669be433ba3 100644 --- a/data/reusables/actions/creating-a-runner-group-for-an-organization.md +++ b/data/reusables/actions/creating-a-runner-group-for-an-organization.md @@ -8,13 +8,13 @@ Always include a security admonition above this procedure. This is either one of {% endcomment %} > [!NOTE] -> When creating a runner group, you must choose a policy that defines which repositories{% ifversion restrict-groups-to-workflows %} and workflows{% endif %} have access to the runner group. To change which repositories and workflows can access the runner group, organization owners{% ifversion custom-org-roles %} and users with the “Manage organization runners and runner groups” permission{% endif %} can set a policy for the organization. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#disabling-repository-level-self-hosted-runners)." +> When creating a runner group, you must choose a policy that defines which repositories{% ifversion restrict-groups-to-workflows %} and workflows{% endif %} have access to the runner group. To change which repositories and workflows can access the runner group, organization owners{% ifversion custom-org-roles %} and users with the “Manage organization runners and runner groups” permission{% endif %} can set a policy for the organization. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#disabling-repository-level-self-hosted-runners). -All organizations have a single default runner group. {% ifversion fpt %}Organization owners using the {% data variables.product.prodname_team %} plan{% else %}Organization owners{% ifversion custom-org-roles %} and users with the "Manage organization runners and runner groups" permission{% endif %}{% endif %} can create additional organization-level runner groups. {% ifversion custom-org-roles %}For more information about custom organization roles, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)."{% endif %} +All organizations have a single default runner group. {% ifversion fpt %}Organization owners using the {% data variables.product.prodname_team %} plan{% else %}Organization owners{% ifversion custom-org-roles %} and users with the "Manage organization runners and runner groups" permission{% endif %}{% endif %} can create additional organization-level runner groups. {% ifversion custom-org-roles %}For more information about custom organization roles, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).{% endif %} -If no group is specified during the registration process, runners are automatically added to the default group. You can later move the runner from the default group to a custom group. For more information, see "[Moving a runner to a group](#moving-a-runner-to-a-group)." +If no group is specified during the registration process, runners are automatically added to the default group. You can later move the runner from the default group to a custom group. For more information, see [Moving a runner to a group](#moving-a-runner-to-a-group). -For information about how to create a runner group with the REST API, see "[AUTOTITLE](/rest/actions#self-hosted-runner-groups)." +For information about how to create a runner group with the REST API, see [AUTOTITLE](/rest/actions#self-hosted-runner-groups). {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} diff --git a/data/reusables/actions/dependabot-version-updates-actions-caveats.md b/data/reusables/actions/dependabot-version-updates-actions-caveats.md index 09462d310b06..9c3902afbdef 100644 --- a/data/reusables/actions/dependabot-version-updates-actions-caveats.md +++ b/data/reusables/actions/dependabot-version-updates-actions-caveats.md @@ -1,3 +1,3 @@ * {% data variables.product.prodname_dependabot %} only supports updates to {% data variables.product.prodname_actions %} using the {% data variables.product.prodname_dotcom %} repository syntax, such as `{% data reusables.actions.action-checkout %}`. {% data variables.product.prodname_dependabot %} will ignore actions or reusable workflows referenced locally (for example, `./.github/actions/foo.yml`). * Docker Hub and {% data variables.product.prodname_registry %} {% data variables.product.prodname_container_registry %} URLs are currently not supported. For example, references to Docker container actions using `docker://` syntax aren't supported. -* {% data variables.product.prodname_dependabot %} supports both public and private repositories for {% data variables.product.prodname_actions %}. For private registry configuration options, see "`git`" in "[AUTOTITLE](/code-security/dependabot/working-with-dependabot/configuring-access-to-private-registries-for-dependabot#git)." +* {% data variables.product.prodname_dependabot %} supports both public and private repositories for {% data variables.product.prodname_actions %}. For private registry configuration options, see "`git`" in [AUTOTITLE](/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file#git). diff --git a/data/reusables/actions/dependabot-version-updates-for-actions.md b/data/reusables/actions/dependabot-version-updates-for-actions.md index b455eb36c9dc..3ee2df44ccba 100644 --- a/data/reusables/actions/dependabot-version-updates-for-actions.md +++ b/data/reusables/actions/dependabot-version-updates-for-actions.md @@ -1 +1 @@ -You can use {% data variables.product.prodname_dependabot %} to ensure that references to actions and reusable workflows used in your repository are kept up to date. Actions are often updated with bug fixes and new features to make automated processes faster, safer, and more reliable. {% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies as it does this automatically for you. For more information, see "[AUTOTITLE](/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot)" and "[AUTOTITLE](/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates)." +You can use {% data variables.product.prodname_dependabot %} to ensure that references to actions and reusable workflows used in your repository are kept up to date. Actions are often updated with bug fixes and new features to make automated processes faster, safer, and more reliable. {% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies as it does this automatically for you. For more information, see [AUTOTITLE](/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot) and [AUTOTITLE](/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates). diff --git a/data/reusables/actions/disable-selfhosted-runners-crossrefs.md b/data/reusables/actions/disable-selfhosted-runners-crossrefs.md index c5e31c92d4f9..2cc86e9ea8fb 100644 --- a/data/reusables/actions/disable-selfhosted-runners-crossrefs.md +++ b/data/reusables/actions/disable-selfhosted-runners-crossrefs.md @@ -1,5 +1,5 @@ {% ifversion ghec or ghes %}Enterprise owners and organization {% elsif fpt %}Organization {% endif %}owners can choose which repositories are allowed to create repository-level self-hosted runners. {% ifversion custom-org-roles %}Users with the “Manage organization runners and runner groups” permission can only choose which repositories are allowed to create repository-level self-hosted runners for repositories in your organization{% endif %}. -{% ifversion custom-org-roles %}For more information about custom organization roles, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)."{% endif %} +{% ifversion custom-org-roles %}For more information about custom organization roles, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).{% endif %} -For more information, see {% ifversion ghec or ghes %}"[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#disabling-repository-level-self-hosted-runners)" and {% endif %}"[AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners)." +For more information, see {% ifversion ghec or ghes %}[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise#disabling-repository-level-self-hosted-runners) and {% endif %}[AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners). diff --git a/data/reusables/actions/enabling-actions-metrics.md b/data/reusables/actions/enabling-actions-metrics.md index a16103819089..81f2b62b1824 100644 --- a/data/reusables/actions/enabling-actions-metrics.md +++ b/data/reusables/actions/enabling-actions-metrics.md @@ -1,3 +1,3 @@ ## Enabling access to {% data variables.product.prodname_actions %} metrics -Organization owners can create custom organization roles to allow people to view {% data variables.product.prodname_actions %} usage metrics for their organization. To provide users with access, select the "View organization Actions metrics" role when creating a custom organization role. For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)." +Organization owners can create custom organization roles to allow people to view {% data variables.product.prodname_actions %} usage metrics for their organization. To provide users with access, select the "View organization Actions metrics" role when creating a custom organization role. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles). diff --git a/data/reusables/actions/enterprise-common-prereqs.md b/data/reusables/actions/enterprise-common-prereqs.md index 58f1fdc84ca5..b394ba8eebc3 100644 --- a/data/reusables/actions/enterprise-common-prereqs.md +++ b/data/reusables/actions/enterprise-common-prereqs.md @@ -1,5 +1,5 @@ -* Review the hardware requirements for {% data variables.product.prodname_actions %}. For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations)." -* TLS must be configured for {% data variables.product.prodname_ghe_server %}'s domain. For more information, see "[AUTOTITLE](/admin/configuration/configuring-network-settings/configuring-tls)." +* Review the hardware requirements for {% data variables.product.prodname_actions %}. For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations). +* TLS must be configured for {% data variables.product.prodname_ghe_server %}'s domain. For more information, see [AUTOTITLE](/admin/configuration/configuring-network-settings/configuring-tls). > [!NOTE] > {% data reusables.actions.enterprise-self-signed-cert %} diff --git a/data/reusables/actions/enterprise-gcp-storage-credential-fields.md b/data/reusables/actions/enterprise-gcp-storage-credential-fields.md index 75d0036d40f4..359ae1e2e719 100644 --- a/data/reusables/actions/enterprise-gcp-storage-credential-fields.md +++ b/data/reusables/actions/enterprise-gcp-storage-credential-fields.md @@ -1,3 +1,3 @@ * **Service URL:** The service URL for your bucket. This is usually `https://storage.googleapis.com`. * **Bucket Name:** The name of your bucket. -* **HMAC Access Id and HMAC Secret:** The Google Cloud access ID and secret for your storage account. For more information, see "[Manage HMAC keys for service accounts](https://cloud.google.com/storage/docs/authentication/managing-hmackeys)" in the Google Cloud documentation. +* **HMAC Access Id and HMAC Secret:** The Google Cloud access ID and secret for your storage account. For more information, see [Manage HMAC keys for service accounts](https://cloud.google.com/storage/docs/authentication/managing-hmackeys) in the Google Cloud documentation. diff --git a/data/reusables/actions/enterprise-http-proxy.md b/data/reusables/actions/enterprise-http-proxy.md index bf4cc1b6504d..e9d722a9b92b 100644 --- a/data/reusables/actions/enterprise-http-proxy.md +++ b/data/reusables/actions/enterprise-http-proxy.md @@ -3,4 +3,4 @@ If you have an **HTTP Proxy Server** configured on {% data variables.product.git * You must add `.localhost`, `127.0.0.1`, and `::1` to the **HTTP Proxy Exclusion** list (in this order). * If your external storage location is not routable, then you must also add your external storage URL to the exclusion list. -For more information on changing your proxy settings, see "[AUTOTITLE](/admin/configuration/configuring-network-settings/configuring-an-outbound-web-proxy-server)." +For more information on changing your proxy settings, see [AUTOTITLE](/admin/configuration/configuring-network-settings/configuring-an-outbound-web-proxy-server). diff --git a/data/reusables/actions/enterprise-limit-actions-use.md b/data/reusables/actions/enterprise-limit-actions-use.md index be5b024087f3..f49aed364610 100644 --- a/data/reusables/actions/enterprise-limit-actions-use.md +++ b/data/reusables/actions/enterprise-limit-actions-use.md @@ -1 +1 @@ -After you enable {% data variables.product.prodname_github_connect %}, you can use policies to restrict which public actions can be used in repositories in your enterprise. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise)." +After you enable {% data variables.product.prodname_github_connect %}, you can use policies to restrict which public actions can be used in repositories in your enterprise. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-actions-in-your-enterprise). diff --git a/data/reusables/actions/enterprise-marketplace-actions.md b/data/reusables/actions/enterprise-marketplace-actions.md index 0f11e48f4df2..07b6b0b83270 100644 --- a/data/reusables/actions/enterprise-marketplace-actions.md +++ b/data/reusables/actions/enterprise-marketplace-actions.md @@ -1,6 +1,6 @@ {% ifversion ghes %} > [!NOTE] -> {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} may have limited access to actions on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_marketplace %}. For more information, see "[AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom)" and contact your {% data variables.product.prodname_enterprise %} site administrator. +> {% data variables.product.prodname_actions %} on {% data variables.product.prodname_ghe_server %} may have limited access to actions on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.product.prodname_marketplace %}. For more information, see [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom) and contact your {% data variables.product.prodname_enterprise %} site administrator. {% endif %} diff --git a/data/reusables/actions/enterprise-postinstall-nextsteps.md b/data/reusables/actions/enterprise-postinstall-nextsteps.md index f8a883fe09e5..382cb4f67df2 100644 --- a/data/reusables/actions/enterprise-postinstall-nextsteps.md +++ b/data/reusables/actions/enterprise-postinstall-nextsteps.md @@ -1,3 +1,3 @@ ## Next steps -After the configuration run has successfully completed, {% data variables.product.prodname_actions %} will be enabled on {% data variables.product.github %}. For your next steps, such as managing {% data variables.product.prodname_actions %} access permissions and adding self-hosted runners, return to "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#enabling-github-actions-with-your-storage-provider)." +After the configuration run has successfully completed, {% data variables.product.prodname_actions %} will be enabled on {% data variables.product.github %}. For your next steps, such as managing {% data variables.product.prodname_actions %} access permissions and adding self-hosted runners, return to [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#enabling-github-actions-with-your-storage-provider). diff --git a/data/reusables/actions/enterprise-s3-storage-credential-fields.md b/data/reusables/actions/enterprise-s3-storage-credential-fields.md index a489441ddd1d..9b66b32602b7 100644 --- a/data/reusables/actions/enterprise-s3-storage-credential-fields.md +++ b/data/reusables/actions/enterprise-s3-storage-credential-fields.md @@ -1,5 +1,5 @@ * **AWS Service URL:** The service URL for your bucket. For example, if your S3 bucket was created in the `us-west-2` region, this value should be `https://s3.us-west-2.amazonaws.com`. - For more information, see "[AWS service endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html)" in the AWS documentation. + For more information, see [AWS service endpoints](https://docs.aws.amazon.com/general/latest/gr/rande.html) in the AWS documentation. * **AWS S3 Bucket:** The name of your S3 bucket. * **AWS S3 Access Key and AWS S3 Secret Key:** The AWS access key ID and secret key for your bucket. diff --git a/data/reusables/actions/enterprise-setup-prereq.md b/data/reusables/actions/enterprise-setup-prereq.md index 9ac296ad5fd8..50f8d63ce73c 100644 --- a/data/reusables/actions/enterprise-setup-prereq.md +++ b/data/reusables/actions/enterprise-setup-prereq.md @@ -2,6 +2,6 @@ ### Using self-hosted runners on {% data variables.product.prodname_ghe_server %} -When using setup actions (such as `actions/setup-LANGUAGE`) on {% data variables.product.prodname_ghe_server %} with self-hosted runners, you might need to set up the tools cache on runners that do not have internet access. For more information, see "[AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)." +When using setup actions (such as `actions/setup-LANGUAGE`) on {% data variables.product.prodname_ghe_server %} with self-hosted runners, you might need to set up the tools cache on runners that do not have internet access. For more information, see [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access). {% endif %} diff --git a/data/reusables/actions/enterprise-storage-about.md b/data/reusables/actions/enterprise-storage-about.md index 1340778cdff0..c914cda08b66 100644 --- a/data/reusables/actions/enterprise-storage-about.md +++ b/data/reusables/actions/enterprise-storage-about.md @@ -1,3 +1,3 @@ ## About external storage for {% data variables.product.prodname_actions %} -{% data reusables.actions.enterprise-storage-contents %} For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#external-storage-requirements)." +{% data reusables.actions.enterprise-storage-contents %} For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#external-storage-requirements). diff --git a/data/reusables/actions/forked-write-permission.md b/data/reusables/actions/forked-write-permission.md index 40385b453b5e..d79fa4fb0846 100644 --- a/data/reusables/actions/forked-write-permission.md +++ b/data/reusables/actions/forked-write-permission.md @@ -1 +1 @@ -You can use the `permissions` key to add and remove read permissions for forked repositories, but typically you can't grant write access. The exception to this behavior is where an admin user has selected the **Send write tokens to workflows from pull requests** option in the {% data variables.product.prodname_actions %} settings. For more information, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#enabling-workflows-for-private-repository-forks)." +You can use the `permissions` key to add and remove read permissions for forked repositories, but typically you can't grant write access. The exception to this behavior is where an admin user has selected the **Send write tokens to workflows from pull requests** option in the {% data variables.product.prodname_actions %} settings. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#enabling-workflows-for-private-repository-forks). diff --git a/data/reusables/actions/gai-config-environment-variables.md b/data/reusables/actions/gai-config-environment-variables.md index 08754679f2e9..20bf3e178393 100644 --- a/data/reusables/actions/gai-config-environment-variables.md +++ b/data/reusables/actions/gai-config-environment-variables.md @@ -1 +1 @@ -{% data variables.product.prodname_actions_importer %} uses environment variables for its authentication configuration. These variables are set when following the configuration process using the `configure` command. For more information, see the "[Configuring credentials](#configuring-credentials)" section. +{% data variables.product.prodname_actions_importer %} uses environment variables for its authentication configuration. These variables are set when following the configuration process using the `configure` command. For more information, see the [Configuring credentials](#configuring-credentials) section. diff --git a/data/reusables/actions/gai-custom-transformers-rec.md b/data/reusables/actions/gai-custom-transformers-rec.md index 03d3206b2f4c..54f3d3bec34c 100644 --- a/data/reusables/actions/gai-custom-transformers-rec.md +++ b/data/reusables/actions/gai-custom-transformers-rec.md @@ -1 +1 @@ -If there is anything that {% data variables.product.prodname_actions_importer %} was not able to convert automatically, such as unknown build steps or a partially successful pipeline, you might want to create custom transformers to further customize the conversion process. For more information, see "[AUTOTITLE](/actions/migrating-to-github-actions/automated-migrations/extending-github-actions-importer-with-custom-transformers)." +If there is anything that {% data variables.product.prodname_actions_importer %} was not able to convert automatically, such as unknown build steps or a partially successful pipeline, you might want to create custom transformers to further customize the conversion process. For more information, see [AUTOTITLE](/actions/migrating-to-github-actions/automated-migrations/extending-github-actions-importer-with-custom-transformers). diff --git a/data/reusables/actions/gai-inspect-audit.md b/data/reusables/actions/gai-inspect-audit.md index 3281c5bc7f3e..b08333fef458 100644 --- a/data/reusables/actions/gai-inspect-audit.md +++ b/data/reusables/actions/gai-inspect-audit.md @@ -37,7 +37,7 @@ The "Manual tasks" section contains an overview of tasks that {% data variables. Listed below are some key terms that can appear in the "Manual tasks" section: -* A **secret** is a repository or organization-level secret that is used in the converted pipelines. These secrets must be created manually in {% data variables.product.prodname_actions %} for these pipelines to function properly. For more information, see "[AUTOTITLE](/actions/security-guides/using-secrets-in-github-actions)." +* A **secret** is a repository or organization-level secret that is used in the converted pipelines. These secrets must be created manually in {% data variables.product.prodname_actions %} for these pipelines to function properly. For more information, see [AUTOTITLE](/actions/security-guides/using-secrets-in-github-actions). * A **self-hosted runner** refers to a label of a runner that is referenced in a converted pipeline that is not a {% data variables.product.prodname_dotcom %}-hosted runner. You will need to manually define these runners for these pipelines to function properly. #### Files diff --git a/data/reusables/actions/general-security-hardening.md b/data/reusables/actions/general-security-hardening.md index d978bee46b02..b9d9a85bc65b 100644 --- a/data/reusables/actions/general-security-hardening.md +++ b/data/reusables/actions/general-security-hardening.md @@ -1,3 +1,3 @@ ## General security hardening for {% data variables.product.prodname_actions %} -If you want to learn more about security practices for {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions)." +If you want to learn more about security practices for {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions). diff --git a/data/reusables/actions/github-hosted-runners-check-concurrency.md b/data/reusables/actions/github-hosted-runners-check-concurrency.md index 3f5363640633..ecb3f5854348 100644 --- a/data/reusables/actions/github-hosted-runners-check-concurrency.md +++ b/data/reusables/actions/github-hosted-runners-check-concurrency.md @@ -1 +1 @@ -To identify any constraints with concurrency or queuing, you can check how many jobs are currently being processed on the {% data variables.product.prodname_dotcom %}-hosted runners in your organization or enterprise. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/monitoring-your-current-jobs)." +To identify any constraints with concurrency or queuing, you can check how many jobs are currently being processed on the {% data variables.product.prodname_dotcom %}-hosted runners in your organization or enterprise. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/monitoring-your-current-jobs). diff --git a/data/reusables/actions/github-token-permissions.md b/data/reusables/actions/github-token-permissions.md index 11d2ada1c33d..46f61bc10bed 100644 --- a/data/reusables/actions/github-token-permissions.md +++ b/data/reusables/actions/github-token-permissions.md @@ -1 +1 @@ -The `GITHUB_TOKEN` secret is set to an access token for the repository each time a job in a workflow begins. You should set the permissions for this access token in the workflow file to grant read access for the `contents` permission and write access for the `packages` permission. For more information, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication)." +The `GITHUB_TOKEN` secret is set to an access token for the repository each time a job in a workflow begins. You should set the permissions for this access token in the workflow file to grant read access for the `contents` permission and write access for the `packages` permission. For more information, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication). diff --git a/data/reusables/actions/github-token-scope-descriptions.md b/data/reusables/actions/github-token-scope-descriptions.md index cd759c2c22e8..cfb25b3a4329 100644 --- a/data/reusables/actions/github-token-scope-descriptions.md +++ b/data/reusables/actions/github-token-scope-descriptions.md @@ -4,23 +4,23 @@ Available permissions and details of what each allows an action to do: | Permission | Allows an action using `GITHUB_TOKEN` to | | --- | --- | -| `actions` | Work with GitHub Actions. For example, `actions: write` permits an action to cancel a workflow run. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-actions)." | +| `actions` | Work with GitHub Actions. For example, `actions: write` permits an action to cancel a workflow run. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-actions). | | {% ifversion artifact-attestations %} | -| `attestations` | Work with artifact attestations. For example, `attestations: write` permits an action to generate an artifact attestation for a build. For more information, see "[AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds)" | +| `attestations` | Work with artifact attestations. For example, `attestations: write` permits an action to generate an artifact attestation for a build. For more information, see [AUTOTITLE](/actions/security-guides/using-artifact-attestations-to-establish-provenance-for-builds) | | {% endif %} | -| `checks` | Work with check runs and check suites. For example, `checks: write` permits an action to create a check run. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-checks)." | -| `contents` | Work with the contents of the repository. For example, `contents: read` permits an action to list the commits, and `contents: write` allows the action to create a release. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-contents)." | -| `deployments` | Work with deployments. For example, `deployments: write` permits an action to create a new deployment. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-deployments)." | +| `checks` | Work with check runs and check suites. For example, `checks: write` permits an action to create a check run. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-checks). | +| `contents` | Work with the contents of the repository. For example, `contents: read` permits an action to list the commits, and `contents: write` allows the action to create a release. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-contents). | +| `deployments` | Work with deployments. For example, `deployments: write` permits an action to create a new deployment. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-deployments). | | {% ifversion discussions %} | -| `discussions` | Work with GitHub Discussions. For example, `discussions: write` permits an action to close or delete a discussion. For more information, see "[AUTOTITLE](/graphql/guides/using-the-graphql-api-for-discussions)." | +| `discussions` | Work with GitHub Discussions. For example, `discussions: write` permits an action to close or delete a discussion. For more information, see [AUTOTITLE](/graphql/guides/using-the-graphql-api-for-discussions). | | {% endif %} | | {% ifversion fpt or ghec %} | -| `id-token` | Fetch an OpenID Connect (OIDC) token. This requires `id-token: write`. For more information, see "[AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#updating-your-actions-for-oidc)" | +| `id-token` | Fetch an OpenID Connect (OIDC) token. This requires `id-token: write`. For more information, see [AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#updating-your-actions-for-oidc) | | {% endif %} | -| `issues` | Work with issues. For example, `issues: write` permits an action to add a comment to an issue. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-issues)." | -| `packages` | Work with GitHub Packages. For example, `packages: write` permits an action to upload and publish packages on GitHub Packages. For more information, see "[AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries)." | -| `pages` | Work with GitHub Pages. For example, `pages: write` permits an action to request a GitHub Pages build. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-pages)." | -| `pull-requests` | Work with pull requests. For example, `pull-requests: write` permits an action to add a label to a pull request. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-pull-requests)." | -| `repository-projects` | Work with GitHub projects (classic). For example, `repository-projects: write` permits an action to add a column to a project (classic). For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-projects)." | -| `security-events` | Work with GitHub code scanning and Dependabot alerts. For example, `security-events: read` permits an action to list the Dependabot alerts for the repository, and `security-events: write` allows an action to update the status of a code scanning alert. For more information, see "[Repository permissions for 'Code scanning alerts'](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-code-scanning-alerts)" and "[Repository permissions for 'Dependabot alerts'](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-dependabot-alerts)" in "Permissions required for GitHub Apps." | -| `statuses` | Work with commit statuses. For example, `statuses:read` permits an action to list the commit statuses for a given reference. For more information, see "[AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-commit-statuses)." | +| `issues` | Work with issues. For example, `issues: write` permits an action to add a comment to an issue. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-issues). | +| `packages` | Work with GitHub Packages. For example, `packages: write` permits an action to upload and publish packages on GitHub Packages. For more information, see [AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries). | +| `pages` | Work with GitHub Pages. For example, `pages: write` permits an action to request a GitHub Pages build. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-pages). | +| `pull-requests` | Work with pull requests. For example, `pull-requests: write` permits an action to add a label to a pull request. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-pull-requests). | +| `repository-projects` | Work with GitHub projects (classic). For example, `repository-projects: write` permits an action to add a column to a project (classic). For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-projects). | +| `security-events` | Work with GitHub code scanning and Dependabot alerts. For example, `security-events: read` permits an action to list the Dependabot alerts for the repository, and `security-events: write` allows an action to update the status of a code scanning alert. For more information, see [Repository permissions for 'Code scanning alerts'](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-code-scanning-alerts) and [Repository permissions for 'Dependabot alerts'](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-dependabot-alerts) in "Permissions required for GitHub Apps." | +| `statuses` | Work with commit statuses. For example, `statuses:read` permits an action to list the commit statuses for a given reference. For more information, see [AUTOTITLE](/rest/overview/permissions-required-for-github-apps?apiVersion=2022-11-28#repository-permissions-for-commit-statuses). | diff --git a/data/reusables/actions/github_sha_description.md b/data/reusables/actions/github_sha_description.md index 80388d0ae8be..e12ca87925e4 100644 --- a/data/reusables/actions/github_sha_description.md +++ b/data/reusables/actions/github_sha_description.md @@ -1 +1 @@ -The commit SHA that triggered the workflow. The value of this commit SHA depends on the event that triggered the workflow. For more information, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows)." For example, `ffac537e6cbbf934b08745a378932722df287a53`. +The commit SHA that triggered the workflow. The value of this commit SHA depends on the event that triggered the workflow. For more information, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows). For example, `ffac537e6cbbf934b08745a378932722df287a53`. diff --git a/data/reusables/actions/if-supported-contexts.md b/data/reusables/actions/if-supported-contexts.md index 100fdcde3663..a804cb5a23fd 100644 --- a/data/reusables/actions/if-supported-contexts.md +++ b/data/reusables/actions/if-supported-contexts.md @@ -1 +1 @@ -You can use any supported context and expression to create a conditional. For more information on which contexts are supported in this key, see "[AUTOTITLE](/actions/learn-github-actions/contexts#context-availability)." +You can use any supported context and expression to create a conditional. For more information on which contexts are supported in this key, see [AUTOTITLE](/actions/learn-github-actions/contexts#context-availability). diff --git a/data/reusables/actions/internal-actions-summary.md b/data/reusables/actions/internal-actions-summary.md index 9d4a6bfa4972..7a28a150627b 100644 --- a/data/reusables/actions/internal-actions-summary.md +++ b/data/reusables/actions/internal-actions-summary.md @@ -1,3 +1,3 @@ {% ifversion internal-actions %} -To share actions across your enterprise without publishing the actions publicly, you can store the actions in an internal repository, then configure the repository to allow access to {% data variables.product.prodname_actions %} workflows in other repositories owned by the same organization or by any organization in the enterprise. For more information, see "[AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise)." +To share actions across your enterprise without publishing the actions publicly, you can store the actions in an internal repository, then configure the repository to allow access to {% data variables.product.prodname_actions %} workflows in other repositories owned by the same organization or by any organization in the enterprise. For more information, see [AUTOTITLE](/actions/creating-actions/sharing-actions-and-workflows-with-your-enterprise). {% endif %} diff --git a/data/reusables/actions/introducing-enterprise.md b/data/reusables/actions/introducing-enterprise.md index 19479ed3bf1e..ff371e61719a 100644 --- a/data/reusables/actions/introducing-enterprise.md +++ b/data/reusables/actions/introducing-enterprise.md @@ -1 +1 @@ -Before you get started, you should make a plan for how you'll introduce {% data variables.product.prodname_actions %} to your enterprise. For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise)." +Before you get started, you should make a plan for how you'll introduce {% data variables.product.prodname_actions %} to your enterprise. For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/introducing-github-actions-to-your-enterprise). diff --git a/data/reusables/actions/ip-allow-list-self-hosted-runners.md b/data/reusables/actions/ip-allow-list-self-hosted-runners.md index 66c042b14853..3282b0f1d08d 100644 --- a/data/reusables/actions/ip-allow-list-self-hosted-runners.md +++ b/data/reusables/actions/ip-allow-list-self-hosted-runners.md @@ -1,4 +1,4 @@ > [!WARNING] -> If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with static IP address ranges{% endif %}. When using [Azure private networking](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise), IPs from your Azure subnet must be used. To reduce the number of required IPs, we recommend creating a load balancer to provide a single IP range for the GitHub allow list. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners)" {% ifversion actions-hosted-runners %} or "[AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners)"{% endif %}. +> If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with static IP address ranges{% endif %}. When using [Azure private networking](/admin/configuration/configuring-private-networking-for-hosted-compute-products/about-azure-private-networking-for-github-hosted-runners-in-your-enterprise), IPs from your Azure subnet must be used. To reduce the number of required IPs, we recommend creating a load balancer to provide a single IP range for the GitHub allow list. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners) {% ifversion actions-hosted-runners %} or [AUTOTITLE](/actions/using-github-hosted-runners/using-larger-runners/about-larger-runners){% endif %}. To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list that you have configured for your enterprise. diff --git a/data/reusables/actions/jobs/choosing-runner-github-hosted.md b/data/reusables/actions/jobs/choosing-runner-github-hosted.md index 143e84c867a9..a89a1284afb5 100644 --- a/data/reusables/actions/jobs/choosing-runner-github-hosted.md +++ b/data/reusables/actions/jobs/choosing-runner-github-hosted.md @@ -6,11 +6,11 @@ If you use a {% data variables.product.prodname_dotcom %}-hosted runner, each jo The value for runs-on, when you are using a {% data variables.product.prodname_dotcom %}-hosted runner, is a runner label or the name of a runner group. The labels for the standard {% data variables.product.prodname_dotcom %}-hosted runners are shown in the following tables. -For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners)." +For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners). {% data reusables.actions.supported-github-runners %} -In addition to the standard {% data variables.product.prodname_dotcom %}-hosted runners, {% data variables.product.prodname_dotcom %} offers customers on {% data variables.product.prodname_team %} and {% data variables.product.prodname_ghe_cloud %} plans a range of managed virtual machines with advanced features - for example, more cores and disk space, GPU-powered machines, and ARM-powered machines. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/about-larger-runners)." +In addition to the standard {% data variables.product.prodname_dotcom %}-hosted runners, {% data variables.product.prodname_dotcom %} offers customers on {% data variables.product.prodname_team %} and {% data variables.product.prodname_ghe_cloud %} plans a range of managed virtual machines with advanced features - for example, more cores and disk space, GPU-powered machines, and ARM-powered machines. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/about-larger-runners). > [!NOTE] > The `-latest` runner images are the latest stable images that {% data variables.product.prodname_dotcom %} provides, and might not be the most recent version of the operating system available from the operating system vendor. @@ -24,6 +24,6 @@ In addition to the standard {% data variables.product.prodname_dotcom %}-hosted runs-on: ubuntu-latest ``` -For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners)." +For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners). {% endif %} diff --git a/data/reusables/actions/jobs/choosing-runner-overview.md b/data/reusables/actions/jobs/choosing-runner-overview.md index c4c386ac5cbd..c0914974bfe5 100644 --- a/data/reusables/actions/jobs/choosing-runner-overview.md +++ b/data/reusables/actions/jobs/choosing-runner-overview.md @@ -15,7 +15,7 @@ Use `jobs..runs-on` to define the type of machine to run the job on. runs-on: [self-hosted, linux, x64, gpu] ``` - For more information, see "[Choosing self-hosted runners](#choosing-self-hosted-runners)." + For more information, see [Choosing self-hosted runners](#choosing-self-hosted-runners). * You can mix strings and variables in an array. For example: {% raw %} diff --git a/data/reusables/actions/jobs/choosing-runner-self-hosted.md b/data/reusables/actions/jobs/choosing-runner-self-hosted.md index 9903fdb415f9..6632240cf0c6 100644 --- a/data/reusables/actions/jobs/choosing-runner-self-hosted.md +++ b/data/reusables/actions/jobs/choosing-runner-self-hosted.md @@ -6,4 +6,4 @@ runs-on: [self-hosted, linux] ``` -For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners)" and "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow)." +For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners) and [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow). diff --git a/data/reusables/actions/jobs/matrix-from-context.md b/data/reusables/actions/jobs/matrix-from-context.md index c6d8eebad588..6a787303be84 100644 --- a/data/reusables/actions/jobs/matrix-from-context.md +++ b/data/reusables/actions/jobs/matrix-from-context.md @@ -1,6 +1,6 @@ -You can use contexts to create matrices. For more information about contexts, see "[AUTOTITLE](/actions/learn-github-actions/contexts)." +You can use contexts to create matrices. For more information about contexts, see [AUTOTITLE](/actions/learn-github-actions/contexts). -For example, the following workflow triggers on the `repository_dispatch` event and uses information from the event payload to build the matrix. When a repository dispatch event is created with a payload like the one below, the matrix `version` variable will have a value of `[12, 14, 16]`. For more information about the `repository_dispatch` trigger, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#repository_dispatch)." +For example, the following workflow triggers on the `repository_dispatch` event and uses information from the event payload to build the matrix. When a repository dispatch event is created with a payload like the one below, the matrix `version` variable will have a value of `[12, 14, 16]`. For more information about the `repository_dispatch` trigger, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#repository_dispatch). ```json { diff --git a/data/reusables/actions/jobs/section-assigning-permissions-to-jobs-specific.md b/data/reusables/actions/jobs/section-assigning-permissions-to-jobs-specific.md index 0b862c0319b3..0743ff4545f3 100644 --- a/data/reusables/actions/jobs/section-assigning-permissions-to-jobs-specific.md +++ b/data/reusables/actions/jobs/section-assigning-permissions-to-jobs-specific.md @@ -1,3 +1,3 @@ -For a specific job, you can use `jobs..permissions` to modify the default permissions granted to the `GITHUB_TOKEN`, adding or removing access as required, so that you only allow the minimum required access. For more information, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)." +For a specific job, you can use `jobs..permissions` to modify the default permissions granted to the `GITHUB_TOKEN`, adding or removing access as required, so that you only allow the minimum required access. For more information, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token). By specifying the permission within a job definition, you can configure a different set of permissions for the `GITHUB_TOKEN` for each job, if required. Alternatively, you can specify the permissions for all jobs in the workflow. For information on defining permissions at the workflow level, see [`permissions`](/actions/using-workflows/workflow-syntax-for-github-actions#permissions). diff --git a/data/reusables/actions/jobs/section-assigning-permissions-to-jobs.md b/data/reusables/actions/jobs/section-assigning-permissions-to-jobs.md index d039bf637c7e..d3b06fd0b72c 100644 --- a/data/reusables/actions/jobs/section-assigning-permissions-to-jobs.md +++ b/data/reusables/actions/jobs/section-assigning-permissions-to-jobs.md @@ -1,4 +1,4 @@ -You can use `permissions` to modify the default permissions granted to the `GITHUB_TOKEN`, adding or removing access as required, so that you only allow the minimum required access. For more information, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token)." +You can use `permissions` to modify the default permissions granted to the `GITHUB_TOKEN`, adding or removing access as required, so that you only allow the minimum required access. For more information, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token). You can use `permissions` either as a top-level key, to apply to all jobs in the workflow, or within specific jobs. When you add the `permissions` key within a specific job, all actions and run commands within that job that use the `GITHUB_TOKEN` gain the access rights you specify. For more information, see [`jobs..permissions`](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idpermissions). diff --git a/data/reusables/actions/jobs/section-defining-outputs-for-jobs.md b/data/reusables/actions/jobs/section-defining-outputs-for-jobs.md index cea54e513404..114ef1a9d0b4 100644 --- a/data/reusables/actions/jobs/section-defining-outputs-for-jobs.md +++ b/data/reusables/actions/jobs/section-defining-outputs-for-jobs.md @@ -6,7 +6,7 @@ Job outputs containing expressions are evaluated on the runner at the end of eac If an output is skipped because it may contain a secret, you will see the following warning message: "Skip output `{output.Key}` since it may contain secret." For more information on how to handle secrets, please refer to the [Example: Masking and passing a secret between jobs or workflows](/actions/writing-workflows/choosing-what-your-workflow-does/workflow-commands-for-github-actions#example-masking-and-passing-a-secret-between-jobs-or-workflows). -To use job outputs in a dependent job, you can use the `needs` context. For more information, see "[AUTOTITLE](/actions/learn-github-actions/contexts#needs-context)." +To use job outputs in a dependent job, you can use the `needs` context. For more information, see [AUTOTITLE](/actions/learn-github-actions/contexts#needs-context). ### Example: Defining outputs for a job diff --git a/data/reusables/actions/jobs/section-running-jobs-in-a-container-options.md b/data/reusables/actions/jobs/section-running-jobs-in-a-container-options.md index 6f67d9f38203..aaa329d00631 100644 --- a/data/reusables/actions/jobs/section-running-jobs-in-a-container-options.md +++ b/data/reusables/actions/jobs/section-running-jobs-in-a-container-options.md @@ -1,4 +1,4 @@ -Use `jobs..container.options` to configure additional Docker container resource options. For a list of options, see "[`docker create` options](https://docs.docker.com/engine/reference/commandline/create/#options)." +Use `jobs..container.options` to configure additional Docker container resource options. For a list of options, see [`docker create` options](https://docs.docker.com/engine/reference/commandline/create/#options). > [!WARNING] > The `--network` and `--entrypoint` options are not supported. diff --git a/data/reusables/actions/jobs/section-using-concurrency-jobs.md b/data/reusables/actions/jobs/section-using-concurrency-jobs.md index 9bda5ba7d4e6..71620124d1a9 100644 --- a/data/reusables/actions/jobs/section-using-concurrency-jobs.md +++ b/data/reusables/actions/jobs/section-using-concurrency-jobs.md @@ -1,4 +1,4 @@ -You can use `jobs..concurrency` to ensure that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. Allowed expression contexts: [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context), [`vars`](/actions/learn-github-actions/contexts#vars-context), [`needs`](/actions/learn-github-actions/contexts#needs-context), [`strategy`](/actions/learn-github-actions/contexts#strategy-context), and [`matrix`](/actions/learn-github-actions/contexts#matrix-context). For more information about expressions, see "[AUTOTITLE](/actions/learn-github-actions/expressions)." +You can use `jobs..concurrency` to ensure that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. Allowed expression contexts: [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context), [`vars`](/actions/learn-github-actions/contexts#vars-context), [`needs`](/actions/learn-github-actions/contexts#needs-context), [`strategy`](/actions/learn-github-actions/contexts#strategy-context), and [`matrix`](/actions/learn-github-actions/contexts#matrix-context). For more information about expressions, see [AUTOTITLE](/actions/learn-github-actions/expressions). You can also specify `concurrency` at the workflow level. For more information, see [`concurrency`](/actions/using-workflows/workflow-syntax-for-github-actions#concurrency). diff --git a/data/reusables/actions/jobs/section-using-concurrency.md b/data/reusables/actions/jobs/section-using-concurrency.md index 2a253f86be3f..f700f04430c7 100644 --- a/data/reusables/actions/jobs/section-using-concurrency.md +++ b/data/reusables/actions/jobs/section-using-concurrency.md @@ -1,4 +1,4 @@ -Use `concurrency` to ensure that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. The expression can only use [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context) and [`vars`](/actions/learn-github-actions/contexts#vars-context) contexts. For more information about expressions, see "[AUTOTITLE](/actions/learn-github-actions/expressions)." +Use `concurrency` to ensure that only a single job or workflow using the same concurrency group will run at a time. A concurrency group can be any string or expression. The expression can only use [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context) and [`vars`](/actions/learn-github-actions/contexts#vars-context) contexts. For more information about expressions, see [AUTOTITLE](/actions/learn-github-actions/expressions). You can also specify `concurrency` at the job level. For more information, see [`jobs..concurrency`](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idconcurrency). diff --git a/data/reusables/actions/jobs/section-using-conditions-to-control-job-execution.md b/data/reusables/actions/jobs/section-using-conditions-to-control-job-execution.md index 813c8d772a74..277f46b94620 100644 --- a/data/reusables/actions/jobs/section-using-conditions-to-control-job-execution.md +++ b/data/reusables/actions/jobs/section-using-conditions-to-control-job-execution.md @@ -3,7 +3,7 @@ You can use the `jobs..if` conditional to prevent a job from running unl > [!NOTE] > The `jobs..if` condition is evaluated before [`jobs..strategy.matrix`](/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix) is applied. -{% data reusables.actions.expression-syntax-if %} For more information, see "[AUTOTITLE](/actions/learn-github-actions/expressions)." +{% data reusables.actions.expression-syntax-if %} For more information, see [AUTOTITLE](/actions/learn-github-actions/expressions). ### Example: Only run job for specific repository diff --git a/data/reusables/actions/jobs/section-using-environments-for-jobs.md b/data/reusables/actions/jobs/section-using-environments-for-jobs.md index 06492566e15a..c00afc34ea35 100644 --- a/data/reusables/actions/jobs/section-using-environments-for-jobs.md +++ b/data/reusables/actions/jobs/section-using-environments-for-jobs.md @@ -1,9 +1,9 @@ Use `jobs..environment` to define the environment that the job references. -You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see "[AUTOTITLE](/rest/repos#deployments)." +You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see [AUTOTITLE](/rest/repos#deployments). > [!NOTE] -> All deployment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see "[AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment)." +> All deployment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment). ### Example: Using a single environment name @@ -23,7 +23,7 @@ environment: url: https://github.com ``` -The value of `url` can be an expression. Allowed expression contexts: [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context), [`vars`](/actions/learn-github-actions/contexts#vars-context), [`needs`](/actions/learn-github-actions/contexts#needs-context), [`strategy`](/actions/learn-github-actions/contexts#strategy-context), [`matrix`](/actions/learn-github-actions/contexts#matrix-context), [`job`](/actions/learn-github-actions/contexts#job-context), [`runner`](/actions/learn-github-actions/contexts#runner-context), [`env`](/actions/learn-github-actions/contexts#env-context), and [`steps`](/actions/learn-github-actions/contexts#steps-context). For more information about expressions, see "[AUTOTITLE](/actions/learn-github-actions/expressions)." +The value of `url` can be an expression. Allowed expression contexts: [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context), [`vars`](/actions/learn-github-actions/contexts#vars-context), [`needs`](/actions/learn-github-actions/contexts#needs-context), [`strategy`](/actions/learn-github-actions/contexts#strategy-context), [`matrix`](/actions/learn-github-actions/contexts#matrix-context), [`job`](/actions/learn-github-actions/contexts#job-context), [`runner`](/actions/learn-github-actions/contexts#runner-context), [`env`](/actions/learn-github-actions/contexts#env-context), and [`steps`](/actions/learn-github-actions/contexts#steps-context). For more information about expressions, see [AUTOTITLE](/actions/learn-github-actions/expressions). ### Example: Using output as URL @@ -37,7 +37,7 @@ environment: {% endraw %} -The value of `name` can be an expression. Allowed expression contexts: [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context), [`vars`](/actions/learn-github-actions/contexts#vars-context), [`needs`](/actions/learn-github-actions/contexts#needs-context), [`strategy`](/actions/learn-github-actions/contexts#strategy-context), and [`matrix`](/actions/learn-github-actions/contexts#matrix-context). For more information about expressions, see "[AUTOTITLE](/actions/learn-github-actions/expressions)." +The value of `name` can be an expression. Allowed expression contexts: [`github`](/actions/learn-github-actions/contexts#github-context), [`inputs`](/actions/learn-github-actions/contexts#inputs-context), [`vars`](/actions/learn-github-actions/contexts#vars-context), [`needs`](/actions/learn-github-actions/contexts#needs-context), [`strategy`](/actions/learn-github-actions/contexts#strategy-context), and [`matrix`](/actions/learn-github-actions/contexts#matrix-context). For more information about expressions, see [AUTOTITLE](/actions/learn-github-actions/expressions). ### Example: Using an expression as environment name diff --git a/data/reusables/actions/jobs/section-using-jobs-in-a-workflow-needs.md b/data/reusables/actions/jobs/section-using-jobs-in-a-workflow-needs.md index ca2221dc5d1f..f18cc1d3e831 100644 --- a/data/reusables/actions/jobs/section-using-jobs-in-a-workflow-needs.md +++ b/data/reusables/actions/jobs/section-using-jobs-in-a-workflow-needs.md @@ -31,4 +31,4 @@ jobs: needs: [job1, job2] ``` -In this example, `job3` uses the `always()` conditional expression so that it always runs after `job1` and `job2` have completed, regardless of whether they were successful. For more information, see "[AUTOTITLE](/actions/learn-github-actions/expressions#status-check-functions)." +In this example, `job3` uses the `always()` conditional expression so that it always runs after `job1` and `job2` have completed, regardless of whether they were successful. For more information, see [AUTOTITLE](/actions/learn-github-actions/expressions#status-check-functions). diff --git a/data/reusables/actions/jobs/section-using-jobs-in-a-workflow.md b/data/reusables/actions/jobs/section-using-jobs-in-a-workflow.md index 048ad31d2151..6fc377b96374 100644 --- a/data/reusables/actions/jobs/section-using-jobs-in-a-workflow.md +++ b/data/reusables/actions/jobs/section-using-jobs-in-a-workflow.md @@ -2,6 +2,6 @@ A workflow run is made up of one or more `jobs`, which run in parallel by defaul Each job runs in a runner environment specified by `runs-on`. -You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see "[AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration)" for {% data variables.product.prodname_dotcom %}-hosted runners and "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#usage-limits)" for self-hosted runner usage limits. +You can run an unlimited number of jobs as long as you are within the workflow usage limits. For more information, see [AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration) for {% data variables.product.prodname_dotcom %}-hosted runners and [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#usage-limits) for self-hosted runner usage limits. -If you need to find the unique identifier of a job running in a workflow run, you can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API. For more information, see "[AUTOTITLE](/rest/actions#workflow-jobs)." +If you need to find the unique identifier of a job running in a workflow run, you can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API. For more information, see [AUTOTITLE](/rest/actions#workflow-jobs). diff --git a/data/reusables/actions/jobs/using-matrix-strategy.md b/data/reusables/actions/jobs/using-matrix-strategy.md index cc96b6e80a3b..de7dd27df5e4 100644 --- a/data/reusables/actions/jobs/using-matrix-strategy.md +++ b/data/reusables/actions/jobs/using-matrix-strategy.md @@ -22,4 +22,4 @@ By default, {% data variables.product.product_name %} will maximize the number o A matrix will generate a maximum of 256 jobs per workflow run. This limit applies to both {% data variables.product.product_name %}-hosted and self-hosted runners. -The variables that you define become properties in the `matrix` context, and you can reference the property in other areas of your workflow file. In this example, you can use `matrix.version` and `matrix.os` to access the current value of `version` and `os` that the job is using. For more information, see "[AUTOTITLE](/actions/learn-github-actions/contexts)." +The variables that you define become properties in the `matrix` context, and you can reference the property in other areas of your workflow file. In this example, you can use `matrix.version` and `matrix.os` to access the current value of `version` and `os` that the job is using. For more information, see [AUTOTITLE](/actions/learn-github-actions/contexts). diff --git a/data/reusables/actions/larger-runner-name-note.md b/data/reusables/actions/larger-runner-name-note.md index 7c78d5d5f929..6a310f9b0581 100644 --- a/data/reusables/actions/larger-runner-name-note.md +++ b/data/reusables/actions/larger-runner-name-note.md @@ -1,2 +1,2 @@ > [!NOTE] -> The names of {% data variables.actions.hosted_runners %} can dictate their functionality. For example, to use a {% data variables.actions.hosted_runner %} for {% data variables.product.prodname_code_scanning %} default setup, the runner must be named `code-scanning`. For more information on {% data variables.product.prodname_code_scanning %} with {% data variables.actions.hosted_runners %}, see "[AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/configuring-larger-runners-for-default-setup)." +> The names of {% data variables.actions.hosted_runners %} can dictate their functionality. For example, to use a {% data variables.actions.hosted_runner %} for {% data variables.product.prodname_code_scanning %} default setup, the runner must be named `code-scanning`. For more information on {% data variables.product.prodname_code_scanning %} with {% data variables.actions.hosted_runners %}, see [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/configuring-larger-runners-for-default-setup). diff --git a/data/reusables/actions/larger-runners-troubleshooting-linux-windows.md b/data/reusables/actions/larger-runners-troubleshooting-linux-windows.md index e6f4f9ae0e42..675d813825c9 100644 --- a/data/reusables/actions/larger-runners-troubleshooting-linux-windows.md +++ b/data/reusables/actions/larger-runners-troubleshooting-linux-windows.md @@ -1,8 +1,8 @@ If you notice the jobs that target your {% data variables.actions.hosted_runner %}s are delayed or not running, there are several factors that may be causing this. -* **Concurrency settings:** You may have reached your maximum concurrency limit. If you would like to enable more jobs to run in parallel, you can update your autoscaling settings to a larger number. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#configuring-autoscaling-for-larger-runners)." -* **Repository permissions:** Ensure you have the appropriate repository permissions enabled for your {% data variables.actions.hosted_runner %}s. By default, enterprise runners are not available at the repository level and must be manually enabled by an organization administrator. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#allowing-repositories-to-access-larger-runners)." -* **Billing information:** You must have a valid credit card on file in order to use {% data variables.actions.hosted_runner %}s. After adding a credit card to your account, it can take up to 10 minutes to enable the use of your {% data variables.actions.hosted_runner %}s. For more information, see "[AUTOTITLE](/billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method)." -* **Spending limit:** Your {% data variables.product.prodname_actions %} spending limit must be set to a value greater than zero. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions)." +* **Concurrency settings:** You may have reached your maximum concurrency limit. If you would like to enable more jobs to run in parallel, you can update your autoscaling settings to a larger number. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#configuring-autoscaling-for-larger-runners). +* **Repository permissions:** Ensure you have the appropriate repository permissions enabled for your {% data variables.actions.hosted_runner %}s. By default, enterprise runners are not available at the repository level and must be manually enabled by an organization administrator. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#allowing-repositories-to-access-larger-runners). +* **Billing information:** You must have a valid credit card on file in order to use {% data variables.actions.hosted_runner %}s. After adding a credit card to your account, it can take up to 10 minutes to enable the use of your {% data variables.actions.hosted_runner %}s. For more information, see [AUTOTITLE](/billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method). +* **Spending limit:** Your {% data variables.product.prodname_actions %} spending limit must be set to a value greater than zero. For more information, see [AUTOTITLE](/billing/managing-billing-for-github-actions/managing-your-spending-limit-for-github-actions). * **Fair use policy:** {% data variables.product.company_short %} has a fair use policy that begins to throttle jobs based on several factors, such as how many jobs you are running or how many jobs are running across the entirety of {% data variables.product.prodname_actions %}. * **Job queue to assign time:** Job queue to assign time refers to the time between a job request and {% data variables.product.company_short %} assigning a VM to execute the job. Standard {% data variables.product.company_short %}-hosted runners utilizing prescribed YAML workflow labels (such as `ubuntu-latest`) are always in a "warm" state. With larger runners, a warm machine may not be ready to pick up a job on first request as the pools for these machines are smaller. As a result, {% data variables.product.company_short %} may need to create a new VM, which increases the queue to assign time. Once a runner is in use, VMs are readily for subsequent workflow runs, reducing the queue to assign time for future workflow runs over the next 24 hours. diff --git a/data/reusables/actions/learn-more-about-yaml.md b/data/reusables/actions/learn-more-about-yaml.md index bb9997103e8e..71fbf771f2dc 100644 --- a/data/reusables/actions/learn-more-about-yaml.md +++ b/data/reusables/actions/learn-more-about-yaml.md @@ -1 +1 @@ -If you're new to YAML and want to learn more, see "[Learn YAML in Y minutes](https://learnxinyminutes.com/docs/yaml/)." +If you're new to YAML and want to learn more, see [Learn YAML in Y minutes](https://learnxinyminutes.com/docs/yaml/). diff --git a/data/reusables/actions/make-workflow-file.md b/data/reusables/actions/make-workflow-file.md index 3e5008ceb5b7..55824e63d8ae 100644 --- a/data/reusables/actions/make-workflow-file.md +++ b/data/reusables/actions/make-workflow-file.md @@ -1 +1 @@ -In your repository, create a file called `.github/workflows/YOUR_WORKFLOW.yml`, replacing `YOUR_WORKFLOW` with a name of your choice. This is a workflow file. For more information about creating new files on GitHub, see "[AUTOTITLE](/repositories/working-with-files/managing-files/creating-new-files)." +In your repository, create a file called `.github/workflows/YOUR_WORKFLOW.yml`, replacing `YOUR_WORKFLOW` with a name of your choice. This is a workflow file. For more information about creating new files on GitHub, see [AUTOTITLE](/repositories/working-with-files/managing-files/creating-new-files). diff --git a/data/reusables/actions/migrating-enterprise.md b/data/reusables/actions/migrating-enterprise.md index a9e2f07ec675..94f5e5c2f666 100644 --- a/data/reusables/actions/migrating-enterprise.md +++ b/data/reusables/actions/migrating-enterprise.md @@ -1 +1 @@ -If you're migrating your enterprise to {% data variables.product.prodname_actions %} from another provider, there are additional considerations. For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions)." +If you're migrating your enterprise to {% data variables.product.prodname_actions %} from another provider, there are additional considerations. For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/migrating-your-enterprise-to-github-actions). diff --git a/data/reusables/actions/more-resources-for-ghes.md b/data/reusables/actions/more-resources-for-ghes.md index 7e210b31480a..d25fe8bb594f 100644 --- a/data/reusables/actions/more-resources-for-ghes.md +++ b/data/reusables/actions/more-resources-for-ghes.md @@ -5,4 +5,4 @@ If you plan to enable {% data variables.product.prodname_actions %} or {% data v These adjustments should be applied to the base requirements for each user tier. We recommend monitoring all changes to your resources, as further increases may be needed. -For more information about these requirements, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations)." +For more information about these requirements, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations). diff --git a/data/reusables/actions/oidc-deployment-protection-rules.md b/data/reusables/actions/oidc-deployment-protection-rules.md index 98d137b1506c..f49b4e575133 100644 --- a/data/reusables/actions/oidc-deployment-protection-rules.md +++ b/data/reusables/actions/oidc-deployment-protection-rules.md @@ -1,2 +1,2 @@ > [!NOTE] -> When environments are used in workflows or in OIDC policies, we recommend adding protection rules to the environment for additional security. For example, you can configure deployment rules on an environment to restrict which branches and tags can deploy to the environment or access environment secrets. For more information, see "[AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment#deployment-protection-rules)." +> When environments are used in workflows or in OIDC policies, we recommend adding protection rules to the environment for additional security. For example, you can configure deployment rules on an environment to restrict which branches and tags can deploy to the environment or access environment secrets. For more information, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment#deployment-protection-rules). diff --git a/data/reusables/actions/oidc-link-to-intro.md b/data/reusables/actions/oidc-link-to-intro.md index 642802d3a5c2..ce45cea7412c 100644 --- a/data/reusables/actions/oidc-link-to-intro.md +++ b/data/reusables/actions/oidc-link-to-intro.md @@ -1 +1 @@ -* To learn the basic concepts of how {% data variables.product.prodname_dotcom %} uses OpenID Connect (OIDC), and its architecture and benefits, see "[AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)." +* To learn the basic concepts of how {% data variables.product.prodname_dotcom %} uses OpenID Connect (OIDC), and its architecture and benefits, see [AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect). diff --git a/data/reusables/actions/oidc-on-ghecom.md b/data/reusables/actions/oidc-on-ghecom.md index fdada2d3c5eb..5a6a175a8526 100644 --- a/data/reusables/actions/oidc-on-ghecom.md +++ b/data/reusables/actions/oidc-on-ghecom.md @@ -1,3 +1,3 @@ {%- ifversion ghec %} -* If you're following this guide on {% data variables.enterprise.data_residency_site %}, understand that you must substitute certain values in the following documentation. See "[AUTOTITLE](/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#following-these-guides-on-ghecom)." +* If you're following this guide on {% data variables.enterprise.data_residency_site %}, understand that you must substitute certain values in the following documentation. See [AUTOTITLE](/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#following-these-guides-on-ghecom). {%- endif %} diff --git a/data/reusables/actions/oidc-permissions-token.md b/data/reusables/actions/oidc-permissions-token.md index 35f6bc51a846..e8b2eac810e2 100644 --- a/data/reusables/actions/oidc-permissions-token.md +++ b/data/reusables/actions/oidc-permissions-token.md @@ -1,4 +1,4 @@ -The job or workflow run requires a `permissions` setting with [`id-token: write`](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token) to allow {% data variables.product.prodname_dotcom %}'s OIDC provider to create a JSON Web Token for every run. You won't be able to request the OIDC JWT ID token if the `permissions` for `id-token` is not set to `write`, however this value doesn't imply granting write access to any resources, only being able to fetch and set the OIDC token for an action or step to enable authenticating with a short-lived access token. Any actual trust setting is defined using OIDC claims, for more information see "[AUTOTITLE](/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-oidc-trust-with-the-cloud)." +The job or workflow run requires a `permissions` setting with [`id-token: write`](/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token) to allow {% data variables.product.prodname_dotcom %}'s OIDC provider to create a JSON Web Token for every run. You won't be able to request the OIDC JWT ID token if the `permissions` for `id-token` is not set to `write`, however this value doesn't imply granting write access to any resources, only being able to fetch and set the OIDC token for an action or step to enable authenticating with a short-lived access token. Any actual trust setting is defined using OIDC claims, for more information see [AUTOTITLE](/actions/security-for-github-actions/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-oidc-trust-with-the-cloud). The `id-token: write` setting allows the JWT to be requested from {% data variables.product.prodname_dotcom %}'s OIDC provider using one of these approaches: @@ -27,5 +27,5 @@ For reusable workflows that are owned by the same user, organization, or enterpr For reusable workflows outside your enterprise or organization, the `permissions` setting for `id-token` should be explicitly set to `write` at the caller workflow level or in the specific job that calls the reusable workflow. This ensures that the OIDC token generated in the reusable workflow is only allowed to be consumed in the caller workflows when intended. -For more information, see "[AUTOTITLE](/actions/using-workflows/reusing-workflows)." +For more information, see [AUTOTITLE](/actions/using-workflows/reusing-workflows). {% endif %} diff --git a/data/reusables/actions/oidc-security-notice.md b/data/reusables/actions/oidc-security-notice.md index 0988ba5df18b..0c591bb12f88 100644 --- a/data/reusables/actions/oidc-security-notice.md +++ b/data/reusables/actions/oidc-security-notice.md @@ -1 +1 @@ -* Before proceeding, you must plan your security strategy to ensure that access tokens are only allocated in a predictable way. To control how your cloud provider issues access tokens, you **must** define at least one condition, so that untrusted repositories can’t request access tokens for your cloud resources. For more information, see "[AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-oidc-trust-with-the-cloud)." +* Before proceeding, you must plan your security strategy to ensure that access tokens are only allocated in a predictable way. To control how your cloud provider issues access tokens, you **must** define at least one condition, so that untrusted repositories can’t request access tokens for your cloud resources. For more information, see [AUTOTITLE](/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect#configuring-the-oidc-trust-with-the-cloud). diff --git a/data/reusables/actions/onboarding-next-steps.md b/data/reusables/actions/onboarding-next-steps.md index 73a11ebe04e1..b360e8842329 100644 --- a/data/reusables/actions/onboarding-next-steps.md +++ b/data/reusables/actions/onboarding-next-steps.md @@ -1,9 +1,9 @@ {% data variables.product.prodname_actions %} can help you automate nearly every aspect of your application development processes. Ready to get started? Here are some helpful resources for taking your next steps with {% data variables.product.prodname_actions %}: -* To create a {% data variables.product.prodname_actions %} workflow, see "[AUTOTITLE](/actions/learn-github-actions/using-starter-workflows)." -* For continuous integration (CI) workflows, see "[AUTOTITLE](/actions/automating-builds-and-tests)." -* For building and publishing packages, see "[AUTOTITLE](/actions/publishing-packages)." -* For deploying projects, see "[AUTOTITLE](/actions/deployment)." -* For automating tasks and processes on {% data variables.product.prodname_dotcom %}, see "[AUTOTITLE](/actions/managing-issues-and-pull-requests)." -* For examples that demonstrate more complex features of {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/actions/examples)." These detailed examples explain how to test your code on a runner, access the {% data variables.product.prodname_dotcom %} CLI, and use advanced features such as concurrency and test matrices.{% ifversion github-certification %} -* To certify your proficiency in automating workflows and accelerating development with {% data variables.product.prodname_actions %}, earn a {% data variables.product.prodname_actions %} certificate with {% data variables.product.prodname_certifications %}. For more information, see "[AUTOTITLE](/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications)."{% endif %} +* To create a {% data variables.product.prodname_actions %} workflow, see [AUTOTITLE](/actions/learn-github-actions/using-starter-workflows). +* For continuous integration (CI) workflows, see [AUTOTITLE](/actions/automating-builds-and-tests). +* For building and publishing packages, see [AUTOTITLE](/actions/publishing-packages). +* For deploying projects, see [AUTOTITLE](/actions/deployment). +* For automating tasks and processes on {% data variables.product.prodname_dotcom %}, see [AUTOTITLE](/actions/managing-issues-and-pull-requests). +* For examples that demonstrate more complex features of {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions/examples). These detailed examples explain how to test your code on a runner, access the {% data variables.product.prodname_dotcom %} CLI, and use advanced features such as concurrency and test matrices.{% ifversion github-certification %} +* To certify your proficiency in automating workflows and accelerating development with {% data variables.product.prodname_actions %}, earn a {% data variables.product.prodname_actions %} certificate with {% data variables.product.prodname_certifications %}. For more information, see [AUTOTITLE](/get-started/showcase-your-expertise-with-github-certifications/about-github-certifications).{% endif %} diff --git a/data/reusables/actions/org-access-to-github-hosted-runners.md b/data/reusables/actions/org-access-to-github-hosted-runners.md index e015821eed24..a0faf838a7cc 100644 --- a/data/reusables/actions/org-access-to-github-hosted-runners.md +++ b/data/reusables/actions/org-access-to-github-hosted-runners.md @@ -1 +1 @@ -1. To allow organizations to access your {% data variables.actions.hosted_runner %}, specify which organizations can use the runner group the runner is assigned to. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners#changing-which-organizations-can-access-a-runner-group)." +1. To allow organizations to access your {% data variables.actions.hosted_runner %}, specify which organizations can use the runner group the runner is assigned to. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/controlling-access-to-larger-runners#changing-which-organizations-can-access-a-runner-group). diff --git a/data/reusables/actions/org-to-enterprise-actions-permissions.md b/data/reusables/actions/org-to-enterprise-actions-permissions.md index 8b5d08ffb11f..93a7fbbc0514 100644 --- a/data/reusables/actions/org-to-enterprise-actions-permissions.md +++ b/data/reusables/actions/org-to-enterprise-actions-permissions.md @@ -1 +1 @@ -If the organization has write permissions for {% data variables.product.prodname_actions %}, you must manually set write permissions for the enterprise. For more information, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#managing-github-actions-permissions-for-your-repository)." For more information about managing organization-level permissions for {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#managing-github-actions-permissions-for-your-organization)." +If the organization has write permissions for {% data variables.product.prodname_actions %}, you must manually set write permissions for the enterprise. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#managing-github-actions-permissions-for-your-repository). For more information about managing organization-level permissions for {% data variables.product.prodname_actions %}, see [AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#managing-github-actions-permissions-for-your-organization). diff --git a/data/reusables/actions/partial-reruns-with-reusable.md b/data/reusables/actions/partial-reruns-with-reusable.md index 15e3342db8c9..1fba9efa3f0d 100644 --- a/data/reusables/actions/partial-reruns-with-reusable.md +++ b/data/reusables/actions/partial-reruns-with-reusable.md @@ -1,6 +1,6 @@ -Reusable workflows from public repositories can be referenced using a SHA, a release tag, or a branch name. For more information, see "[AUTOTITLE](/actions/using-workflows/reusing-workflows#calling-a-reusable-workflow)." +Reusable workflows from public repositories can be referenced using a SHA, a release tag, or a branch name. For more information, see [AUTOTITLE](/actions/using-workflows/reusing-workflows#calling-a-reusable-workflow). When you re-run a workflow that uses a reusable workflow and the reference is not a SHA, there are some behaviors to be aware of: -* Re-running all jobs in a workflow will use the reusable workflow from the specified reference. For more information about re-running all jobs in a workflow, see "[AUTOTITLE](/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-all-the-jobs-in-a-workflow)." -* Re-running failed jobs or a specific job in a workflow will use the reusable workflow from the same commit SHA of the first attempt. For more information about re-running failed jobs in a workflow, see "[AUTOTITLE](/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-failed-jobs-in-a-workflow)." For more information about re-running a specific job in a workflow, see "[AUTOTITLE](/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-a-specific-job-in-a-workflow)." +* Re-running all jobs in a workflow will use the reusable workflow from the specified reference. For more information about re-running all jobs in a workflow, see [AUTOTITLE](/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-all-the-jobs-in-a-workflow). +* Re-running failed jobs or a specific job in a workflow will use the reusable workflow from the same commit SHA of the first attempt. For more information about re-running failed jobs in a workflow, see [AUTOTITLE](/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-failed-jobs-in-a-workflow). For more information about re-running a specific job in a workflow, see [AUTOTITLE](/actions/managing-workflow-runs/re-running-workflows-and-jobs#re-running-a-specific-job-in-a-workflow). diff --git a/data/reusables/actions/permissions-statement-secrets-and-variables-organization.md b/data/reusables/actions/permissions-statement-secrets-and-variables-organization.md index 92c2c50131ec..930527c4ba55 100644 --- a/data/reusables/actions/permissions-statement-secrets-and-variables-organization.md +++ b/data/reusables/actions/permissions-statement-secrets-and-variables-organization.md @@ -1,3 +1,3 @@ Organization owners{% ifversion custom-org-roles %} and users with the "Manage organization Actions variables" or "Manage organization Actions secrets" permissions{% endif %} can create secrets or variables at the organization level.{% ifversion custom-org-roles %} -For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)."{% endif %} +For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).{% endif %} diff --git a/data/reusables/actions/permissions-statement-secrets-environment.md b/data/reusables/actions/permissions-statement-secrets-environment.md index 2454550cbfa6..720019e740cb 100644 --- a/data/reusables/actions/permissions-statement-secrets-environment.md +++ b/data/reusables/actions/permissions-statement-secrets-environment.md @@ -1 +1 @@ -To create secrets or variables for an environment in a personal account repository, you must be the repository owner. To create secrets or variables for an environment in an organization repository, you must have `admin` access. For more information on environments, see "[AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment)." +To create secrets or variables for an environment in a personal account repository, you must be the repository owner. To create secrets or variables for an environment in an organization repository, you must have `admin` access. For more information on environments, see [AUTOTITLE](/actions/deployment/targeting-different-environments/managing-environments-for-deployment). diff --git a/data/reusables/actions/postgres-environment-variables.md b/data/reusables/actions/postgres-environment-variables.md index 2e1f481b5860..ed7fe1b4ff31 100644 --- a/data/reusables/actions/postgres-environment-variables.md +++ b/data/reusables/actions/postgres-environment-variables.md @@ -1 +1 @@ -The _client.js_ script looks for the `POSTGRES_HOST` and `POSTGRES_PORT` environment variables to create the client. The workflow sets those two environment variables as part of the "Connect to PostgreSQL" step to make them available to the _client.js_ script. For more information about the script, see "[Testing the PostgreSQL service container](#testing-the-postgresql-service-container)." +The _client.js_ script looks for the `POSTGRES_HOST` and `POSTGRES_PORT` environment variables to create the client. The workflow sets those two environment variables as part of the "Connect to PostgreSQL" step to make them available to the _client.js_ script. For more information about the script, see [Testing the PostgreSQL service container](#testing-the-postgresql-service-container). diff --git a/data/reusables/actions/pull-request-target-permissions-warning.md b/data/reusables/actions/pull-request-target-permissions-warning.md index 6fd6aaa8d7a2..019b53f520eb 100644 --- a/data/reusables/actions/pull-request-target-permissions-warning.md +++ b/data/reusables/actions/pull-request-target-permissions-warning.md @@ -1,2 +1,2 @@ > [!WARNING] -> For workflows that are triggered by the `pull_request_target` event, the `GITHUB_TOKEN` is granted read/write repository permission unless the `permissions` key is specified and the workflow can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch. To help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered. For more information, see "[Keeping your GitHub Actions and workflows secure: Preventing pwn requests](https://securitylab.github.com/research/github-actions-preventing-pwn-requests)" on the GitHub Security Lab website. +> For workflows that are triggered by the `pull_request_target` event, the `GITHUB_TOKEN` is granted read/write repository permission unless the `permissions` key is specified and the workflow can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch. To help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered. For more information, see [Keeping your GitHub Actions and workflows secure: Preventing pwn requests](https://securitylab.github.com/research/github-actions-preventing-pwn-requests) on the GitHub Security Lab website. diff --git a/data/reusables/actions/redis-environment-variables.md b/data/reusables/actions/redis-environment-variables.md index 5b6d26ba54fd..fd3c8b6c5e5e 100644 --- a/data/reusables/actions/redis-environment-variables.md +++ b/data/reusables/actions/redis-environment-variables.md @@ -1 +1 @@ -The _client.js_ script looks for the `REDIS_HOST` and `REDIS_PORT` environment variables to create the client. The workflow sets those two environment variables as part of the "Connect to Redis" step to make them available to the _client.js_ script. For more information about the script, see "[Testing the Redis service container](#testing-the-redis-service-container)." +The _client.js_ script looks for the `REDIS_HOST` and `REDIS_PORT` environment variables to create the client. The workflow sets those two environment variables as part of the "Connect to Redis" step to make them available to the _client.js_ script. For more information about the script, see [Testing the Redis service container](#testing-the-redis-service-container). diff --git a/data/reusables/actions/reusable-keyword.md b/data/reusables/actions/reusable-keyword.md index a91ec70ae60c..c60145126799 100644 --- a/data/reusables/actions/reusable-keyword.md +++ b/data/reusables/actions/reusable-keyword.md @@ -1 +1 @@ -This keyword can reference several contexts. For more information, see "[Contexts](/actions/learn-github-actions/contexts#context-availability)." +This keyword can reference several contexts. For more information, see [Contexts](/actions/learn-github-actions/contexts#context-availability). diff --git a/data/reusables/actions/reusable-workflow-calling-syntax.md b/data/reusables/actions/reusable-workflow-calling-syntax.md index ddda9da4e2f7..44d887b3313c 100644 --- a/data/reusables/actions/reusable-workflow-calling-syntax.md +++ b/data/reusables/actions/reusable-workflow-calling-syntax.md @@ -1,6 +1,6 @@ * `{owner}/{repo}/.github/workflows/{filename}@{ref}` for reusable workflows in {% ifversion fpt %}public and private{% elsif ghec or ghes %}public, internal and private{% else %}public and internal{% endif %} repositories. * `./.github/workflows/{filename}` for reusable workflows in the same repository. -In the first option, `{ref}` can be a SHA, a release tag, or a branch name. If a release tag and a branch have the same name, the release tag takes precedence over the branch name. Using the commit SHA is the safest option for stability and security. For more information, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#reusing-third-party-workflows)." +In the first option, `{ref}` can be a SHA, a release tag, or a branch name. If a release tag and a branch have the same name, the release tag takes precedence over the branch name. Using the commit SHA is the safest option for stability and security. For more information, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#reusing-third-party-workflows). If you use the second syntax option (without `{owner}/{repo}` and `@{ref}`) the called workflow is from the same commit as the caller workflow. Ref prefixes such as `refs/heads` and `refs/tags` are not allowed. You cannot use contexts or expressions in this keyword. diff --git a/data/reusables/actions/reusable-workflows.md b/data/reusables/actions/reusable-workflows.md index 05d929131532..e0260bfea1c2 100644 --- a/data/reusables/actions/reusable-workflows.md +++ b/data/reusables/actions/reusable-workflows.md @@ -1 +1 @@ -{% ifversion ghes or ghec %}You can share workflows with your organization, publicly or privately, by calling{% else %} You can call{% endif %} one workflow from within another workflow. This allows you to reuse workflows, avoiding duplication and making your workflows easier to maintain. For more information, see "[AUTOTITLE](/actions/using-workflows/reusing-workflows)." +{% ifversion ghes or ghec %}You can share workflows with your organization, publicly or privately, by calling{% else %} You can call{% endif %} one workflow from within another workflow. This allows you to reuse workflows, avoiding duplication and making your workflows easier to maintain. For more information, see [AUTOTITLE](/actions/using-workflows/reusing-workflows). diff --git a/data/reusables/actions/run-jobs-larger-runners.md b/data/reusables/actions/run-jobs-larger-runners.md index 4e3c29fd90b0..8da9ee884809 100644 --- a/data/reusables/actions/run-jobs-larger-runners.md +++ b/data/reusables/actions/run-jobs-larger-runners.md @@ -3,4 +3,4 @@ Once your runner type has been defined, you can update your workflow YAML files > [!NOTE] > {% data variables.actions.hosted_runner_caps %}s are automatically assigned a default label that corresponds to the runner name. You cannot add custom labels to {% data variables.actions.hosted_runner %}s, but you can use the default labels or the runner's group to send jobs to specific types of runners. -Only owner or administrator accounts can see the runner settings. Non-administrative users can contact the organization owner to find out which runners are enabled. Your organization owner can create new runners and runner groups, as well as configure permissions to specify which repositories can access a runner group. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#allowing-repositories-to-access-a-runner-group)." +Only owner or administrator accounts can see the runner settings. Non-administrative users can contact the organization owner to find out which runners are enabled. Your organization owner can create new runners and runner groups, as well as configure permissions to specify which repositories can access a runner group. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/managing-larger-runners#allowing-repositories-to-access-a-runner-group). diff --git a/data/reusables/actions/runner-labels.md b/data/reusables/actions/runner-labels.md index 85e52dcf7f55..9c2abe473623 100644 --- a/data/reusables/actions/runner-labels.md +++ b/data/reusables/actions/runner-labels.md @@ -1 +1 @@ -Anyone with write access to an Actions-enabled repository can find out the labels for the runners that are available in that repository. See "[AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/running-jobs-on-larger-runners#viewing-available-runners-for-a-repository)." +Anyone with write access to an Actions-enabled repository can find out the labels for the runners that are available in that repository. See [AUTOTITLE](/actions/using-github-hosted-runners/about-larger-runners/running-jobs-on-larger-runners#viewing-available-runners-for-a-repository). diff --git a/data/reusables/actions/runner-tool-cache-description.md b/data/reusables/actions/runner-tool-cache-description.md index f9334c510866..b63c9cd7a5ef 100644 --- a/data/reusables/actions/runner-tool-cache-description.md +++ b/data/reusables/actions/runner-tool-cache-description.md @@ -1 +1 @@ -The path to the directory containing preinstalled tools for {% data variables.product.prodname_dotcom %}-hosted runners. For more information, see "[AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners#supported-software)". +The path to the directory containing preinstalled tools for {% data variables.product.prodname_dotcom %}-hosted runners. For more information, see [AUTOTITLE](/actions/using-github-hosted-runners/about-github-hosted-runners#supported-software). diff --git a/data/reusables/actions/secrets-and-variables-org-permissions.md b/data/reusables/actions/secrets-and-variables-org-permissions.md index f529580cd1a1..9e5731c29bc0 100644 --- a/data/reusables/actions/secrets-and-variables-org-permissions.md +++ b/data/reusables/actions/secrets-and-variables-org-permissions.md @@ -1,6 +1,6 @@ {% ifversion custom-org-roles %} > [!NOTE] -> The "Actions secrets and variables" page may not show distinct tabs for secrets and variables depending on your permissions. Organization owners and users with both the "Manage organization Actions variables" and "Manage organization Actions secrets" permissions will see the **Variables** and **Secrets** tabs. For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles)." +> The "Actions secrets and variables" page may not show distinct tabs for secrets and variables depending on your permissions. Organization owners and users with both the "Manage organization Actions variables" and "Manage organization Actions secrets" permissions will see the **Variables** and **Secrets** tabs. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles). {% endif %} diff --git a/data/reusables/actions/self-hosted-runner-configure.md b/data/reusables/actions/self-hosted-runner-configure.md index 991e416c7406..d85e538e8189 100644 --- a/data/reusables/actions/self-hosted-runner-configure.md +++ b/data/reusables/actions/self-hosted-runner-configure.md @@ -12,5 +12,5 @@ The instructions walk you through completing these tasks: * Downloading and extracting the self-hosted runner application. * Running the `config` script to configure the self-hosted runner application and register it with {% data variables.product.prodname_actions %}. The `config` script requires the destination URL and an automatically-generated time-limited token to authenticate the request. The token expires after one hour. - * On Windows, the `config` script also asks if you would like to install the self-hosted runner application as a service. For Linux and macOS, you can install a service after you finish adding the runner. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service)." + * On Windows, the `config` script also asks if you would like to install the self-hosted runner application as a service. For Linux and macOS, you can install a service after you finish adding the runner. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/configuring-the-self-hosted-runner-application-as-a-service). * Running the self-hosted runner application to connect the machine to {% data variables.product.prodname_actions %}. diff --git a/data/reusables/actions/self-hosted-runner-networking-to-dotcom.md b/data/reusables/actions/self-hosted-runner-networking-to-dotcom.md index 118e94189451..80249f862627 100644 --- a/data/reusables/actions/self-hosted-runner-networking-to-dotcom.md +++ b/data/reusables/actions/self-hosted-runner-networking-to-dotcom.md @@ -1 +1 @@ -To use actions from {% data variables.product.prodname_dotcom_the_website %},{% ifversion ghes %} both {% data variables.product.prodname_ghe_server %} and{% endif %} your self-hosted runners must be able to make outbound connections to {% data variables.product.prodname_dotcom_the_website %}. No inbound connections from {% data variables.product.prodname_dotcom_the_website %} are required. For more information. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#communication-betweens-self-hosted-runners-and-githubcom)." +To use actions from {% data variables.product.prodname_dotcom_the_website %},{% ifversion ghes %} both {% data variables.product.prodname_ghe_server %} and{% endif %} your self-hosted runners must be able to make outbound connections to {% data variables.product.prodname_dotcom_the_website %}. No inbound connections from {% data variables.product.prodname_dotcom_the_website %} are required. For more information. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#communication-betweens-self-hosted-runners-and-githubcom). diff --git a/data/reusables/actions/self-hosted-runner-ports-protocols.md b/data/reusables/actions/self-hosted-runner-ports-protocols.md index cd7b596bce0a..cf0ca083fb00 100644 --- a/data/reusables/actions/self-hosted-runner-ports-protocols.md +++ b/data/reusables/actions/self-hosted-runner-ports-protocols.md @@ -1 +1 @@ -The connection between self-hosted runners and {% data variables.product.product_name %} is over {% ifversion ghes %}HTTP (port 80) or {% endif %}HTTPS (port 443). {% ifversion ghes %}To ensure connectivity over HTTPS, configure TLS for {% data variables.product.prodname_ghe_server %}. For more information, see "[AUTOTITLE](/admin/configuration/hardening-security-for-your-enterprise/configuring-tls)."{% endif %} +The connection between self-hosted runners and {% data variables.product.product_name %} is over {% ifversion ghes %}HTTP (port 80) or {% endif %}HTTPS (port 443). {% ifversion ghes %}To ensure connectivity over HTTPS, configure TLS for {% data variables.product.prodname_ghe_server %}. For more information, see [AUTOTITLE](/admin/configuration/hardening-security-for-your-enterprise/configuring-tls).{% endif %} diff --git a/data/reusables/actions/self-hosted-runner-public-repo-access.md b/data/reusables/actions/self-hosted-runner-public-repo-access.md index 11ba5f36e9e9..86af4df0e63d 100644 --- a/data/reusables/actions/self-hosted-runner-public-repo-access.md +++ b/data/reusables/actions/self-hosted-runner-public-repo-access.md @@ -1,2 +1,2 @@ > [!NOTE] -> For security reasons, public repositories can't use runners in a runner group by default, but you can override this in the runner group's settings. For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group)." +> For security reasons, public repositories can't use runners in a runner group by default, but you can override this in the runner group's settings. For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/managing-access-to-self-hosted-runners-using-groups#changing-the-access-policy-of-a-self-hosted-runner-group). diff --git a/data/reusables/actions/self-hosted-runner-reqs-docker.md b/data/reusables/actions/self-hosted-runner-reqs-docker.md index 4f7cb3106e28..d8c8a0a90696 100644 --- a/data/reusables/actions/self-hosted-runner-reqs-docker.md +++ b/data/reusables/actions/self-hosted-runner-reqs-docker.md @@ -1 +1 @@ -Self-hosted runners must use a Linux operating system and have Docker installed to run Docker container actions. For more information about the requirements of self-hosted runners, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#requirements-for-self-hosted-runner-machines)." +Self-hosted runners must use a Linux operating system and have Docker installed to run Docker container actions. For more information about the requirements of self-hosted runners, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#requirements-for-self-hosted-runner-machines). diff --git a/data/reusables/actions/self-hosted-runner-security-admonition.md b/data/reusables/actions/self-hosted-runner-security-admonition.md index 777e46d3e06f..d5e9f7eaa109 100644 --- a/data/reusables/actions/self-hosted-runner-security-admonition.md +++ b/data/reusables/actions/self-hosted-runner-security-admonition.md @@ -1,4 +1,4 @@ > [!WARNING] > {% data reusables.actions.self-hosted-runner-security %} > -> For more information, see "[AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories)." +> For more information, see [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners/about-self-hosted-runners#self-hosted-runner-security-with-public-repositories). diff --git a/data/reusables/actions/self-hosted-runners-prerequisites.md b/data/reusables/actions/self-hosted-runners-prerequisites.md index 300620e727a7..e9d74bcecfb4 100644 --- a/data/reusables/actions/self-hosted-runners-prerequisites.md +++ b/data/reusables/actions/self-hosted-runners-prerequisites.md @@ -1,5 +1,5 @@ {%- ifversion ghes %} -* {% data variables.product.prodname_actions %} must be enabled for {% data variables.product.product_name %}. A site administrator can enable and configure {% data variables.product.prodname_actions %} for your instance. For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server)." +* {% data variables.product.prodname_actions %} must be enabled for {% data variables.product.product_name %}. A site administrator can enable and configure {% data variables.product.prodname_actions %} for your instance. For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server). {%- endif %} * You must have access to the machine you will use as a self-hosted runner in your environment. diff --git a/data/reusables/actions/service-container-prereqs.md b/data/reusables/actions/service-container-prereqs.md index d79761db860e..244a3e6a0452 100644 --- a/data/reusables/actions/service-container-prereqs.md +++ b/data/reusables/actions/service-container-prereqs.md @@ -1 +1 @@ -You should be familiar with how service containers work with {% data variables.product.prodname_actions %} and the networking differences between running jobs directly on the runner or in a container. For more information, see "[AUTOTITLE](/actions/using-containerized-services/about-service-containers)." +You should be familiar with how service containers work with {% data variables.product.prodname_actions %} and the networking differences between running jobs directly on the runner or in a container. For more information, see [AUTOTITLE](/actions/using-containerized-services/about-service-containers). diff --git a/data/reusables/actions/settings-ui/settings-actions-pages-custom-workflow.md b/data/reusables/actions/settings-ui/settings-actions-pages-custom-workflow.md index 84dec7bb6e8b..3e39e360fded 100644 --- a/data/reusables/actions/settings-ui/settings-actions-pages-custom-workflow.md +++ b/data/reusables/actions/settings-ui/settings-actions-pages-custom-workflow.md @@ -1 +1 @@ -{% ifversion ghes %}To use {% data variables.product.prodname_actions %} as a publishing source for {% data variables.product.prodname_pages %}, a site administrator must enable {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}. For more information, see "[AUTOTITLE](/admin/github-actions/enabling-github-actions-for-github-enterprise-server)."{% endif %} +{% ifversion ghes %}To use {% data variables.product.prodname_actions %} as a publishing source for {% data variables.product.prodname_pages %}, a site administrator must enable {% data variables.product.prodname_actions %} for {% data variables.product.prodname_ghe_server %}. For more information, see [AUTOTITLE](/admin/github-actions/enabling-github-actions-for-github-enterprise-server).{% endif %} diff --git a/data/reusables/actions/supported-github-runners.md b/data/reusables/actions/supported-github-runners.md index ed162ef2aa6f..0cf6d12a0c77 100644 --- a/data/reusables/actions/supported-github-runners.md +++ b/data/reusables/actions/supported-github-runners.md @@ -63,7 +63,7 @@ For public repositories, jobs using the workflow labels shown in the table below ### Standard {% data variables.product.prodname_dotcom %}-hosted runners for {% ifversion ghec %}internal and{% endif %} private repositories -For {% ifversion ghec %}internal and{% endif %} private repositories, jobs using the workflow labels shown in the table below will run on virtual machines with the associated specifications. These runners use your {% data variables.product.prodname_dotcom %} account's allotment of free minutes, and are then charged at the per minute rates. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#per-minute-rates)." +For {% ifversion ghec %}internal and{% endif %} private repositories, jobs using the workflow labels shown in the table below will run on virtual machines with the associated specifications. These runners use your {% data variables.product.prodname_dotcom %} account's allotment of free minutes, and are then charged at the per minute rates. For more information, see [AUTOTITLE](/billing/managing-billing-for-github-actions/about-billing-for-github-actions#per-minute-rates). diff --git a/data/reusables/actions/third-party-actions.md b/data/reusables/actions/third-party-actions.md index 8334791cf626..607d37b529b4 100644 --- a/data/reusables/actions/third-party-actions.md +++ b/data/reusables/actions/third-party-actions.md @@ -1,3 +1,3 @@ > [!NOTE] > * This workflow template contains an action that is not certified by {% data variables.product.prodname_dotcom %}. Actions provided by third parties are governed by separate terms of service, privacy policy, and support documentation. -> * If you use actions from third parties you should use a version specified by a commit SHA. If the action is revised and you want to use the newer version, you will need to update the SHA. You can specify a version by referencing a tag or a branch, however the action may change without warning. For more information, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#using-third-party-actions)." +> * If you use actions from third parties you should use a version specified by a commit SHA. If the action is revised and you want to use the newer version, you will need to update the SHA. You can specify a version by referencing a tag or a branch, however the action may change without warning. For more information, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#using-third-party-actions). diff --git a/data/reusables/actions/upgrade-runners-before-upgrade-ghes.md b/data/reusables/actions/upgrade-runners-before-upgrade-ghes.md index 6e47ddaf209c..eb183f330281 100644 --- a/data/reusables/actions/upgrade-runners-before-upgrade-ghes.md +++ b/data/reusables/actions/upgrade-runners-before-upgrade-ghes.md @@ -1 +1 @@ -If you use ephemeral runners and have disabled automatic updates, before you upgrade {% data variables.product.prodname_ghe_server %}, you should first upgrade your self-hosted runners to the version of the runner application that your upgraded instance will run. Upgrading {% data variables.product.prodname_ghe_server %} before you upgrade ephemeral runners may result in your runners going offline. For more information, see "[AUTOTITLE](/admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process)." +If you use ephemeral runners and have disabled automatic updates, before you upgrade {% data variables.product.prodname_ghe_server %}, you should first upgrade your self-hosted runners to the version of the runner application that your upgraded instance will run. Upgrading {% data variables.product.prodname_ghe_server %} before you upgrade ephemeral runners may result in your runners going offline. For more information, see [AUTOTITLE](/admin/upgrading-your-instance/preparing-to-upgrade/overview-of-the-upgrade-process). diff --git a/data/reusables/actions/use-request-body-api.md b/data/reusables/actions/use-request-body-api.md index 1eddd91765d6..65fd3fdd47e8 100644 --- a/data/reusables/actions/use-request-body-api.md +++ b/data/reusables/actions/use-request-body-api.md @@ -1 +1 @@ -To apply this configuration, submit a request to the API endpoint and include the required configuration in the request body. For organizations, see "[AUTOTITLE](/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-an-organization)," and for repositories, see "[AUTOTITLE](/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository)." +To apply this configuration, submit a request to the API endpoint and include the required configuration in the request body. For organizations, see [AUTOTITLE](/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-an-organization), and for repositories, see [AUTOTITLE](/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository). diff --git a/data/reusables/actions/viewing-actions-metrics.md b/data/reusables/actions/viewing-actions-metrics.md index a54bf32f5018..765dea68c5a3 100644 --- a/data/reusables/actions/viewing-actions-metrics.md +++ b/data/reusables/actions/viewing-actions-metrics.md @@ -1,6 +1,6 @@ 1. In the "Insights" navigation menu, click **Actions Usage Metrics** or click **Actions Performance Metrics**. -1. Optionally, to select a time period to view usage metrics for, choose an option from the **Period** drop down menu at the top right of the page. For more information, see "[Understanding {% data variables.product.prodname_actions %} metrics aggregation](#understanding-github-actions-metrics-aggregation)." -1. Click on the tab that contains the metrics you would like to view. For more information, see "[About {% data variables.product.prodname_actions %} usage metrics](#about-github-actions-usage-metrics) or "[About {% data variables.product.prodname_actions %} performance metrics](#about-github-actions-performance-metrics)." +1. Optionally, to select a time period to view usage metrics for, choose an option from the **Period** drop down menu at the top right of the page. For more information, see [Understanding {% data variables.product.prodname_actions %} metrics aggregation](#understanding-github-actions-metrics-aggregation). +1. Click on the tab that contains the metrics you would like to view. For more information, see "[About {% data variables.product.prodname_actions %} usage metrics](#about-github-actions-usage-metrics) or [About {% data variables.product.prodname_actions %} performance metrics](#about-github-actions-performance-metrics). 1. Optionally, to filter the data displayed in a tab, create a filter. 1. Click on the **{% octicon "filter" aria-hidden="true" %} Filter** button. 1. Click **{% octicon "plus" aria-hidden="true" %} Add a filter**. diff --git a/data/reusables/actions/workflow-basic-example-and-explanation.md b/data/reusables/actions/workflow-basic-example-and-explanation.md index bd18afd193fb..5b13d6d031c5 100644 --- a/data/reusables/actions/workflow-basic-example-and-explanation.md +++ b/data/reusables/actions/workflow-basic-example-and-explanation.md @@ -25,7 +25,7 @@ You can create an example workflow in your repository that automatically trigger 1. Commit these changes and push them to your {% data variables.product.prodname_dotcom %} repository. -Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. To see the details about a workflow's execution history, see "[Viewing the activity for a workflow run](#viewing-the-activity-for-a-workflow-run)." +Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. To see the details about a workflow's execution history, see [Viewing the activity for a workflow run](#viewing-the-activity-for-a-workflow-run). ## Understanding the workflow file @@ -70,7 +70,7 @@ jobs: ### Visualizing the workflow file -In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action or shell script. Steps 1 and 2 run actions, while steps 3 and 4 run shell scripts. To find more prebuilt actions for your workflows, see "[AUTOTITLE](/actions/learn-github-actions/finding-and-customizing-actions)." +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action or shell script. Steps 1 and 2 run actions, while steps 3 and 4 run shell scripts. To find more prebuilt actions for your workflows, see [AUTOTITLE](/actions/learn-github-actions/finding-and-customizing-actions). ![Diagram showing the trigger, runner, and job of a workflow. The job is broken into 4 steps.](/assets/images/help/actions/overview-actions-event.png) diff --git a/data/reusables/actions/workflow-permissions-intro.md b/data/reusables/actions/workflow-permissions-intro.md index d4ab67e7adc5..5ded31dd0706 100644 --- a/data/reusables/actions/workflow-permissions-intro.md +++ b/data/reusables/actions/workflow-permissions-intro.md @@ -1 +1 @@ -You can set the default permissions granted to the `GITHUB_TOKEN`. For more information about the `GITHUB_TOKEN`, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication)." You can choose a restricted set of permissions as the default, or apply permissive settings. +You can set the default permissions granted to the `GITHUB_TOKEN`. For more information about the `GITHUB_TOKEN`, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication). You can choose a restricted set of permissions as the default, or apply permissive settings. diff --git a/data/reusables/actions/workflow-run-approve-link.md b/data/reusables/actions/workflow-run-approve-link.md index 6693d7ee174f..5682f2e1c5c6 100644 --- a/data/reusables/actions/workflow-run-approve-link.md +++ b/data/reusables/actions/workflow-run-approve-link.md @@ -1 +1 @@ -For more information about approving workflow runs that this policy applies to, see "[AUTOTITLE](/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks)." +For more information about approving workflow runs that this policy applies to, see [AUTOTITLE](/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks). diff --git a/data/reusables/actions/workflow-run-approve-public-fork.md b/data/reusables/actions/workflow-run-approve-public-fork.md index cbf9a90fef85..e18d1c990a16 100644 --- a/data/reusables/actions/workflow-run-approve-public-fork.md +++ b/data/reusables/actions/workflow-run-approve-public-fork.md @@ -7,6 +7,6 @@ To help prevent this, workflows on pull requests to public repositories from som By default, all first-time contributors require approval to run workflows. -Workflows triggered by `pull_request_target` events are run in the context of the base branch. Since the base branch is considered trusted, workflows triggered by these events will always run, regardless of approval settings. For more information about the `pull_request_target` event, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#pull_request_target)." +Workflows triggered by `pull_request_target` events are run in the context of the base branch. Since the base branch is considered trusted, workflows triggered by these events will always run, regardless of approval settings. For more information about the `pull_request_target` event, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#pull_request_target). ->[!WARNING] These workflow approval policies are intended to restrict the set of users that can execute workflows in {% data variables.product.prodname_actions %} runners that could lead to unexpected resource and compute consumption when using {% data variables.product.prodname_dotcom %}-hosted runners. If you are using self-hosted runners, potentially malicious user-controlled workflow code will execute automatically if the user is allowed to bypass approval in the set approval policy or if the pull request is approved. You must consider the risk of executing this code in your infrastructure and should review and follow the self-hosted runner security recommendations regardless of the approval settings utilized. See "[AUTOTITLE](/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions#hardening-for-self-hosted-runners)." +>[!WARNING] These workflow approval policies are intended to restrict the set of users that can execute workflows in {% data variables.product.prodname_actions %} runners that could lead to unexpected resource and compute consumption when using {% data variables.product.prodname_dotcom %}-hosted runners. If you are using self-hosted runners, potentially malicious user-controlled workflow code will execute automatically if the user is allowed to bypass approval in the set approval policy or if the pull request is approved. You must consider the risk of executing this code in your infrastructure and should review and follow the self-hosted runner security recommendations regardless of the approval settings utilized. See [AUTOTITLE](/actions/security-for-github-actions/security-guides/security-hardening-for-github-actions#hardening-for-self-hosted-runners). diff --git a/data/reusables/actions/workflow-runs-dependabot-note.md b/data/reusables/actions/workflow-runs-dependabot-note.md index 6f57cbd51987..1adde2b7df61 100644 --- a/data/reusables/actions/workflow-runs-dependabot-note.md +++ b/data/reusables/actions/workflow-runs-dependabot-note.md @@ -1 +1 @@ -Workflow runs triggered by {% data variables.product.prodname_dependabot %} pull requests run as if they are from a forked repository, and therefore use a read-only `GITHUB_TOKEN`. These workflow runs cannot access any secrets. For information about strategies to keep these workflows secure, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions)." +Workflow runs triggered by {% data variables.product.prodname_dependabot %} pull requests run as if they are from a forked repository, and therefore use a read-only `GITHUB_TOKEN`. These workflow runs cannot access any secrets. For information about strategies to keep these workflows secure, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions). diff --git a/data/reusables/actions/workflow-templates-categories.md b/data/reusables/actions/workflow-templates-categories.md index 488dc489e6c3..7a558345d300 100644 --- a/data/reusables/actions/workflow-templates-categories.md +++ b/data/reusables/actions/workflow-templates-categories.md @@ -1,5 +1,5 @@ {% data variables.product.prodname_dotcom %} provides ready-to-use workflow templates for the following high level categories: -* **Deployment (CD)**. For more information, see "[AUTOTITLE](/actions/deployment/about-deployments/about-continuous-deployment)." -{% ifversion fpt or ghec %}- **Security**. For more information, see "[AUTOTITLE](/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/configuring-advanced-setup-for-code-scanning#configuring-code-scanning-using-third-party-actions)."{% endif %} -* **Continuous Integration (CI)**. For more information, see "[AUTOTITLE](/actions/automating-builds-and-tests/about-continuous-integration)." +* **Deployment (CD)**. For more information, see [AUTOTITLE](/actions/deployment/about-deployments/about-continuous-deployment). +{% ifversion fpt or ghec %}- **Security**. For more information, see [AUTOTITLE](/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/configuring-advanced-setup-for-code-scanning#configuring-code-scanning-using-third-party-actions).{% endif %} +* **Continuous Integration (CI)**. For more information, see [AUTOTITLE](/actions/automating-builds-and-tests/about-continuous-integration). * **Automation**. Automation workflow templates offer solutions for automating workflows, such as triaging pull requests and applying a label based on the paths that are modified in the pull request, or greeting users who are first time contributors to the repository. diff --git a/data/reusables/actions/workflow-templates-for-more-information.md b/data/reusables/actions/workflow-templates-for-more-information.md index adcfc6cb2a7a..73a952076334 100644 --- a/data/reusables/actions/workflow-templates-for-more-information.md +++ b/data/reusables/actions/workflow-templates-for-more-information.md @@ -1 +1 @@ -To get started with preconfigured workflows, browse through the list of templates in the [actions/starter-workflows](https://github.com/actions/starter-workflows) repository. For more information, see "[AUTOTITLE](/actions/writing-workflows/using-starter-workflows)." +To get started with preconfigured workflows, browse through the list of templates in the [actions/starter-workflows](https://github.com/actions/starter-workflows) repository. For more information, see [AUTOTITLE](/actions/writing-workflows/using-starter-workflows). diff --git a/data/reusables/actions/workflow-templates-repo-link.md b/data/reusables/actions/workflow-templates-repo-link.md index af9cd445217e..94490a2a0974 100644 --- a/data/reusables/actions/workflow-templates-repo-link.md +++ b/data/reusables/actions/workflow-templates-repo-link.md @@ -1 +1 @@ -Use these workflows 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 [actions/starter-workflows](https://github.com/actions/starter-workflows) repository. For more information, see "[AUTOTITLE](/actions/writing-workflows/using-starter-workflows)." +Use these workflows 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 [actions/starter-workflows](https://github.com/actions/starter-workflows) repository. For more information, see [AUTOTITLE](/actions/writing-workflows/using-starter-workflows). diff --git a/data/reusables/actions/workflows-from-public-fork-setting.md b/data/reusables/actions/workflows-from-public-fork-setting.md index c4fd50cbe560..23cbb867a379 100644 --- a/data/reusables/actions/workflows-from-public-fork-setting.md +++ b/data/reusables/actions/workflows-from-public-fork-setting.md @@ -1,4 +1,4 @@ -1. Under **Approval for running fork pull request workflows from contributors**, choose which subset of users will require approval before running workflows on their pull requests. Both the pull request author and the actor of the pull request event triggering the workflow will be checked to determine if approval is required. If approval is required, a user with write access to the repository must approve the pull request workflow to be run. See "[AUTOTITLE](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-public-forks)." +1. Under **Approval for running fork pull request workflows from contributors**, choose which subset of users will require approval before running workflows on their pull requests. Both the pull request author and the actor of the pull request event triggering the workflow will be checked to determine if approval is required. If approval is required, a user with write access to the repository must approve the pull request workflow to be run. See [AUTOTITLE](/actions/managing-workflow-runs-and-deployments/managing-workflow-runs/approving-workflow-runs-from-public-forks). >[!WARNING] When requiring approvals only for first-time contributors (the first two settings), a user that has had any commit or pull request merged into the repository will not require approval. A malicious user could meet this requirement by getting a simple typo or other innocuous change accepted by a maintainer, either as part of a pull request they have authored or as part of another user's pull request. diff --git a/data/reusables/actions/workflows/required-workflow-beta.md b/data/reusables/actions/workflows/required-workflow-beta.md index 46d1231aeed6..bd056b400862 100644 --- a/data/reusables/actions/workflows/required-workflow-beta.md +++ b/data/reusables/actions/workflows/required-workflow-beta.md @@ -1,6 +1,6 @@ > [!NOTE] > {% data variables.product.company_short %} no longer supports required workflows for {% data variables.product.prodname_actions %}. To require workflows to pass before merging, upgrade {% data variables.product.prodname_ghe_server %} to the latest version and use repository rulesets instead. > -> For more information about upgrading {% data variables.product.prodname_ghe_server %}, see "[AUTOTITLE](/admin/overview/about-upgrades-to-new-releases)." +> For more information about upgrading {% data variables.product.prodname_ghe_server %}, see [AUTOTITLE](/admin/overview/about-upgrades-to-new-releases). > -> For more information about repository rulesets, see "[AUTOTITLE](/enterprise-server@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#require-workflows-to-pass-before-merging)." +> For more information about repository rulesets, see [AUTOTITLE](/enterprise-server@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#require-workflows-to-pass-before-merging). diff --git a/data/reusables/actions/workflows/required-workflow-prerequisites.md b/data/reusables/actions/workflows/required-workflow-prerequisites.md index d61322cdd692..d35f1ba419c3 100644 --- a/data/reusables/actions/workflows/required-workflow-prerequisites.md +++ b/data/reusables/actions/workflows/required-workflow-prerequisites.md @@ -1,8 +1,8 @@ -* {% data variables.product.prodname_actions %} must be enabled for a repository in the organization's settings in order for required workflows to run. Once enabled at an organization-level, required workflows will run even when {% data variables.product.prodname_actions %} is disabled in the repository's settings. For more information on managing {% data variables.product.prodname_actions %} in your organization's repositories, see "[AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#managing-github-actions-permissions-for-your-organization)." -* Required workflows are available for organizations and only in repositories where the organization's plan supports required status checks. If required status checks are not supported, the workflow will still run, but it will not be a required check and will not block merging. For more information about support for required status checks, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)." -* The repository's default branch must match the organization's default branch setting in order for required workflows to run as required status checks. If the default branch names do not match, the workflow will still run, but it will not be a required check. For more information about managing default branch names, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-the-default-branch-name-for-repositories-in-your-organization)" and "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch)." +* {% data variables.product.prodname_actions %} must be enabled for a repository in the organization's settings in order for required workflows to run. Once enabled at an organization-level, required workflows will run even when {% data variables.product.prodname_actions %} is disabled in the repository's settings. For more information on managing {% data variables.product.prodname_actions %} in your organization's repositories, see [AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#managing-github-actions-permissions-for-your-organization). +* Required workflows are available for organizations and only in repositories where the organization's plan supports required status checks. If required status checks are not supported, the workflow will still run, but it will not be a required check and will not block merging. For more information about support for required status checks, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches). +* The repository's default branch must match the organization's default branch setting in order for required workflows to run as required status checks. If the default branch names do not match, the workflow will still run, but it will not be a required check. For more information about managing default branch names, see [AUTOTITLE](/organizations/managing-organization-settings/managing-the-default-branch-name-for-repositories-in-your-organization) and [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-branches-in-your-repository/changing-the-default-branch). * For required workflows to run, the pull request's source repository must be in the same organization as the target repository. {% data variables.product.product_name %} will source the required workflow from {% ifversion actions-required-workflow-improvements %}a specified branch, tag, or commit SHA {% else %}the HEAD commit of the default branch {% endif %}from the repository containing the workflow. * Secrets used in a required workflow should be created at either the organization level or in the target repositories. * Secrets in the source repository will not be fetched when a workflow runs in the target repository. -{% ifversion actions-required-workflow-improvements %}* When a workflow is run as a required workflow it will ignore all the filters in the `on:` section, for example: `branches`, `branches-ignore`, `paths`, `types` etc. The required workflow will run only for the `pull_request` and `pull_request_target` default events. For more information on default activity types, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#pull_request)."{% endif %} +{% ifversion actions-required-workflow-improvements %}* When a workflow is run as a required workflow it will ignore all the filters in the `on:` section, for example: `branches`, `branches-ignore`, `paths`, `types` etc. The required workflow will run only for the `pull_request` and `pull_request_target` default events. For more information on default activity types, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#pull_request).{% endif %} * Required workflows are not automatically triggered on already existing pull requests even though they automatically appear as expected checks. To trigger required workflows for an already existing pull request, push a new change to that pull request. diff --git a/data/reusables/actions/workflows/required-workflow-source-notes.md b/data/reusables/actions/workflows/required-workflow-source-notes.md index 679cea203030..cf3ad2c3767a 100644 --- a/data/reusables/actions/workflows/required-workflow-source-notes.md +++ b/data/reusables/actions/workflows/required-workflow-source-notes.md @@ -1,7 +1,7 @@ * Required workflows can be stored in any repository folder and are not restricted to the `.github/workflows` folder like normal workflows. If a required workflow calls a reusable workflow, the reusable workflow must be stored in the `.github/workflows` folder. When calling a reusable workflow, a required workflow must use the full path and ref to the reusable workflow. For example, `{owner}/{repo}/.github/workflows/{filename}@{ref}`. -* If the required workflow is contained in a private {% ifversion ghes or ghec %}or internal {% endif %}repository, you must ensure that workflows within the repository are accessible by other repositories in your organization. For more information, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#managing-access-for-a-private-repository){% ifversion ghes or ghec %}" and "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository){% endif %}." +* If the required workflow is contained in a private {% ifversion ghes or ghec %}or internal {% endif %}repository, you must ensure that workflows within the repository are accessible by other repositories in your organization. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#managing-access-for-a-private-repository){% ifversion ghes or ghec %} and [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#allowing-access-to-components-in-an-internal-repository){% endif %}. * Workflows stored in a public repository can be configured as required workflows for any repository in your organization. Workflows stored in a private repository can only be configured as required workflows for other private repositories in your organization. {% ifversion ghes or ghec %} Workflows stored in internal repositories can be configured as required workflows for internal and private repositories in your organization.{% endif %} -* {% data variables.product.prodname_codeql %} is not supported in required workflows because {% data variables.product.prodname_codeql %} requires configuration at the repository level. For information on configuring code scanning, see "[AUTOTITLE](/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/configuring-advanced-setup-for-code-scanning)." +* {% data variables.product.prodname_codeql %} is not supported in required workflows because {% data variables.product.prodname_codeql %} requires configuration at the repository level. For information on configuring code scanning, see [AUTOTITLE](/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/configuring-advanced-setup-for-code-scanning). {% ifversion actions-required-workflow-improvements %} {% ifversion fpt or ghec %} * To push to a branch where required workflows are enforced at the organizational level, create a pull request to make the necessary changes. You cannot push directly to branches with required workflow enforcements. diff --git a/data/reusables/actions/workflows/run-on-specific-branches-or-tags1.md b/data/reusables/actions/workflows/run-on-specific-branches-or-tags1.md index f2b429913054..d08d59adf887 100644 --- a/data/reusables/actions/workflows/run-on-specific-branches-or-tags1.md +++ b/data/reusables/actions/workflows/run-on-specific-branches-or-tags1.md @@ -7,4 +7,4 @@ Use the `tags` filter when you want to include tag name patterns or when you wan If you define only `tags`/`tags-ignore` or only `branches`/`branches-ignore`, the workflow won't run for events affecting the undefined Git ref. If you define neither `tags`/`tags-ignore` or `branches`/`branches-ignore`, the workflow will run for events affecting either branches or tags. If you define both `branches`/`branches-ignore` and [`paths`/`paths-ignore`](/actions/using-workflows/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore), the workflow will only run when both filters are satisfied. -The `branches`, `branches-ignore`, `tags`, and `tags-ignore` keywords accept glob patterns that use characters like `*`, `**`, `+`, `?`, `!` and others to match more than one branch or tag name. If a name contains any of these characters and you want a literal match, you need to _escape_ each of these special characters with `\`. For more information about glob patterns, see the "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." +The `branches`, `branches-ignore`, `tags`, and `tags-ignore` keywords accept glob patterns that use characters like `*`, `**`, `+`, `?`, `!` and others to match more than one branch or tag name. If a name contains any of these characters and you want a literal match, you need to _escape_ each of these special characters with `\`. For more information about glob patterns, see the [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet). diff --git a/data/reusables/actions/workflows/section-specifying-branches.md b/data/reusables/actions/workflows/section-specifying-branches.md index f5f495e1874c..2107a3329f6e 100644 --- a/data/reusables/actions/workflows/section-specifying-branches.md +++ b/data/reusables/actions/workflows/section-specifying-branches.md @@ -1,7 +1,7 @@ When using the `workflow_run` event, you can specify what branches the triggering workflow must run on in order to trigger your workflow. -The `branches` and `branches-ignore` filters accept glob patterns that use characters like `*`, `**`, `+`, `?`, `!` and others to match more than one branch name. If a name contains any of these characters and you want a literal match, you need to _escape_ each of these special characters with `\`. For more information about glob patterns, see the "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." +The `branches` and `branches-ignore` filters accept glob patterns that use characters like `*`, `**`, `+`, `?`, `!` and others to match more than one branch name. If a name contains any of these characters and you want a literal match, you need to _escape_ each of these special characters with `\`. For more information about glob patterns, see the [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet). For example, a workflow with the following trigger will only run when the workflow named `Build` runs on a branch whose name starts with `releases/`: diff --git a/data/reusables/actions/workflows/section-triggering-a-workflow-schedule.md b/data/reusables/actions/workflows/section-triggering-a-workflow-schedule.md index 1f16c55c2fa1..779461ef0390 100644 --- a/data/reusables/actions/workflows/section-triggering-a-workflow-schedule.md +++ b/data/reusables/actions/workflows/section-triggering-a-workflow-schedule.md @@ -1,3 +1,3 @@ You can use `on.schedule` to define a time schedule for your workflows. {% data reusables.repositories.actions-scheduled-workflow-example %} -For more information about cron syntax, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#scheduled-events)." +For more information about cron syntax, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#scheduled-events). diff --git a/data/reusables/actions/workflows/section-triggering-a-workflow-types.md b/data/reusables/actions/workflows/section-triggering-a-workflow-types.md index 05b719abc969..2b3e57fcd1d8 100644 --- a/data/reusables/actions/workflows/section-triggering-a-workflow-types.md +++ b/data/reusables/actions/workflows/section-triggering-a-workflow-types.md @@ -1,6 +1,6 @@ Use `on..types` to define the type of activity that will trigger a workflow run. Most GitHub events are triggered by more than one type of activity. For example, the `label` is triggered when a label is `created`, `edited`, or `deleted`. The `types` keyword enables you to narrow down activity that causes the workflow to run. When only one activity type triggers a webhook event, the `types` keyword is unnecessary. -You can use an array of event `types`. For more information about each event and their activity types, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#available-events)." +You can use an array of event `types`. For more information about each event and their activity types, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows#available-events). ```yaml on: diff --git a/data/reusables/actions/workflows/section-triggering-a-workflow.md b/data/reusables/actions/workflows/section-triggering-a-workflow.md index 386fbf4ffc18..6e9a613a8f1c 100644 --- a/data/reusables/actions/workflows/section-triggering-a-workflow.md +++ b/data/reusables/actions/workflows/section-triggering-a-workflow.md @@ -1,5 +1,5 @@ -To automatically trigger a workflow, use `on` to define which events can cause the workflow to run. For a list of available events, see "[AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows)." +To automatically trigger a workflow, use `on` to define which events can cause the workflow to run. For a list of available events, see [AUTOTITLE](/actions/using-workflows/events-that-trigger-workflows). You can define single or multiple events that can trigger a workflow, or set a time schedule. You can also restrict the execution of a workflow to only occur for specific files, tags, or branch changes. These options are described in the following sections. diff --git a/data/reusables/actions/workflows/triggering-a-workflow-paths1.md b/data/reusables/actions/workflows/triggering-a-workflow-paths1.md index 454eedbdc59f..6fc9ec1cca2a 100644 --- a/data/reusables/actions/workflows/triggering-a-workflow-paths1.md +++ b/data/reusables/actions/workflows/triggering-a-workflow-paths1.md @@ -10,4 +10,4 @@ Use the `paths` filter when you want to include file path patterns or when you w If you define both `branches`/`branches-ignore` and `paths`/`paths-ignore`, the workflow will only run when both filters are satisfied. -The `paths` and `paths-ignore` keywords accept glob patterns that use the `*` and `**` wildcard characters to match more than one path name. For more information, see the "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." +The `paths` and `paths-ignore` keywords accept glob patterns that use the `*` and `**` wildcard characters to match more than one path name. For more information, see the [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet). diff --git a/data/reusables/actions/workflows/triggering-a-workflow-paths5.md b/data/reusables/actions/workflows/triggering-a-workflow-paths5.md index 5cf3803708d7..4b8330a6faba 100644 --- a/data/reusables/actions/workflows/triggering-a-workflow-paths5.md +++ b/data/reusables/actions/workflows/triggering-a-workflow-paths5.md @@ -10,4 +10,4 @@ The filter determines if a workflow should run by evaluating the changed files a Diffs are limited to 300 files. If there are files changed that aren't matched in the first 300 files returned by the filter, the workflow will not run. You may need to create more specific filters so that the workflow will run automatically. -For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests)." +For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-comparing-branches-in-pull-requests). diff --git a/data/reusables/actions/workflows/triggering-workflow-branches1.md b/data/reusables/actions/workflows/triggering-workflow-branches1.md index d544dcbb0a24..83fabf7a068a 100644 --- a/data/reusables/actions/workflows/triggering-workflow-branches1.md +++ b/data/reusables/actions/workflows/triggering-workflow-branches1.md @@ -4,4 +4,4 @@ Use the `branches` filter when you want to include branch name patterns or when If you define both `branches`/`branches-ignore` and [`paths`/`paths-ignore`](/actions/using-workflows/workflow-syntax-for-github-actions#onpushpull_requestpull_request_targetpathspaths-ignore), the workflow will only run when both filters are satisfied. -The `branches` and `branches-ignore` keywords accept glob patterns that use characters like `*`, `**`, `+`, `?`, `!` and others to match more than one branch name. If a name contains any of these characters and you want a literal match, you need to escape each of these special characters with `\`. For more information about glob patterns, see the "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet)." +The `branches` and `branches-ignore` keywords accept glob patterns that use characters like `*`, `**`, `+`, `?`, `!` and others to match more than one branch name. If a name contains any of these characters and you want a literal match, you need to escape each of these special characters with `\`. For more information about glob patterns, see the [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#filter-pattern-cheat-sheet). From 540d58bd3da5acf436cd603c1e37ba942f2e33d4 Mon Sep 17 00:00:00 2001 From: Roniece Ricardo <33437850+RonRicardo@users.noreply.github.com> Date: Fri, 20 Dec 2024 15:09:53 -0500 Subject: [PATCH 2/2] [Quote removal] Remove quotes from data/reusables/dependency-graph through data/reusables/files (#53676) Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com> --- data/reusables/dependency-graph/sbom-export.md | 2 +- .../supported-package-ecosystems.md | 4 ++-- .../about-dependency-review-action2.md | 2 +- .../dependency-review-action-overview.md | 2 +- .../dependency-review-enabled-ghes.md | 2 +- .../dependency-review/org-level-enforcement.md | 2 +- .../about-dependency-submission.md | 4 ++-- .../dependency-submission-link.md | 2 +- data/reusables/desktop/about-github-desktop.md | 2 +- data/reusables/desktop/checked-out-pr.md | 2 +- data/reusables/desktop/get-an-account.md | 2 +- data/reusables/desktop/protected-branches.md | 2 +- .../desktop/resolve-merge-conflicts.md | 2 +- .../limit_workflow_to_activity_types.md | 2 +- .../pull_request_forked_repos_link.md | 6 +++--- .../discussions/add-category-to-section.md | 2 +- .../marking-a-comment-as-an-answer.md | 2 +- .../discussions/you-can-label-discussions.md | 2 +- .../discussions/you-can-use-discussions.md | 2 +- data/reusables/docs/ghec-docs.md | 2 +- .../docs/you-can-read-docs-for-your-product.md | 2 +- .../dotcom_billing/payment-methods.md | 2 +- .../dotcom_billing/view-all-subscriptions.md | 2 +- .../education/about-github-education-link.md | 2 +- .../access-github-community-exchange.md | 4 ++-- data/reusables/education/apply-for-team.md | 2 +- .../education/student-codespaces-benefit.md | 2 +- data/reusables/emus/migration-roles-prereq.md | 2 +- data/reusables/emus/ssh-ca-support-for-emu.md | 2 +- .../emus/use-enterprise-recovery-code.md | 2 +- .../azure-admin-approval-required-message.md | 2 +- .../download-recovery-codes.md | 2 +- .../emu-configure-authentication.md | 4 ++-- .../emu-configure-provisioning.md | 2 +- .../enterprise-accounts/emu-create-a-pat.md | 2 +- .../emu-manage-org-membership.md | 2 +- .../emu-more-info-account.md | 2 +- .../enterprise-accounts/emu-saml-note.md | 2 +- .../enterprise-accounts/emu-scim-note.md | 2 +- .../enterprise-accounts/emu-short-summary.md | 2 +- .../enterprise-accounts/invite-organization.md | 2 +- .../enterprise-accounts/license-tab.md | 2 +- .../support-entitlements.md | 2 +- .../enterprise-accounts/team-sync-override.md | 2 +- .../tenant-app-permissions.md | 2 +- .../enterprise-licensing/about-license-sync.md | 2 +- .../verified-domains-license-sync.md | 2 +- .../view-consumed-licenses.md | 2 +- .../enterprise-managed/assigning-roles.md | 2 +- .../enterprise-managed/emu-prerequisite.md | 2 +- .../repo-collaborators-note.md | 2 +- .../about-the-migrator-role.md | 4 ++-- .../blob-storage-management-console.md | 2 +- .../branch-protection-migration.md | 2 +- .../checking-the-migration-status.md | 2 +- .../configuring-ip-allow-lists.md | 2 +- .../enterprise-migration-tool/create-pats.md | 2 +- .../creating-a-pat-steps.md | 6 +++--- .../data-not-migrated.md | 6 +++--- .../deploy-key-bypass.md | 2 +- .../download-migration-logs-flag.md | 2 +- .../extra-requirements-storage.md | 2 +- .../github-pat-required-scopes.md | 2 +- .../github-trial-prerequisite.md | 2 +- .../grant-migrator-role-graphql.md | 2 +- .../identifying-githubs-ip-ranges.md | 2 +- .../install-gei-extension-intro.md | 2 +- .../limitations-of-migrated-data.md | 10 +++++----- .../migration-query-method.md | 2 +- .../path-to-key-placeholder.md | 2 +- .../reclaiming-mannequins.md | 4 ++-- .../reviewing-the-migration-log.md | 4 ++-- .../setting-repository-visibility.md | 2 +- .../validate-migration-logs.md | 2 +- .../enterprise/about-deployment-methods.md | 2 +- data/reusables/enterprise/about-ssh-ports.md | 6 +++--- data/reusables/enterprise/about-upgrades.md | 2 +- data/reusables/enterprise/best-practices.md | 2 +- data/reusables/enterprise/editor-role-note.md | 6 +++--- .../reusables/enterprise/link-to-ghec-trial.md | 2 +- .../repo-policy-rules-alternative.md | 2 +- .../repo-policy-rules-more-flexible.md | 2 +- ...repo-policy-rules-with-custom-properties.md | 2 +- .../enterprise/role-permission-hierarchy.md | 2 +- ...ingle-organizations-enterprise-migration.md | 2 +- data/reusables/enterprise/test-in-staging.md | 2 +- .../enterprise/user-messages-markdown.md | 2 +- .../enterprise_clustering/cluster-ip-note.md | 6 +++--- .../enterprise_clustering/health_checks.md | 2 +- .../enterprise_clustering/load_balancer_dns.md | 2 +- ...acing-a-cluster-node-modify-cluster-conf.md | 2 +- ...eplacing-a-cluster-node-need-three-nodes.md | 2 +- ...eplacing-a-cluster-node-replacement-name.md | 2 +- .../enterprise_clustering/ssh-to-a-node.md | 2 +- .../use_ghe_cluster_support_bundle.md | 2 +- .../about-adjusting-resources.md | 2 +- .../azure-instance-recommendation.md | 6 +++--- .../create-ghe-instance.md | 2 +- .../disable-github-pages-warning.md | 2 +- .../download-license.md | 2 +- .../enterprise_installation/download-note.md | 2 +- .../hardware-considerations-all-platforms.md | 18 +++++++++--------- .../hotpatching-explanation.md | 2 +- ...-communicate-and-enable-maintenance-mode.md | 4 ++-- .../increase-resources-shut-down.md | 2 +- ...rease-resources-test-in-maintenance-mode.md | 2 +- .../replication-status-upgrade.md | 2 +- .../enterprise_installation/request-a-trial.md | 2 +- .../software-license.md | 2 +- .../ssh-into-cluster-node.md | 2 +- .../ssh-into-staging-instance.md | 2 +- .../upload-a-license-file.md | 2 +- .../warning-on-upgrading-physical-resources.md | 2 +- .../when-9418-necessary.md | 2 +- .../api-deprecation.md | 2 +- .../test-domain-settings-failure.md | 2 +- .../type-management-console-password.md | 2 +- .../unlocking-management-console-with-shell.md | 2 +- .../locking-repositories.md | 2 +- .../ready-to-import-migrations.md | 2 +- .../add-key-to-web-flow-user.md | 2 +- .../maintenance-mode-status.md | 2 +- .../management-console-access.md | 2 +- .../sign-in-as-root-administrator.md | 2 +- .../SAML-to-OIDC-migration-for-EMU.md | 2 +- ...rnatively-enable-external-authentication.md | 2 +- .../built-in-authentication-option.md | 2 +- .../built-in-authentication.md | 2 +- .../external_auth_disables_2fa.md | 2 +- .../ghec-supported-idps.md | 4 ++-- .../ldap-sync-nested-teams.md | 2 +- .../manage-global-webhooks-api.md | 2 +- .../migration-teams-warning.md | 2 +- .../scim-manages-user-lifecycle.md | 2 +- data/reusables/files/choose-commit-email.md | 2 +- data/reusables/files/choose_commit_branch.md | 2 +- .../files/commit-author-email-options.md | 2 +- data/reusables/files/commit-message.md | 2 +- data/reusables/files/delete_branch.md | 2 +- data/reusables/files/merge_pull_request.md | 2 +- data/reusables/files/write_commit_message.md | 2 +- data/reusables/gated-features/cluster.md | 2 +- .../gated-features/code-review-assignment.md | 2 +- .../codespaces-classroom-articles.md | 2 +- .../reusables/gated-features/codespaces-org.md | 2 +- .../gated-features/codespaces-repo.md | 2 +- .../gated-features/delegated-bypass.md | 2 +- data/reusables/gated-features/display-names.md | 2 +- data/reusables/gated-features/emus.md | 2 +- .../gated-features/generated-health-checks.md | 2 +- data/reusables/gated-features/ghas-ghec.md | 2 +- data/reusables/gated-features/ghas.md | 2 +- .../gated-features/more-info-org-products.md | 2 +- data/reusables/gated-features/more-info.md | 2 +- data/reusables/gated-features/packages.md | 4 ++-- data/reusables/gated-features/pages.md | 2 +- .../gated-features/repository-insights.md | 2 +- .../gated-features/restrict-email-domain.md | 2 +- .../verify-and-approve-domain.md | 2 +- 159 files changed, 195 insertions(+), 195 deletions(-) diff --git a/data/reusables/dependency-graph/sbom-export.md b/data/reusables/dependency-graph/sbom-export.md index 7abc0d824c80..5b7ed57c9e6c 100644 --- a/data/reusables/dependency-graph/sbom-export.md +++ b/data/reusables/dependency-graph/sbom-export.md @@ -1 +1 @@ -If you have at least read access to the repository, you can export the dependency graph for the repository as an SPDX-compatible, Software Bill of Materials (SBOM), via the {% data variables.product.prodname_dotcom %} UI or {% data variables.product.company_short %} REST API. For more information, see "[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/exporting-a-software-bill-of-materials-for-your-repository)." +If you have at least read access to the repository, you can export the dependency graph for the repository as an SPDX-compatible, Software Bill of Materials (SBOM), via the {% data variables.product.prodname_dotcom %} UI or {% data variables.product.company_short %} REST API. For more information, see [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/exporting-a-software-bill-of-materials-for-your-repository). diff --git a/data/reusables/dependency-graph/supported-package-ecosystems.md b/data/reusables/dependency-graph/supported-package-ecosystems.md index 41d7d3a34bb1..980defbf2e1b 100644 --- a/data/reusables/dependency-graph/supported-package-ecosystems.md +++ b/data/reusables/dependency-graph/supported-package-ecosystems.md @@ -19,5 +19,5 @@ > [!NOTE] > * If you list your Python dependencies within a `setup.py` file, we may not be able to parse and list every dependency in your project. -> * {% data variables.product.prodname_actions %} workflows must be located in the `.github/workflows/` directory of a repository to be recognized as manifests. Any actions or workflows referenced using the syntax `jobs[*].steps[*].uses` or `jobs..uses` will be parsed as dependencies. For more information, see "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions)." -> * {% data reusables.dependabot.dependabot-alert-actions-semver %} For more information, see "[AUTOTITLE](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts)" and "[AUTOTITLE](/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates)." +> * {% data variables.product.prodname_actions %} workflows must be located in the `.github/workflows/` directory of a repository to be recognized as manifests. Any actions or workflows referenced using the syntax `jobs[*].steps[*].uses` or `jobs..uses` will be parsed as dependencies. For more information, see [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions). +> * {% data reusables.dependabot.dependabot-alert-actions-semver %} For more information, see [AUTOTITLE](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts) and [AUTOTITLE](/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates). diff --git a/data/reusables/dependency-review/about-dependency-review-action2.md b/data/reusables/dependency-review/about-dependency-review-action2.md index 09a9ec45eab5..18d58ccf0025 100644 --- a/data/reusables/dependency-review/about-dependency-review-action2.md +++ b/data/reusables/dependency-review/about-dependency-review-action2.md @@ -1 +1 @@ -By default, the {% data variables.dependency-review.action_name %} check will fail if it discovers any vulnerable packages. A failed check blocks a pull request from being merged when the repository owner requires the dependency review check to pass. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-status-checks-before-merging)." +By default, the {% data variables.dependency-review.action_name %} check will fail if it discovers any vulnerable packages. A failed check blocks a pull request from being merged when the repository owner requires the dependency review check to pass. For more information, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-status-checks-before-merging). diff --git a/data/reusables/dependency-review/dependency-review-action-overview.md b/data/reusables/dependency-review/dependency-review-action-overview.md index b572ec18e7a9..ebd90afa27c1 100644 --- a/data/reusables/dependency-review/dependency-review-action-overview.md +++ b/data/reusables/dependency-review/dependency-review-action-overview.md @@ -1,3 +1,3 @@ The {% data variables.dependency-review.action_name %} scans your pull requests for dependency changes and raises an error if any new dependencies have known vulnerabilities. The action is supported by an API endpoint that compares the dependencies between two revisions and reports any differences. -For more information about the action and the API endpoint, see the [`dependency-review-action`](https://github.com/actions/dependency-review-action) documentation, and "[AUTOTITLE](/rest/dependency-graph/dependency-review)." +For more information about the action and the API endpoint, see the [`dependency-review-action`](https://github.com/actions/dependency-review-action) documentation, and [AUTOTITLE](/rest/dependency-graph/dependency-review). diff --git a/data/reusables/dependency-review/dependency-review-enabled-ghes.md b/data/reusables/dependency-review/dependency-review-enabled-ghes.md index ccf3911d955c..4dd98ffcf66d 100644 --- a/data/reusables/dependency-review/dependency-review-enabled-ghes.md +++ b/data/reusables/dependency-review/dependency-review-enabled-ghes.md @@ -1,3 +1,3 @@ {% ifversion ghes %} -After you enable the dependency graph, users will have access to the dependency review feature. {% data reusables.dependency-review.short-summary %} For more information, see "[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)." +After you enable the dependency graph, users will have access to the dependency review feature. {% data reusables.dependency-review.short-summary %} For more information, see [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review). {% endif %} diff --git a/data/reusables/dependency-review/org-level-enforcement.md b/data/reusables/dependency-review/org-level-enforcement.md index 724247407a63..b7a8d2b90b1b 100644 --- a/data/reusables/dependency-review/org-level-enforcement.md +++ b/data/reusables/dependency-review/org-level-enforcement.md @@ -1,5 +1,5 @@ {% ifversion repo-rules %} -Organization owners can roll out dependency review at scale by enforcing the use of the {% data variables.dependency-review.action_name %} across repositories in the organization. This involves the use of repository rulesets for which you'll set the {% data variables.dependency-review.action_name %} as a required workflow, which means that pull requests can only be merged once the workflow passes all the required checks. For more information, see "[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/enforcing-dependency-review-across-an-organization)." +Organization owners can roll out dependency review at scale by enforcing the use of the {% data variables.dependency-review.action_name %} across repositories in the organization. This involves the use of repository rulesets for which you'll set the {% data variables.dependency-review.action_name %} as a required workflow, which means that pull requests can only be merged once the workflow passes all the required checks. For more information, see [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/enforcing-dependency-review-across-an-organization). {% endif %} diff --git a/data/reusables/dependency-submission/about-dependency-submission.md b/data/reusables/dependency-submission/about-dependency-submission.md index 5cd9fb70da9f..751da226dac0 100644 --- a/data/reusables/dependency-submission/about-dependency-submission.md +++ b/data/reusables/dependency-submission/about-dependency-submission.md @@ -1,8 +1,8 @@ You can use the REST API to submit dependencies for a project. This enables you to add dependencies, such as those resolved when software is compiled or built, to {% data variables.product.prodname_dotcom %}'s dependency graph feature, providing a more complete picture of all of your project's dependencies. -The dependency graph shows any dependencies you submit using the API in addition to any dependencies that are identified from manifest or lock files in the repository (for example, a `package-lock.json` file in a JavaScript project). For more information about viewing the dependency graph, see "[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#viewing-the-dependency-graph)." +The dependency graph shows any dependencies you submit using the API in addition to any dependencies that are identified from manifest or lock files in the repository (for example, a `package-lock.json` file in a JavaScript project). For more information about viewing the dependency graph, see [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#viewing-the-dependency-graph). -Submitted dependencies will receive {% data variables.product.prodname_dependabot_alerts %} and {% data variables.product.prodname_dependabot_security_updates %} for any known vulnerabilities. You will only get {% data variables.product.prodname_dependabot_alerts %} for dependencies that are from one of the supported ecosystems for the {% data variables.product.prodname_advisory_database %}. For more information about these ecosystems, see "[AUTOTITLE](/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database#github-reviewed-advisories)." For transitive dependencies submitted via the {% data variables.dependency-submission-api.name %}, {% data variables.product.prodname_dependabot %} will automatically open pull requests to update the parent dependency, if an update is available. +Submitted dependencies will receive {% data variables.product.prodname_dependabot_alerts %} and {% data variables.product.prodname_dependabot_security_updates %} for any known vulnerabilities. You will only get {% data variables.product.prodname_dependabot_alerts %} for dependencies that are from one of the supported ecosystems for the {% data variables.product.prodname_advisory_database %}. For more information about these ecosystems, see [AUTOTITLE](/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database#github-reviewed-advisories). For transitive dependencies submitted via the {% data variables.dependency-submission-api.name %}, {% data variables.product.prodname_dependabot %} will automatically open pull requests to update the parent dependency, if an update is available. {% ifversion dependency-review-submission-api %}Submitted dependencies will be shown in dependency review, but are _not_ available in your organization's dependency insights. diff --git a/data/reusables/dependency-submission/dependency-submission-link.md b/data/reusables/dependency-submission/dependency-submission-link.md index 82431bf45ddf..32cee1443fb2 100644 --- a/data/reusables/dependency-submission/dependency-submission-link.md +++ b/data/reusables/dependency-submission/dependency-submission-link.md @@ -1,2 +1,2 @@ Additionally, you can use the {% data variables.dependency-submission-api.name %} to submit dependencies from the package manager or ecosystem of your choice, even if the ecosystem is not supported by dependency graph for manifest or lock file analysis. -{% ifversion dependency-graph-repository-view-update %}Dependencies submitted to a project using the {% data variables.dependency-submission-api.name %} will show which detector was used for their submission and when they were submitted.{% elsif ghes %} The dependency graph will display the submitted dependencies grouped by ecosystem, but separately from the dependencies parsed from manifest or lock files.{% else %}{% endif %} For more information on the {% data variables.dependency-submission-api.name %}, see "[AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/using-the-dependency-submission-api)." +{% ifversion dependency-graph-repository-view-update %}Dependencies submitted to a project using the {% data variables.dependency-submission-api.name %} will show which detector was used for their submission and when they were submitted.{% elsif ghes %} The dependency graph will display the submitted dependencies grouped by ecosystem, but separately from the dependencies parsed from manifest or lock files.{% else %}{% endif %} For more information on the {% data variables.dependency-submission-api.name %}, see [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/using-the-dependency-submission-api). diff --git a/data/reusables/desktop/about-github-desktop.md b/data/reusables/desktop/about-github-desktop.md index 48a449790a1d..98164ec6107f 100644 --- a/data/reusables/desktop/about-github-desktop.md +++ b/data/reusables/desktop/about-github-desktop.md @@ -1 +1 @@ -{% data variables.product.prodname_desktop %} is a free, open source application that helps you to work with code hosted on {% data variables.product.prodname_dotcom %} or other Git hosting services. With {% data variables.product.prodname_desktop %}, you can perform Git commands, such as committing and pushing changes, in a graphical user interface, rather than using the command line. For more information, see "[AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/about-github-desktop)." +{% data variables.product.prodname_desktop %} is a free, open source application that helps you to work with code hosted on {% data variables.product.prodname_dotcom %} or other Git hosting services. With {% data variables.product.prodname_desktop %}, you can perform Git commands, such as committing and pushing changes, in a graphical user interface, rather than using the command line. For more information, see [AUTOTITLE](/desktop/installing-and-configuring-github-desktop/overview/about-github-desktop). diff --git a/data/reusables/desktop/checked-out-pr.md b/data/reusables/desktop/checked-out-pr.md index 665cffecb01a..eff1970c2d07 100644 --- a/data/reusables/desktop/checked-out-pr.md +++ b/data/reusables/desktop/checked-out-pr.md @@ -1 +1 @@ -When you have opened a pull request branch, you can view the contents of the branch in an editor, view the diff and commit history of the contributor's updates, and view and re-run checks. For more information, see "[Working with a pull request in {% data variables.product.prodname_desktop %}](#working-with-a-pull-request-in-github-desktop)." +When you have opened a pull request branch, you can view the contents of the branch in an editor, view the diff and commit history of the contributor's updates, and view and re-run checks. For more information, see [Working with a pull request in {% data variables.product.prodname_desktop %}](#working-with-a-pull-request-in-github-desktop). diff --git a/data/reusables/desktop/get-an-account.md b/data/reusables/desktop/get-an-account.md index ca9b9d6daecb..50d3340168a5 100644 --- a/data/reusables/desktop/get-an-account.md +++ b/data/reusables/desktop/get-an-account.md @@ -1 +1 @@ -you must already have an account on {% data variables.product.github %}.{% ifversion fpt or ghec %} For more information, see "[AUTOTITLE](/get-started/start-your-journey/creating-an-account-on-github)."{% endif %}{% ifversion ghec %} If you're part of an organization that uses {% data variables.product.prodname_emus %} and you do not have an account, contact your enterprise administrator.{% elsif ghes %} If you're a member of an organization that uses {% data variables.product.product_name %} and you do not have an account, contact your {% data variables.product.prodname_enterprise %} site administrator.{% endif %} +you must already have an account on {% data variables.product.github %}.{% ifversion fpt or ghec %} For more information, see [AUTOTITLE](/get-started/start-your-journey/creating-an-account-on-github).{% endif %}{% ifversion ghec %} If you're part of an organization that uses {% data variables.product.prodname_emus %} and you do not have an account, contact your enterprise administrator.{% elsif ghes %} If you're a member of an organization that uses {% data variables.product.product_name %} and you do not have an account, contact your {% data variables.product.prodname_enterprise %} site administrator.{% endif %} diff --git a/data/reusables/desktop/protected-branches.md b/data/reusables/desktop/protected-branches.md index c2b43ebc675d..d1412be22443 100644 --- a/data/reusables/desktop/protected-branches.md +++ b/data/reusables/desktop/protected-branches.md @@ -1 +1 @@ -Repository administrators can enable protections on a branch. If you're working on a branch that's protected, you won't be able to delete or force push to the branch. Repository administrators can enable other protected branch settings to enforce specific workflows before a branch can be merged. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)." +Repository administrators can enable protections on a branch. If you're working on a branch that's protected, you won't be able to delete or force push to the branch. Repository administrators can enable other protected branch settings to enforce specific workflows before a branch can be merged. For more information, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches). diff --git a/data/reusables/desktop/resolve-merge-conflicts.md b/data/reusables/desktop/resolve-merge-conflicts.md index ae63e2ac8030..aaf5d98775e5 100644 --- a/data/reusables/desktop/resolve-merge-conflicts.md +++ b/data/reusables/desktop/resolve-merge-conflicts.md @@ -1 +1 @@ -1. Resolve any merge conflicts in your preferred way, using a text editor, the command line, or another tool. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts)." +1. Resolve any merge conflicts in your preferred way, using a text editor, the command line, or another tool. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/addressing-merge-conflicts). diff --git a/data/reusables/developer-site/limit_workflow_to_activity_types.md b/data/reusables/developer-site/limit_workflow_to_activity_types.md index 61c2dff791ce..58f7e10690df 100644 --- a/data/reusables/developer-site/limit_workflow_to_activity_types.md +++ b/data/reusables/developer-site/limit_workflow_to_activity_types.md @@ -1 +1 @@ -By default, all activity types trigger workflows that run on this event. You can limit your workflow runs to specific activity types using the `types` keyword. For more information, see "[AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#onevent_nametypes)." +By default, all activity types trigger workflows that run on this event. You can limit your workflow runs to specific activity types using the `types` keyword. For more information, see [AUTOTITLE](/actions/using-workflows/workflow-syntax-for-github-actions#onevent_nametypes). diff --git a/data/reusables/developer-site/pull_request_forked_repos_link.md b/data/reusables/developer-site/pull_request_forked_repos_link.md index aab0a7b2bd7a..66dc205abb6b 100644 --- a/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -2,17 +2,17 @@ Workflows don't run in forked repositories by default. You must enable GitHub Actions in the **Actions** tab of the forked repository. -{% data reusables.actions.forked-secrets %} The `GITHUB_TOKEN` has read-only permissions in pull requests from forked repositories. For more information, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication)." +{% data reusables.actions.forked-secrets %} The `GITHUB_TOKEN` has read-only permissions in pull requests from forked repositories. For more information, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication). #### Pull request events for forked repositories For pull requests from a forked repository to the base repository, {% data variables.product.product_name %} sends the `pull_request`, `issue_comment`, `pull_request_review_comment`, `pull_request_review`, and `pull_request_target` events to the base repository. No pull request events occur on the forked repository. {% ifversion fpt or ghec %} -When a first-time contributor submits a pull request to a public repository, a maintainer with write access may need to approve running workflows on the pull request. For more information, see "[AUTOTITLE](/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks)." +When a first-time contributor submits a pull request to a public repository, a maintainer with write access may need to approve running workflows on the pull request. For more information, see [AUTOTITLE](/actions/managing-workflow-runs/approving-workflow-runs-from-public-forks). {% endif %} -For pull requests from a forked repository to a private repository, workflows only run when they are enabled, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#enabling-workflows-for-forks-of-private-repositories)." +For pull requests from a forked repository to a private repository, workflows only run when they are enabled, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository#enabling-workflows-for-forks-of-private-repositories). > [!NOTE] > Workflows triggered by {% data variables.product.prodname_dependabot %} pull requests are treated as though they are from a forked repository, and are also subject to these restrictions. diff --git a/data/reusables/discussions/add-category-to-section.md b/data/reusables/discussions/add-category-to-section.md index fbe8d3e8fc28..9bd25004b382 100644 --- a/data/reusables/discussions/add-category-to-section.md +++ b/data/reusables/discussions/add-category-to-section.md @@ -1,3 +1,3 @@ -1. Optionally, add the category to a section. A category can only belong to one section at a time. For information on how to create a section, see "[Creating a section](#creating-a-section)." +1. Optionally, add the category to a section. A category can only belong to one section at a time. For information on how to create a section, see [Creating a section](#creating-a-section). ![Screenshot of part of the "Create category" page, showing the option to add a category to a section.](/assets/images/help/discussions/add-category-to-section.png) diff --git a/data/reusables/discussions/marking-a-comment-as-an-answer.md b/data/reusables/discussions/marking-a-comment-as-an-answer.md index 45c922b5b3b7..cabc9db14349 100644 --- a/data/reusables/discussions/marking-a-comment-as-an-answer.md +++ b/data/reusables/discussions/marking-a-comment-as-an-answer.md @@ -1,4 +1,4 @@ -You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. For more information, see "[AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions). When you mark a question as an answer, {% data variables.product.product_name %} will highlight the comment and replies to the comment to help visitors quickly find the answer. diff --git a/data/reusables/discussions/you-can-label-discussions.md b/data/reusables/discussions/you-can-label-discussions.md index 763ff2665324..a5d58911c758 100644 --- a/data/reusables/discussions/you-can-label-discussions.md +++ b/data/reusables/discussions/you-can-label-discussions.md @@ -1 +1 @@ -To organize discussions more granularly, you can apply labels. For example, you can use labels to indicate the status of a discussion to make triaging more efficient. Each repository has one shared set of labels for issues, pull requests, and discussions. For more information, see "[AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels)." +To organize discussions more granularly, you can apply labels. For example, you can use labels to indicate the status of a discussion to make triaging more efficient. Each repository has one shared set of labels for issues, pull requests, and discussions. For more information, see [AUTOTITLE](/issues/using-labels-and-milestones-to-track-work/managing-labels). diff --git a/data/reusables/discussions/you-can-use-discussions.md b/data/reusables/discussions/you-can-use-discussions.md index 0196fa50085a..d615f596c7ff 100644 --- a/data/reusables/discussions/you-can-use-discussions.md +++ b/data/reusables/discussions/you-can-use-discussions.md @@ -1 +1 @@ -You can use {% data variables.product.prodname_discussions %} to ask and answer questions, share information, make announcements, and conduct or participate in conversations about a project. For more information, see "[AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +You can use {% data variables.product.prodname_discussions %} to ask and answer questions, share information, make announcements, and conduct or participate in conversations about a project. For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions). diff --git a/data/reusables/docs/ghec-docs.md b/data/reusables/docs/ghec-docs.md index e7612d06668f..75dccd0c8eea 100644 --- a/data/reusables/docs/ghec-docs.md +++ b/data/reusables/docs/ghec-docs.md @@ -1 +1 @@ -You can read documentation that reflects the features available with {% data variables.product.prodname_ghe_cloud %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/about-versions-of-github-docs)." +You can read documentation that reflects the features available with {% data variables.product.prodname_ghe_cloud %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/about-versions-of-github-docs). diff --git a/data/reusables/docs/you-can-read-docs-for-your-product.md b/data/reusables/docs/you-can-read-docs-for-your-product.md index 491aabb29c72..879bc2c0ed85 100644 --- a/data/reusables/docs/you-can-read-docs-for-your-product.md +++ b/data/reusables/docs/you-can-read-docs-for-your-product.md @@ -1 +1 @@ -You can read documentation that reflects the features available to you on {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/about-versions-of-github-docs)." +You can read documentation that reflects the features available to you on {% data variables.product.product_name %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/about-versions-of-github-docs). diff --git a/data/reusables/dotcom_billing/payment-methods.md b/data/reusables/dotcom_billing/payment-methods.md index 792afc555669..1c29db6c741b 100644 --- a/data/reusables/dotcom_billing/payment-methods.md +++ b/data/reusables/dotcom_billing/payment-methods.md @@ -2,7 +2,7 @@ If your {% data variables.product.prodname_ghe_cloud %} account uses metered billing, you can pay for your licenses with a credit card, PayPal, or through an Azure subscription. For purchase orders, contact your account manager in {% data variables.contact.contact_enterprise_sales %}. -> [!IMPORTANT] If you currently pay for your {% data variables.product.prodname_enterprise %} licenses through a volume, subscription, or prepaid agreement, you will continue to be billed in this way until your agreement expires. At renewal, you have the option to switch to the metered billing model. See, "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/getting-started-with-the-enhanced-billing-platform)." +> [!IMPORTANT] If you currently pay for your {% data variables.product.prodname_enterprise %} licenses through a volume, subscription, or prepaid agreement, you will continue to be billed in this way until your agreement expires. At renewal, you have the option to switch to the metered billing model. See, [AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/getting-started-with-the-enhanced-billing-platform). > > If you do not have an account manager and pay for {% data variables.product.prodname_enterprise %} via credit card or PayPal, the transition to usage-based billing will be prompted by the product in the future, but this is not currently supported. diff --git a/data/reusables/dotcom_billing/view-all-subscriptions.md b/data/reusables/dotcom_billing/view-all-subscriptions.md index 5c427d90d515..9007c77c48e1 100644 --- a/data/reusables/dotcom_billing/view-all-subscriptions.md +++ b/data/reusables/dotcom_billing/view-all-subscriptions.md @@ -1 +1 @@ -To view all the subscriptions for your account on {% data variables.product.prodname_dotcom %}, see "[AUTOTITLE](/billing/managing-your-github-billing-settings/viewing-your-subscriptions-and-billing-date)." +To view all the subscriptions for your account on {% data variables.product.prodname_dotcom %}, see [AUTOTITLE](/billing/managing-your-github-billing-settings/viewing-your-subscriptions-and-billing-date). diff --git a/data/reusables/education/about-github-education-link.md b/data/reusables/education/about-github-education-link.md index 853c682acab7..0a61494967cd 100644 --- a/data/reusables/education/about-github-education-link.md +++ b/data/reusables/education/about-github-education-link.md @@ -1,3 +1,3 @@ As a student or faculty member at an accredited educational institution, you can apply for {% data variables.product.prodname_global_campus %}. {% data variables.product.prodname_global_campus %} is a portal that allows the GitHub Education Community to access their education benefits—all in one place! The {% data variables.product.prodname_global_campus %} portal includes access to {% data variables.product.prodname_education_community_with_url %}, industry tools used by professional developers, events, [Campus TV](https://www.twitch.tv/githubeducation) content, {% data variables.product.prodname_classroom_with_url %}, [{% data variables.product.prodname_community_exchange %}](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-community-exchange), {% data variables.product.prodname_student_pack %}, and other exclusive features to help students and teachers shape the next generation of software development. -Before applying for an individual discount, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see "[AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-github-campus-program)." +Before applying for an individual discount, check if your learning community is already partnered with us as a {% data variables.product.prodname_campus_program %} school. For more information, see [AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/use-github-at-your-educational-institution/about-github-campus-program). diff --git a/data/reusables/education/access-github-community-exchange.md b/data/reusables/education/access-github-community-exchange.md index 476212bac439..7cc77cac200a 100644 --- a/data/reusables/education/access-github-community-exchange.md +++ b/data/reusables/education/access-github-community-exchange.md @@ -2,6 +2,6 @@ To access {% data variables.product.prodname_community_exchange %}, visit your { If you're a student or faculty member at an accredited educational institution, you can apply for {% data variables.product.prodname_education %} benefits, which includes access to {% data variables.product.prodname_community_exchange %} within {% data variables.product.prodname_global_campus %}. -* If you’re a student and you haven't joined {% data variables.product.prodname_education %} yet, apply using the [student application form]( https://education.github.com/discount_requests/student_application). For more information, see "[AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students)." +* If you’re a student and you haven't joined {% data variables.product.prodname_education %} yet, apply using the [student application form]( https://education.github.com/discount_requests/student_application). For more information, see [AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-students/about-github-global-campus-for-students). -* If you’re an educator and you haven't joined {% data variables.product.prodname_education %} yet, apply using the [teacher application form]( https://education.github.com/discount_requests/teacher_application). For more information, see "[AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher)." +* If you’re an educator and you haven't joined {% data variables.product.prodname_education %} yet, apply using the [teacher application form]( https://education.github.com/discount_requests/teacher_application). For more information, see [AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-global-campus-for-teachers/apply-to-github-global-campus-as-a-teacher). diff --git a/data/reusables/education/apply-for-team.md b/data/reusables/education/apply-for-team.md index 14722641748f..c9c29a9c8be0 100644 --- a/data/reusables/education/apply-for-team.md +++ b/data/reusables/education/apply-for-team.md @@ -1 +1 @@ -* Apply for free [{% data variables.product.prodname_team %}](/get-started/learning-about-github/githubs-plans), which allows unlimited users and private repositories. For more information, see "[AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-education-for-teachers/apply-to-github-education-as-a-teacher)." +* Apply for free [{% data variables.product.prodname_team %}](/get-started/learning-about-github/githubs-plans), which allows unlimited users and private repositories. For more information, see [AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-education-for-teachers/apply-to-github-education-as-a-teacher). diff --git a/data/reusables/education/student-codespaces-benefit.md b/data/reusables/education/student-codespaces-benefit.md index 6da39f0277a3..57015ec66351 100644 --- a/data/reusables/education/student-codespaces-benefit.md +++ b/data/reusables/education/student-codespaces-benefit.md @@ -1 +1 @@ -Verified students get free use of {% data variables.product.prodname_github_codespaces %}, up to 180 core hours per month, for their personal accounts. The monthly amount of storage and core hours of usage available to students is equivalent to the amount included with {% data variables.product.prodname_pro %} accounts. For more information, see "[AUTOTITLE](/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)." +Verified students get free use of {% data variables.product.prodname_github_codespaces %}, up to 180 core hours per month, for their personal accounts. The monthly amount of storage and core hours of usage available to students is equivalent to the amount included with {% data variables.product.prodname_pro %} accounts. For more information, see [AUTOTITLE](/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces). diff --git a/data/reusables/emus/migration-roles-prereq.md b/data/reusables/emus/migration-roles-prereq.md index 2d754938745c..a704b036d7e7 100644 --- a/data/reusables/emus/migration-roles-prereq.md +++ b/data/reusables/emus/migration-roles-prereq.md @@ -1,4 +1,4 @@ * You'll need to access both your enterprise on {% data variables.product.github %} and your tenant on Entra ID. * To configure the {% data variables.product.prodname_emu_idp_oidc_application %} application on Entra ID, you must sign into the Entra ID tenant as a user with the Global Administrator role. - * To sign in as the setup user for your enterprise on {% data variables.product.github %}, you must use a recovery code for the enterprise. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes)." + * To sign in as the setup user for your enterprise on {% data variables.product.github %}, you must use a recovery code for the enterprise. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes). diff --git a/data/reusables/emus/ssh-ca-support-for-emu.md b/data/reusables/emus/ssh-ca-support-for-emu.md index 049000aa8663..4f3bea44f2ed 100644 --- a/data/reusables/emus/ssh-ca-support-for-emu.md +++ b/data/reusables/emus/ssh-ca-support-for-emu.md @@ -1 +1 @@ -Members cannot use the certificate to access forks of the organization's repositories, unless the enterprise has allowed SSH CAs to access user owned repositories. For more information, see "[AUTOTITLE](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities)." +Members cannot use the certificate to access forks of the organization's repositories, unless the enterprise has allowed SSH CAs to access user owned repositories. For more information, see [AUTOTITLE](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities). diff --git a/data/reusables/emus/use-enterprise-recovery-code.md b/data/reusables/emus/use-enterprise-recovery-code.md index 9587b2b17902..faf9a82e0120 100644 --- a/data/reusables/emus/use-enterprise-recovery-code.md +++ b/data/reusables/emus/use-enterprise-recovery-code.md @@ -1,4 +1,4 @@ 1. When prompted to continue to your identity provider, click **Use a recovery code** and sign in using one of your enterprise's recovery codes. > [!NOTE] - > You must use a recovery code for your enterprise, not your user account. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes)." + > You must use a recovery code for your enterprise, not your user account. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes). diff --git a/data/reusables/enterprise-accounts/azure-admin-approval-required-message.md b/data/reusables/enterprise-accounts/azure-admin-approval-required-message.md index 629317462c41..208448283142 100644 --- a/data/reusables/enterprise-accounts/azure-admin-approval-required-message.md +++ b/data/reusables/enterprise-accounts/azure-admin-approval-required-message.md @@ -1 +1 @@ -If you don't see a "Permissions requested" prompt, and instead see a message indicating that you need admin approval, see "[Message: "Need admin approval"](#message-need-admin-approval)." +If you don't see a "Permissions requested" prompt, and instead see a message indicating that you need admin approval, see [Message: "Need admin approval"](#message-need-admin-approval). diff --git a/data/reusables/enterprise-accounts/download-recovery-codes.md b/data/reusables/enterprise-accounts/download-recovery-codes.md index 7fb95cac8db6..9e7ac40b612d 100644 --- a/data/reusables/enterprise-accounts/download-recovery-codes.md +++ b/data/reusables/enterprise-accounts/download-recovery-codes.md @@ -1 +1 @@ -1. To ensure you can still access your enterprise on {% data variables.product.github %} if your IdP is unavailable in the future, click **Download**, **Print**, or **Copy** to save your recovery codes. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes)." +1. To ensure you can still access your enterprise on {% data variables.product.github %} if your IdP is unavailable in the future, click **Download**, **Print**, or **Copy** to save your recovery codes. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes). diff --git a/data/reusables/enterprise-accounts/emu-configure-authentication.md b/data/reusables/enterprise-accounts/emu-configure-authentication.md index 94125d790f46..b9ac6efa3d55 100644 --- a/data/reusables/enterprise-accounts/emu-configure-authentication.md +++ b/data/reusables/enterprise-accounts/emu-configure-authentication.md @@ -8,5 +8,5 @@ Next, configure how your members will authenticate. To get started, read the guide for your chosen authentication method. -* "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users)" -* "[AUTOTITLE](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users)" +* [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-oidc-for-enterprise-managed-users) +* [AUTOTITLE](/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/configuring-saml-single-sign-on-for-enterprise-managed-users) diff --git a/data/reusables/enterprise-accounts/emu-configure-provisioning.md b/data/reusables/enterprise-accounts/emu-configure-provisioning.md index 45c4bdb72a38..b4d7ea638dea 100644 --- a/data/reusables/enterprise-accounts/emu-configure-provisioning.md +++ b/data/reusables/enterprise-accounts/emu-configure-provisioning.md @@ -1 +1 @@ -After you configure authentication, you can configure SCIM provisioning, which is how your IdP will create {% data variables.enterprise.prodname_managed_users %} on {% data variables.product.github %}. See "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-scim-provisioning-for-enterprise-managed-users)." +After you configure authentication, you can configure SCIM provisioning, which is how your IdP will create {% data variables.enterprise.prodname_managed_users %} on {% data variables.product.github %}. See [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-scim-provisioning-for-enterprise-managed-users). diff --git a/data/reusables/enterprise-accounts/emu-create-a-pat.md b/data/reusables/enterprise-accounts/emu-create-a-pat.md index bba0075a7406..b2a71cffeecd 100644 --- a/data/reusables/enterprise-accounts/emu-create-a-pat.md +++ b/data/reusables/enterprise-accounts/emu-create-a-pat.md @@ -4,4 +4,4 @@ Next, create a {% data variables.product.pat_generic %} that you can use to conf * The token must have at least the **scim:enterprise** scope. * The token must have **no expiration**. -To learn how to create a {% data variables.product.pat_v1 %}, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)." +To learn how to create a {% data variables.product.pat_v1 %}, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). diff --git a/data/reusables/enterprise-accounts/emu-manage-org-membership.md b/data/reusables/enterprise-accounts/emu-manage-org-membership.md index b2d0245118d3..b56848957639 100644 --- a/data/reusables/enterprise-accounts/emu-manage-org-membership.md +++ b/data/reusables/enterprise-accounts/emu-manage-org-membership.md @@ -1 +1 @@ -After authentication and provisioning are configured, you can start managing organization membership for your {% data variables.enterprise.prodname_managed_users %} by synchronizing IdP groups with teams. See "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)." +After authentication and provisioning are configured, you can start managing organization membership for your {% data variables.enterprise.prodname_managed_users %} by synchronizing IdP groups with teams. See [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups). diff --git a/data/reusables/enterprise-accounts/emu-more-info-account.md b/data/reusables/enterprise-accounts/emu-more-info-account.md index 38639f4ffe4e..1d789f83fdbc 100644 --- a/data/reusables/enterprise-accounts/emu-more-info-account.md +++ b/data/reusables/enterprise-accounts/emu-more-info-account.md @@ -1 +1 @@ -For more information, see "[AUTOTITLE](/get-started/learning-about-github/types-of-github-accounts#enterprise-managed-users)." +For more information, see [AUTOTITLE](/get-started/learning-about-github/types-of-github-accounts#enterprise-managed-users). diff --git a/data/reusables/enterprise-accounts/emu-saml-note.md b/data/reusables/enterprise-accounts/emu-saml-note.md index 604f24357fb4..ece315989f7d 100644 --- a/data/reusables/enterprise-accounts/emu-saml-note.md +++ b/data/reusables/enterprise-accounts/emu-saml-note.md @@ -1,6 +1,6 @@ {% ifversion ghec %} > [!NOTE] -> If your enterprise uses {% data variables.product.prodname_emus %}, you must follow a different process to configure SAML single sign-on. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users)." +> If your enterprise uses {% data variables.product.prodname_emus %}, you must follow a different process to configure SAML single sign-on. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/configuring-saml-single-sign-on-for-enterprise-managed-users). {% endif %} diff --git a/data/reusables/enterprise-accounts/emu-scim-note.md b/data/reusables/enterprise-accounts/emu-scim-note.md index a0b66d26eb5d..f8b00faf1294 100644 --- a/data/reusables/enterprise-accounts/emu-scim-note.md +++ b/data/reusables/enterprise-accounts/emu-scim-note.md @@ -1,6 +1,6 @@ {% ifversion ghec %} > [!NOTE] -> If your enterprise uses {% data variables.product.prodname_emus %}, you do not need to use team synchronization. Instead, you can manage team membership via the SCIM configuration you created while setting up your enterprise. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)." +> If your enterprise uses {% data variables.product.prodname_emus %}, you do not need to use team synchronization. Instead, you can manage team membership via the SCIM configuration you created while setting up your enterprise. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups). {% endif %} diff --git a/data/reusables/enterprise-accounts/emu-short-summary.md b/data/reusables/enterprise-accounts/emu-short-summary.md index d91d145e9822..383693642830 100644 --- a/data/reusables/enterprise-accounts/emu-short-summary.md +++ b/data/reusables/enterprise-accounts/emu-short-summary.md @@ -1 +1 @@ -If you choose to use {% data variables.product.prodname_emus %}, you have increased control over your enterprise's members and resources. With {% data variables.product.prodname_emus %}, all members are provisioned and managed through your identity provider (IdP) instead of users creating their own accounts on {% data variables.product.product_name %}. Organization and team membership can be managed using groups on your IdP. {% data variables.enterprise.prodname_managed_users_caps %} are restricted to their enterprise and are unable to push code, collaborate, or interact with users, repositories, and organizations outside of their enterprise. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users){% ifversion not ghec %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %} +If you choose to use {% data variables.product.prodname_emus %}, you have increased control over your enterprise's members and resources. With {% data variables.product.prodname_emus %}, all members are provisioned and managed through your identity provider (IdP) instead of users creating their own accounts on {% data variables.product.product_name %}. Organization and team membership can be managed using groups on your IdP. {% data variables.enterprise.prodname_managed_users_caps %} are restricted to their enterprise and are unable to push code, collaborate, or interact with users, repositories, and organizations outside of their enterprise. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users){% ifversion not ghec %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %} diff --git a/data/reusables/enterprise-accounts/invite-organization.md b/data/reusables/enterprise-accounts/invite-organization.md index 763ed22f7851..e14cb6bd2fe3 100644 --- a/data/reusables/enterprise-accounts/invite-organization.md +++ b/data/reusables/enterprise-accounts/invite-organization.md @@ -1 +1 @@ -Enterprise account owners can invite existing organization accounts to join their enterprise. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#inviting-an-organization-to-join-your-enterprise-account)." +Enterprise account owners can invite existing organization accounts to join their enterprise. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/user-management/managing-organizations-in-your-enterprise/adding-organizations-to-your-enterprise#inviting-an-organization-to-join-your-enterprise-account). diff --git a/data/reusables/enterprise-accounts/license-tab.md b/data/reusables/enterprise-accounts/license-tab.md index 5db07109f16f..549a45749235 100644 --- a/data/reusables/enterprise-accounts/license-tab.md +++ b/data/reusables/enterprise-accounts/license-tab.md @@ -1,3 +1,3 @@ 1. Under **{% octicon "gear" aria-hidden="true" %} Settings**, click **{% ifversion ghec %}Licensing{% elsif ghes %}License{% endif %}**. {% ifversion enhanced-billing-platform %} - >[!NOTE] If you are on the enhanced billing platform, the licensing page has been relocated. See "[AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/gathering-insights-on-your-spending#viewing-license-usage)."{% endif %} + >[!NOTE] If you are on the enhanced billing platform, the licensing page has been relocated. See [AUTOTITLE](/billing/using-the-enhanced-billing-platform-for-enterprises/gathering-insights-on-your-spending#viewing-license-usage).{% endif %} diff --git a/data/reusables/enterprise-accounts/support-entitlements.md b/data/reusables/enterprise-accounts/support-entitlements.md index 1c8359987234..e4ac240e3402 100644 --- a/data/reusables/enterprise-accounts/support-entitlements.md +++ b/data/reusables/enterprise-accounts/support-entitlements.md @@ -1,6 +1,6 @@ {% ifversion ghec %} -To open, view, and comment on support tickets associated with an enterprise account, you must have support entitlements for the enterprise. Enterprise owners and billing managers automatically have a support entitlement, and enterprise owners can add support entitlements to enterprise members. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise)." +To open, view, and comment on support tickets associated with an enterprise account, you must have support entitlements for the enterprise. Enterprise owners and billing managers automatically have a support entitlement, and enterprise owners can add support entitlements to enterprise members. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/user-management/managing-users-in-your-enterprise/managing-support-entitlements-for-your-enterprise). > [!NOTE] > Any organization member can create tickets associated with an individual organization that is owned by an enterprise account. Support entitlements are only required to create tickets associated with the enterprise account itself. diff --git a/data/reusables/enterprise-accounts/team-sync-override.md b/data/reusables/enterprise-accounts/team-sync-override.md index 464d5e540315..26c764708328 100644 --- a/data/reusables/enterprise-accounts/team-sync-override.md +++ b/data/reusables/enterprise-accounts/team-sync-override.md @@ -1,3 +1,3 @@ {% ifversion ghec %} -If your organization is owned by an enterprise account, enabling team synchronization for the enterprise account will override your organization-level team synchronization settings. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise)." +If your organization is owned by an enterprise account, enabling team synchronization for the enterprise account will override your organization-level team synchronization settings. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-saml-for-enterprise-iam/managing-team-synchronization-for-organizations-in-your-enterprise). {% endif %} diff --git a/data/reusables/enterprise-accounts/tenant-app-permissions.md b/data/reusables/enterprise-accounts/tenant-app-permissions.md index 0218bba525d6..5924476e7d6c 100644 --- a/data/reusables/enterprise-accounts/tenant-app-permissions.md +++ b/data/reusables/enterprise-accounts/tenant-app-permissions.md @@ -1 +1 @@ -To select an Azure subscription, you must have owner permissions to the subscription. If the default tenant does not have the right permissions, you may need to specify a different tenant ID. For more information, see "[Prerequisites](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#prerequisites)" and [Microsoft identity platform and OAuth 2.0 authorization code flow](https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-auth-code-flow#request-an-authorization-code) in Microsoft Docs. +To select an Azure subscription, you must have owner permissions to the subscription. If the default tenant does not have the right permissions, you may need to specify a different tenant ID. For more information, see [Prerequisites](/billing/managing-the-plan-for-your-github-account/connecting-an-azure-subscription#prerequisites) and [Microsoft identity platform and OAuth 2.0 authorization code flow](https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-auth-code-flow#request-an-authorization-code) in Microsoft Docs. diff --git a/data/reusables/enterprise-licensing/about-license-sync.md b/data/reusables/enterprise-licensing/about-license-sync.md index f3292adb89bf..98b7d7afce01 100644 --- a/data/reusables/enterprise-licensing/about-license-sync.md +++ b/data/reusables/enterprise-licensing/about-license-sync.md @@ -1 +1 @@ -For a person using multiple {% data variables.product.prodname_enterprise %} environments to only consume a single license, you must synchronize license usage between environments. Then, {% data variables.product.company_short %} will deduplicate users based on the email addresses associated with their user accounts. {% data variables.product.company_short %} deduplicates licenses for the {% data variables.product.prodname_enterprise %} plan itself, {% ifversion ghas-in-license-sync %}and{% ifversion ghec %} if you use {% data variables.product.prodname_ghe_server %} version 3.12 or later,{% endif %} for {% data variables.product.prodname_GH_advanced_security %}{% else %}but not for other {% data variables.product.company_short %} products{% endif %}. For more information, see "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise#about-the-calculation-of-consumed-licenses)." +For a person using multiple {% data variables.product.prodname_enterprise %} environments to only consume a single license, you must synchronize license usage between environments. Then, {% data variables.product.company_short %} will deduplicate users based on the email addresses associated with their user accounts. {% data variables.product.company_short %} deduplicates licenses for the {% data variables.product.prodname_enterprise %} plan itself, {% ifversion ghas-in-license-sync %}and{% ifversion ghec %} if you use {% data variables.product.prodname_ghe_server %} version 3.12 or later,{% endif %} for {% data variables.product.prodname_GH_advanced_security %}{% else %}but not for other {% data variables.product.company_short %} products{% endif %}. For more information, see [AUTOTITLE](/billing/managing-your-license-for-github-enterprise/troubleshooting-license-usage-for-github-enterprise#about-the-calculation-of-consumed-licenses). diff --git a/data/reusables/enterprise-licensing/verified-domains-license-sync.md b/data/reusables/enterprise-licensing/verified-domains-license-sync.md index 57f2185c4a45..19b54f131c55 100644 --- a/data/reusables/enterprise-licensing/verified-domains-license-sync.md +++ b/data/reusables/enterprise-licensing/verified-domains-license-sync.md @@ -1 +1 @@ -> [!NOTE] To make troubleshooting easier, if you synchronize license usage and do not use {% data variables.product.prodname_emus %}, we highly recommend enabling verified domains for your enterprise account on {% data variables.product.prodname_ghe_cloud %}. See "[AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise){% ifversion not ghec %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %} +> [!NOTE] To make troubleshooting easier, if you synchronize license usage and do not use {% data variables.product.prodname_emus %}, we highly recommend enabling verified domains for your enterprise account on {% data variables.product.prodname_ghe_cloud %}. See [AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/verifying-or-approving-a-domain-for-your-enterprise){% ifversion not ghec %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %} diff --git a/data/reusables/enterprise-licensing/view-consumed-licenses.md b/data/reusables/enterprise-licensing/view-consumed-licenses.md index 8e761a485bb6..4dd4a95eac4b 100644 --- a/data/reusables/enterprise-licensing/view-consumed-licenses.md +++ b/data/reusables/enterprise-licensing/view-consumed-licenses.md @@ -1 +1 @@ -After you synchronize license usage, you can see a report of consumed licenses across all your environments in the enterprise settings on {% data variables.product.prodname_ghe_cloud %}. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/billing/managing-your-license-for-github-enterprise/viewing-license-usage-for-github-enterprise)." +After you synchronize license usage, you can see a report of consumed licenses across all your environments in the enterprise settings on {% data variables.product.prodname_ghe_cloud %}. For more information, see [AUTOTITLE](/enterprise-cloud@latest/billing/managing-your-license-for-github-enterprise/viewing-license-usage-for-github-enterprise). diff --git a/data/reusables/enterprise-managed/assigning-roles.md b/data/reusables/enterprise-managed/assigning-roles.md index c5e787bc27c2..486872a910bc 100644 --- a/data/reusables/enterprise-managed/assigning-roles.md +++ b/data/reusables/enterprise-managed/assigning-roles.md @@ -1 +1 @@ -When assigning users, you can use the "Roles" attribute in the application on your IdP to set a user's role in your enterprise on {% data variables.product.product_name %}. For more information about the roles available to assign, see "[AUTOTITLE](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise)." +When assigning users, you can use the "Roles" attribute in the application on your IdP to set a user's role in your enterprise on {% data variables.product.product_name %}. For more information about the roles available to assign, see [AUTOTITLE](/admin/user-management/managing-users-in-your-enterprise/roles-in-an-enterprise). diff --git a/data/reusables/enterprise-managed/emu-prerequisite.md b/data/reusables/enterprise-managed/emu-prerequisite.md index 2d0eac97f26c..28c5fb80b614 100644 --- a/data/reusables/enterprise-managed/emu-prerequisite.md +++ b/data/reusables/enterprise-managed/emu-prerequisite.md @@ -1 +1 @@ -When you began using {% data variables.product.product_name %}, you must have chosen to create an {% data variables.enterprise.prodname_emu_enterprise %}. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/identifying-the-best-authentication-method-for-your-enterprise)." +When you began using {% data variables.product.product_name %}, you must have chosen to create an {% data variables.enterprise.prodname_emu_enterprise %}. For more information, see [AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/identifying-the-best-authentication-method-for-your-enterprise). diff --git a/data/reusables/enterprise-managed/repo-collaborators-note.md b/data/reusables/enterprise-managed/repo-collaborators-note.md index 03d03aa18748..cdeb80a437ba 100644 --- a/data/reusables/enterprise-managed/repo-collaborators-note.md +++ b/data/reusables/enterprise-managed/repo-collaborators-note.md @@ -1,3 +1,3 @@ {% ifversion repository-collaborators %} ->[!NOTE] If your enterprise uses {% data variables.enterprise.prodname_managed_users %}, the outside collaborator role is called "repository collaborator." Generally, the documentation for outside collaborators also applies to repository collaborators. For the distinctions that apply, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#outside-collaborators-or-repository-collaborators)." +>[!NOTE] If your enterprise uses {% data variables.enterprise.prodname_managed_users %}, the outside collaborator role is called "repository collaborator." Generally, the documentation for outside collaborators also applies to repository collaborators. For the distinctions that apply, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#outside-collaborators-or-repository-collaborators). {% endif %} diff --git a/data/reusables/enterprise-migration-tool/about-the-migrator-role.md b/data/reusables/enterprise-migration-tool/about-the-migrator-role.md index 44f30254d626..eab4b9f5d54a 100644 --- a/data/reusables/enterprise-migration-tool/about-the-migrator-role.md +++ b/data/reusables/enterprise-migration-tool/about-the-migrator-role.md @@ -3,10 +3,10 @@ To remove the need for organization owners to complete migrations, {% data varia Granting the migrator role allows you to designate other teams or individuals to handle your migrations. * You can only grant the migrator role for an organization on {% data variables.product.prodname_dotcom_the_website %} or {% data variables.enterprise.data_residency_site %}. -* You can grant the migrator role to an individual user or a team. We strongly recommend that you assign the migrator role to a team. Then, you can further customize who can run a migration by adjusting team membership. See "[AUTOTITLE](/organizations/organizing-members-into-teams/adding-organization-members-to-a-team)" or "[AUTOTITLE](/organizations/organizing-members-into-teams/removing-organization-members-from-a-team)." +* You can grant the migrator role to an individual user or a team. We strongly recommend that you assign the migrator role to a team. Then, you can further customize who can run a migration by adjusting team membership. See [AUTOTITLE](/organizations/organizing-members-into-teams/adding-organization-members-to-a-team) or [AUTOTITLE](/organizations/organizing-members-into-teams/removing-organization-members-from-a-team). * The migrator must use a {% data variables.product.pat_generic %} that meets all the requirements for running migrations. > [!WARNING] > When you grant the migrator role in an organization to a user or team, you are granting them the ability to import or export any repository in that organization. -To grant the migrator role, see "[Granting the migrator role](#granting-the-migrator-role)." +To grant the migrator role, see [Granting the migrator role](#granting-the-migrator-role). diff --git a/data/reusables/enterprise-migration-tool/blob-storage-management-console.md b/data/reusables/enterprise-migration-tool/blob-storage-management-console.md index 606ed356250f..4e5e27a6dea8 100644 --- a/data/reusables/enterprise-migration-tool/blob-storage-management-console.md +++ b/data/reusables/enterprise-migration-tool/blob-storage-management-console.md @@ -9,7 +9,7 @@ After you set up an AWS S3 storage bucket or Azure Blob Storage storage account, 1. Optionally, to import storage settings you configured for {% data variables.product.prodname_actions %}, select **Copy Storage settings from Actions**. For more information see, "[Enabling GitHub Actions with Azure Blob storage]({% ifversion not ghes %}/enterprise-server@latest{% endif %}/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-azure-blob-storage)" and "[Enabling GitHub Actions with Amazon S3 storage]({% ifversion not ghes %}/enterprise-server@latest{% endif %}/admin/github-actions/enabling-github-actions-for-github-enterprise-server/enabling-github-actions-with-amazon-s3-storage)." > [!NOTE] - > After copying your storage settings, you may still need to update the configuration of your cloud storage account to work with {% data variables.product.prodname_importer_proper_name %}. In particular, you must ensure that {% data variables.product.prodname_dotcom %}'s IP addresses are allowlisted. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products#configuring-ip-allow-lists-for-migrations)." + > After copying your storage settings, you may still need to update the configuration of your cloud storage account to work with {% data variables.product.prodname_importer_proper_name %}. In particular, you must ensure that {% data variables.product.prodname_dotcom %}'s IP addresses are allowlisted. For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products#configuring-ip-allow-lists-for-migrations). 1. If you do not import storage settings from {% data variables.product.prodname_actions %}, select either **Azure Blob Storage** or **Amazon S3** and fill in the required details. diff --git a/data/reusables/enterprise-migration-tool/branch-protection-migration.md b/data/reusables/enterprise-migration-tool/branch-protection-migration.md index bd0ad5d43fec..fa4029521a63 100644 --- a/data/reusables/enterprise-migration-tool/branch-protection-migration.md +++ b/data/reusables/enterprise-migration-tool/branch-protection-migration.md @@ -1,4 +1,4 @@ -Branch protections apply a specified set of rules to a specific branch name or branch name pattern. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)." +Branch protections apply a specified set of rules to a specific branch name or branch name pattern. For more information, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches). Branch protections will always be migrated, but certain rules will not be migrated. The following branch protection rules are not migrated. diff --git a/data/reusables/enterprise-migration-tool/checking-the-migration-status.md b/data/reusables/enterprise-migration-tool/checking-the-migration-status.md index d816ccdd5422..feadc3c248a9 100644 --- a/data/reusables/enterprise-migration-tool/checking-the-migration-status.md +++ b/data/reusables/enterprise-migration-tool/checking-the-migration-status.md @@ -11,4 +11,4 @@ The way you check the status of your migration depends on how you ran the migrat * If you ran the migration using the {% data variables.product.prodname_cli %} with the optional `--queue-only` argument, the process will exit immediately after queueing the migration, and will not tell you if the migration succeeded or failed. You can check a migration's status using the `wait-for-migration` command, or by reviewing the migration log. * If you ran the migration using the GraphQL API, you can query the `state` and `failureReason` fields on the `RepositoryMigration` object. -If the migration failed, the migration log may contain additional information about the cause of the failure. For more information, see "[Reviewing the migration log](#reviewing-the-migration-log)." +If the migration failed, the migration log may contain additional information about the cause of the failure. For more information, see [Reviewing the migration log](#reviewing-the-migration-log). diff --git a/data/reusables/enterprise-migration-tool/configuring-ip-allow-lists.md b/data/reusables/enterprise-migration-tool/configuring-ip-allow-lists.md index e0f23a5b00b0..b24a43f9d847 100644 --- a/data/reusables/enterprise-migration-tool/configuring-ip-allow-lists.md +++ b/data/reusables/enterprise-migration-tool/configuring-ip-allow-lists.md @@ -1,4 +1,4 @@ -If the source or destination of your migration uses an IP allow list (either {% data variables.product.company_short %}'s IP allow list feature or your identity provider's (IdP) IP allow list restrictions, such as Azure CAP), you need to configure IP allow lists on {% data variables.product.prodname_dotcom %}. See "[AUTOTITLE](/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)" and "[AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list)." +If the source or destination of your migration uses an IP allow list (either {% data variables.product.company_short %}'s IP allow list feature or your identity provider's (IdP) IP allow list restrictions, such as Azure CAP), you need to configure IP allow lists on {% data variables.product.prodname_dotcom %}. See [AUTOTITLE](/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization) and [AUTOTITLE](/enterprise-cloud@latest/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise-with-an-ip-allow-list). * If you use {% data variables.product.company_short %}'s IP allow list feature, you must add the {% data variables.product.prodname_dotcom %} IP ranges below to the allow list for the source and/or destination organizations. * If you use your IdP's IP allow list to restrict access to your enterprise on {% data variables.product.prodname_dotcom %}, you should disable these restrictions in your enterprise account settings until after your migration is complete. diff --git a/data/reusables/enterprise-migration-tool/create-pats.md b/data/reusables/enterprise-migration-tool/create-pats.md index 57d483be0b15..ccbf114e2461 100644 --- a/data/reusables/enterprise-migration-tool/create-pats.md +++ b/data/reusables/enterprise-migration-tool/create-pats.md @@ -1,2 +1,2 @@ -1. Create and record a {% data variables.product.pat_v1 %} that will authenticate for the destination organization on {% data variables.product.prodname_ghe_cloud %}, making sure that the token meets all requirements. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products#creating-a-personal-access-token-for-github-enterprise-importer)." +1. Create and record a {% data variables.product.pat_v1 %} that will authenticate for the destination organization on {% data variables.product.prodname_ghe_cloud %}, making sure that the token meets all requirements. For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products#creating-a-personal-access-token-for-github-enterprise-importer). 1. Create and record a {% data variables.product.pat_generic %} that will authenticate for the source organization, making sure that this token also meets all of the same requirements. diff --git a/data/reusables/enterprise-migration-tool/creating-a-pat-steps.md b/data/reusables/enterprise-migration-tool/creating-a-pat-steps.md index 52bfd3af442b..838e363ce3fd 100644 --- a/data/reusables/enterprise-migration-tool/creating-a-pat-steps.md +++ b/data/reusables/enterprise-migration-tool/creating-a-pat-steps.md @@ -1,3 +1,3 @@ -1. Verify that you have a sufficient role for the task you want to complete. For more information, see "[Required roles](#required-roles)." -1. Create a {% data variables.product.pat_v1 %}, making sure to grant all the scopes required for the task you want to complete. {% data reusables.user-settings.generic-classic-pat-only %} For more information, "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)" and "[Required scopes for {% data variables.product.pat_generic %}](#required-scopes-for-personal-access-tokens)." -1. If SAML single sign-on is enforced for the organization(s) you need to access, authorize the {% data variables.product.pat_generic %} for SSO. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on)." +1. Verify that you have a sufficient role for the task you want to complete. For more information, see [Required roles](#required-roles). +1. Create a {% data variables.product.pat_v1 %}, making sure to grant all the scopes required for the task you want to complete. {% data reusables.user-settings.generic-classic-pat-only %} For more information, [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token) and [Required scopes for {% data variables.product.pat_generic %}](#required-scopes-for-personal-access-tokens). +1. If SAML single sign-on is enforced for the organization(s) you need to access, authorize the {% data variables.product.pat_generic %} for SSO. For more information, see [AUTOTITLE](/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on). diff --git a/data/reusables/enterprise-migration-tool/data-not-migrated.md b/data/reusables/enterprise-migration-tool/data-not-migrated.md index 9a13349c963f..a58b4be6dbac 100644 --- a/data/reusables/enterprise-migration-tool/data-not-migrated.md +++ b/data/reusables/enterprise-migration-tool/data-not-migrated.md @@ -5,14 +5,14 @@ * {% data variables.product.prodname_dependabot %} secrets * Discussions at the repository level * Edit history of issue comments and pull request comments -* Fork relationships between repositories (see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)") +* Fork relationships between repositories (see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)) * {% data variables.product.prodname_actions %} secrets, variables, environments, self-hosted runners, {% data variables.actions.hosted_runner %}s, or workflow run history * GitHub Apps and GitHub App installations -* {% data variables.large_files.product_name_short %} objects and large binaries (repositories using {% data variables.large_files.product_name_short %} are still supported, see "[Limitations of {% data variables.product.prodname_importer_proper_name %}](#limitations-of-github-enterprise-importer)") +* {% data variables.large_files.product_name_short %} objects and large binaries (repositories using {% data variables.large_files.product_name_short %} are still supported, see [Limitations of {% data variables.product.prodname_importer_proper_name %}](#limitations-of-github-enterprise-importer)) * Packages in {% data variables.product.prodname_registry %} * Projects (classic) at the organization level * {% data variables.product.prodname_projects_v2 %} (the new projects experience) -* References between pull requests and issues in different repositories (see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls)") +* References between pull requests and issues in different repositories (see [AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls)) * Remediation states of {% data variables.product.prodname_secret_scanning %} results * Repositories owned by user accounts{% ifversion repository-properties %} * Repository properties{% endif %} diff --git a/data/reusables/enterprise-migration-tool/deploy-key-bypass.md b/data/reusables/enterprise-migration-tool/deploy-key-bypass.md index 28ada4675f88..6d7e8d5b20f8 100644 --- a/data/reusables/enterprise-migration-tool/deploy-key-bypass.md +++ b/data/reusables/enterprise-migration-tool/deploy-key-bypass.md @@ -1,3 +1,3 @@ > [!NOTE] If the repository you are migrating has rulesets that the incoming repository doesn't match, the migration will be blocked. To bypass these rulesets and allow the migration, you can apply a ruleset bypass for all deploy keys in the target organization. > -> Repository rulesets can be set at the organization level. If the incoming repository does not match any of these rulesets, you will need to use the deploy key bypass for each one. See "[AUTOTITLE](/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization#granting-bypass-permissions-for-your-branch-or-tag-ruleset)." +> Repository rulesets can be set at the organization level. If the incoming repository does not match any of these rulesets, you will need to use the deploy key bypass for each one. See [AUTOTITLE](/organizations/managing-organization-settings/creating-rulesets-for-repositories-in-your-organization#granting-bypass-permissions-for-your-branch-or-tag-ruleset). diff --git a/data/reusables/enterprise-migration-tool/download-migration-logs-flag.md b/data/reusables/enterprise-migration-tool/download-migration-logs-flag.md index 587adbfd3b0c..b1aea01b623e 100644 --- a/data/reusables/enterprise-migration-tool/download-migration-logs-flag.md +++ b/data/reusables/enterprise-migration-tool/download-migration-logs-flag.md @@ -1 +1 @@ -If you want the script to download the migration log for each migrated repository, add the `--download-migration-logs` flag. For more information about migration logs, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer#downloading-all-migration-logs-for-an-organization)." +If you want the script to download the migration log for each migrated repository, add the `--download-migration-logs` flag. For more information about migration logs, see [AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer#downloading-all-migration-logs-for-an-organization). diff --git a/data/reusables/enterprise-migration-tool/extra-requirements-storage.md b/data/reusables/enterprise-migration-tool/extra-requirements-storage.md index 728fd5e7550f..1505d3276f48 100644 --- a/data/reusables/enterprise-migration-tool/extra-requirements-storage.md +++ b/data/reusables/enterprise-migration-tool/extra-requirements-storage.md @@ -1,2 +1,2 @@ -* You must allow access to the egress IP ranges for {% data variables.enterprise.data_residency_site %}. See "[AUTOTITLE](/enterprise-cloud@latest/admin/data-residency/network-details-for-ghecom#ranges-for-egress-traffic)." +* You must allow access to the egress IP ranges for {% data variables.enterprise.data_residency_site %}. See [AUTOTITLE](/enterprise-cloud@latest/admin/data-residency/network-details-for-ghecom#ranges-for-egress-traffic). * If you're using Azure Blob Storage, you may need to perform some additional configuration. Please contact {% data variables.contact.contact_support_page %}. diff --git a/data/reusables/enterprise-migration-tool/github-pat-required-scopes.md b/data/reusables/enterprise-migration-tool/github-pat-required-scopes.md index 1a1e3775ae44..d886ebe1a3d1 100644 --- a/data/reusables/enterprise-migration-tool/github-pat-required-scopes.md +++ b/data/reusables/enterprise-migration-tool/github-pat-required-scopes.md @@ -1,7 +1,7 @@ The scopes that are required for your {% data variables.product.prodname_dotcom %} {% data variables.product.pat_v1 %} depend on your role and the task you want to complete. > [!NOTE] -> {% data reusables.user-settings.generic-classic-pat-only %} This means that you cannot use {% data variables.product.prodname_importer_proper_name %} if your organization uses the "Restrict {% data variables.product.pat_v1_plural %} from accessing your organizations" policy. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-personal-access-tokens-in-your-enterprise#restricting-access-by-personal-access-tokens)." +> {% data reusables.user-settings.generic-classic-pat-only %} This means that you cannot use {% data variables.product.prodname_importer_proper_name %} if your organization uses the "Restrict {% data variables.product.pat_v1_plural %} from accessing your organizations" policy. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-personal-access-tokens-in-your-enterprise#restricting-access-by-personal-access-tokens). Task | Organization owner | Migrator ---- | -------- | ----- | diff --git a/data/reusables/enterprise-migration-tool/github-trial-prerequisite.md b/data/reusables/enterprise-migration-tool/github-trial-prerequisite.md index bbfb5f056e71..a3ba03b72964 100644 --- a/data/reusables/enterprise-migration-tool/github-trial-prerequisite.md +++ b/data/reusables/enterprise-migration-tool/github-trial-prerequisite.md @@ -1 +1 @@ -We strongly recommend that you perform a trial run of your migration and complete your production migration soon after. To learn more about trial runs, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#running-your-migrations)." +We strongly recommend that you perform a trial run of your migration and complete your production migration soon after. To learn more about trial runs, see [AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#running-your-migrations). diff --git a/data/reusables/enterprise-migration-tool/grant-migrator-role-graphql.md b/data/reusables/enterprise-migration-tool/grant-migrator-role-graphql.md index a826086e4881..2886fde305a5 100644 --- a/data/reusables/enterprise-migration-tool/grant-migrator-role-graphql.md +++ b/data/reusables/enterprise-migration-tool/grant-migrator-role-graphql.md @@ -1,6 +1,6 @@ You can use the `grantMigratorRole` GraphQL mutation to assign the migrator role and the `revokeMigratorRole` mutation to revoke the migrator role. -You must use a {% data variables.product.pat_generic %} (PAT) that meets all access requirements. For more information, see the "[Required scopes for {% data variables.product.pat_generic %}s](#required-scopes-for-personal-access-tokens)." +You must use a {% data variables.product.pat_generic %} (PAT) that meets all access requirements. For more information, see the [Required scopes for {% data variables.product.pat_generic %}s](#required-scopes-for-personal-access-tokens). #### `grantMigratorRole` mutation diff --git a/data/reusables/enterprise-migration-tool/identifying-githubs-ip-ranges.md b/data/reusables/enterprise-migration-tool/identifying-githubs-ip-ranges.md index 85329843d101..a541971bc0be 100644 --- a/data/reusables/enterprise-migration-tool/identifying-githubs-ip-ranges.md +++ b/data/reusables/enterprise-migration-tool/identifying-githubs-ip-ranges.md @@ -13,4 +13,4 @@ You can get an up-to-date list of IP ranges used by {% data variables.product.pr The `github_enterprise_importer` key in the response contains a list of IP ranges used for migrations. -For more information, see "[AUTOTITLE](/rest/meta#get-github-meta-information)." +For more information, see [AUTOTITLE](/rest/meta#get-github-meta-information). diff --git a/data/reusables/enterprise-migration-tool/install-gei-extension-intro.md b/data/reusables/enterprise-migration-tool/install-gei-extension-intro.md index 73e6d976dd63..a9acf697328c 100644 --- a/data/reusables/enterprise-migration-tool/install-gei-extension-intro.md +++ b/data/reusables/enterprise-migration-tool/install-gei-extension-intro.md @@ -1 +1 @@ -If this is your first migration, you'll need to install the {% data variables.product.prodname_gei_cli %}. For more information about the {% data variables.product.prodname_cli %}, see "[AUTOTITLE](/github-cli/github-cli/about-github-cli)." +If this is your first migration, you'll need to install the {% data variables.product.prodname_gei_cli %}. For more information about the {% data variables.product.prodname_cli %}, see [AUTOTITLE](/github-cli/github-cli/about-github-cli). diff --git a/data/reusables/enterprise-migration-tool/limitations-of-migrated-data.md b/data/reusables/enterprise-migration-tool/limitations-of-migrated-data.md index 14c85b86cecd..c0a31bc05471 100644 --- a/data/reusables/enterprise-migration-tool/limitations-of-migrated-data.md +++ b/data/reusables/enterprise-migration-tool/limitations-of-migrated-data.md @@ -4,14 +4,14 @@ There are limits to what {% data variables.product.prodname_importer_proper_name * **2 GB size limit for a single Git commit:** No single commit in your Git repository can be larger than 2 GB. If any of your commits are larger than 2 GB, you will need to split the commit into smaller commits that are each 2 GB or smaller. * **255 byte limit for Git references:** No single [Git reference](https://git-scm.com/book/en/v2/Git-Internals-Git-References), commonly known as a "ref", can have a name larger than 255 bytes. Usually, this means that your references cannot be more than 255 characters long, but any non-[ASCII](https://en.wikipedia.org/wiki/ASCII) characters, such as emojis, may consume more than one byte. If any of your Git references are too large, we'll return a clear error message. -* **100 MB file size limit:** No single file in your Git repository can be larger than 100 MB. Consider using {% data variables.large_files.product_name_short %} for storing large files. For more information, see "[AUTOTITLE](/repositories/working-with-files/managing-large-files)." +* **100 MB file size limit:** No single file in your Git repository can be larger than 100 MB. Consider using {% data variables.large_files.product_name_short %} for storing large files. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files). ### Limitations of {% data variables.product.prodname_importer_proper_name %} * **10 GB size limit for a Git repository:** This limit only applies to the source code. To check if the repository archive is over the limit, use the [git-sizer](https://github.com/github/git-sizer) tool and review the total blob size in the output. The git-sizer tool also helps to identify potential issues related to large files, blob size, commit size, and tree counts that could impact migrations. * **10 GB limit for metadata:** The {% data variables.product.prodname_importer_secondary_name %} cannot migrate repositories with more than 10 GB of metadata. Metadata includes issues, pull requests, releases, and attachments. In most cases, large metadata is caused by binary assets attached to releases. You can exclude releases from the migration with the `migrate-repo` command's `--skip-releases` flag, and then move your releases manually after the migration. -* **{% data variables.large_files.product_name_short %} objects not migrated:** The {% data variables.product.prodname_importer_secondary_name %} can migrate repositories that use {% data variables.large_files.product_name_short %}, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/duplicating-a-repository#mirroring-a-repository-that-contains-git-large-file-storage-objects)." -* **Follow-up tasks required:** When migrating between {% data variables.product.prodname_dotcom %} products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#completing-follow-up-tasks)." +* **{% data variables.large_files.product_name_short %} objects not migrated:** The {% data variables.product.prodname_importer_secondary_name %} can migrate repositories that use {% data variables.large_files.product_name_short %}, but the LFS objects themselves will not be migrated. They can be pushed to your migration destination as a follow-up task after the migration is complete. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/duplicating-a-repository#mirroring-a-repository-that-contains-git-large-file-storage-objects). +* **Follow-up tasks required:** When migrating between {% data variables.product.prodname_dotcom %} products, certain settings are not migrated and must be reconfigured in the new repository. For a list of follow-up tasks you'll need to complete after each migration, see [AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-between-github-products/overview-of-a-migration-between-github-products#completing-follow-up-tasks). * **Delayed code search functionality:** Re-indexing the search index can take a few hours after a repository is migrated, and code searches may return unexpected results until re-indexing is complete. -* **Rulesets configured for your organization can cause migrations to fail:** For example, if you configured a rule that requires email addresses for commit authors to end with `@monalisa.cat`, and the repository you're migrating contains commits that don't comply with this rule, your migration will fail. For more information about rulesets, see "[AUTOTITLE](/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets)." -* **Mannequin content might not be searchable:** Mannequins are placeholder users to which imported content (such as issues, pull requests, comments, etc.) is associated. When you search for content associated with a mannequin, such as assigned issues, the issues may not be found. Once a mannequin is reclaimed, the content should be found via the new owner. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/reclaiming-mannequins-for-github-enterprise-importer)." +* **Rulesets configured for your organization can cause migrations to fail:** For example, if you configured a rule that requires email addresses for commit authors to end with `@monalisa.cat`, and the repository you're migrating contains commits that don't comply with this rule, your migration will fail. For more information about rulesets, see [AUTOTITLE](/enterprise-cloud@latest/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets). +* **Mannequin content might not be searchable:** Mannequins are placeholder users to which imported content (such as issues, pull requests, comments, etc.) is associated. When you search for content associated with a mannequin, such as assigned issues, the issues may not be found. Once a mannequin is reclaimed, the content should be found via the new owner. For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/reclaiming-mannequins-for-github-enterprise-importer). diff --git a/data/reusables/enterprise-migration-tool/migration-query-method.md b/data/reusables/enterprise-migration-tool/migration-query-method.md index 84d64ed71266..f1fbf7c5570b 100644 --- a/data/reusables/enterprise-migration-tool/migration-query-method.md +++ b/data/reusables/enterprise-migration-tool/migration-query-method.md @@ -1,5 +1,5 @@ To make GraphQL queries, you'll need to write your own scripts or use an HTTP client like [Insomnia](https://insomnia.rest/). -To learn more about getting started with the {% data variables.product.prodname_dotcom %} GraphQL API, including how to authenticate, see "[AUTOTITLE](/graphql/guides/forming-calls-with-graphql)." +To learn more about getting started with the {% data variables.product.prodname_dotcom %} GraphQL API, including how to authenticate, see [AUTOTITLE](/graphql/guides/forming-calls-with-graphql). You will send all GraphQL queries to the **destination** of your migration. If you're migrating to {% data variables.enterprise.data_residency %}, make sure to send queries to the endpoint for your enterprise's subdomain of {% data variables.enterprise.data_residency_site %}. diff --git a/data/reusables/enterprise-migration-tool/path-to-key-placeholder.md b/data/reusables/enterprise-migration-tool/path-to-key-placeholder.md index 23b893557ac5..8a0510750e72 100644 --- a/data/reusables/enterprise-migration-tool/path-to-key-placeholder.md +++ b/data/reusables/enterprise-migration-tool/path-to-key-placeholder.md @@ -1 +1 @@ -PATH-TO-KEY | If your Bitbucket Server instance runs on Linux, the path to your SSH private key, such as `~/.ssh/id_rsa`. For SSH key requirements, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server#required-permissions-for-bitbucket-server)". +PATH-TO-KEY | If your Bitbucket Server instance runs on Linux, the path to your SSH private key, such as `~/.ssh/id_rsa`. For SSH key requirements, see [AUTOTITLE](/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server#required-permissions-for-bitbucket-server). diff --git a/data/reusables/enterprise-migration-tool/reclaiming-mannequins.md b/data/reusables/enterprise-migration-tool/reclaiming-mannequins.md index d2b25c79f7b4..33cbb84151ef 100644 --- a/data/reusables/enterprise-migration-tool/reclaiming-mannequins.md +++ b/data/reusables/enterprise-migration-tool/reclaiming-mannequins.md @@ -1,6 +1,6 @@ {% data reusables.enterprise-migration-tool.about-mannequins %} -{% data reusables.enterprise-migration-tool.how-to-reclaim %} For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/reclaiming-mannequins-for-github-enterprise-importer)." +{% data reusables.enterprise-migration-tool.how-to-reclaim %} For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/reclaiming-mannequins-for-github-enterprise-importer). > [!NOTE] > Only organization owners can reclaim mannequins. If you've been granted the migrator role, contact an organization owner to perform this step. @@ -8,4 +8,4 @@ 1. Decide if you want to reclaim mannequins. 1. Plan when you'll complete reclaims. 1. Reclaim mannequins. -1. If any of the members do not already have appropriate access to the repository via team membership, give the members access to the repository. For more information, see "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-an-individuals-access-to-an-organization-repository)." +1. If any of the members do not already have appropriate access to the repository via team membership, give the members access to the repository. For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-an-individuals-access-to-an-organization-repository). diff --git a/data/reusables/enterprise-migration-tool/reviewing-the-migration-log.md b/data/reusables/enterprise-migration-tool/reviewing-the-migration-log.md index d72fe40c99a1..1939adae22e4 100644 --- a/data/reusables/enterprise-migration-tool/reviewing-the-migration-log.md +++ b/data/reusables/enterprise-migration-tool/reviewing-the-migration-log.md @@ -1,7 +1,7 @@ -Review the migration log for each migrated repository. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer)." +Review the migration log for each migrated repository. For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer). If the migration failed, the log may contain additional information about the cause of the failure. If the migration succeeded, there may be warnings in the migration log representing specific pieces of data (for example pull requests, issues, or comments) which were not migrated or were migrated with caveats. -For more information on understanding migration warnings, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/troubleshooting-your-migration-with-github-enterprise-importer#understanding-migration-log-warnings)." After reviewing any migration warnings, you will need to make a decision about whether you can accept those warnings and move forward. +For more information on understanding migration warnings, see [AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/troubleshooting-your-migration-with-github-enterprise-importer#understanding-migration-log-warnings). After reviewing any migration warnings, you will need to make a decision about whether you can accept those warnings and move forward. diff --git a/data/reusables/enterprise-migration-tool/setting-repository-visibility.md b/data/reusables/enterprise-migration-tool/setting-repository-visibility.md index 7ed3f46c15c5..cf1493b2c1c9 100644 --- a/data/reusables/enterprise-migration-tool/setting-repository-visibility.md +++ b/data/reusables/enterprise-migration-tool/setting-repository-visibility.md @@ -1,5 +1,5 @@ All repositories are migrated as private by default, and only the user that ran the migration and organization owners will have access to the repository. If you don't want the repository to be private, change the visibility. * You can set a repository's visibility with the `--target-repo-visibility` CLI option or the `targetRepoVisibility` GraphQL property. -* You can change a repository's visibility in the browser. For more information, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility)." +* You can change a repository's visibility in the browser. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility). * Alternatively, you can use {% data variables.product.prodname_cli %} to change repository visibility from the command line. You can even add this command to the script that was generated to run your migrations. For more information, see [`gh repo edit`](https://cli.github.com/manual/gh_repo_edit) in the {% data variables.product.prodname_cli %} documentation. diff --git a/data/reusables/enterprise-migration-tool/validate-migration-logs.md b/data/reusables/enterprise-migration-tool/validate-migration-logs.md index cd4451470e65..b4b2a9351289 100644 --- a/data/reusables/enterprise-migration-tool/validate-migration-logs.md +++ b/data/reusables/enterprise-migration-tool/validate-migration-logs.md @@ -1,3 +1,3 @@ -When your migration is complete, we recommend reviewing your migration log. For more information, see "[AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer)." +When your migration is complete, we recommend reviewing your migration log. For more information, see [AUTOTITLE](/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer). We recommend that you review your migrated repositories for a soundness check. diff --git a/data/reusables/enterprise/about-deployment-methods.md b/data/reusables/enterprise/about-deployment-methods.md index a239d704c5ce..faba9b9a506e 100644 --- a/data/reusables/enterprise/about-deployment-methods.md +++ b/data/reusables/enterprise/about-deployment-methods.md @@ -1 +1 @@ -{% data variables.product.prodname_enterprise %} offers two deployment options. {% ifversion fpt or ghec %}In addition to {% data variables.product.prodname_ghe_cloud %}, you can use {% data variables.product.prodname_ghe_server %} to host development work for your enterprise in your data center or a supported cloud.{% elsif ghes %}In addition to {% data variables.product.product_name %}, you can use {% data variables.product.prodname_ghe_cloud %} to host development work for your enterprise on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans#github-enterprise)." +{% data variables.product.prodname_enterprise %} offers two deployment options. {% ifversion fpt or ghec %}In addition to {% data variables.product.prodname_ghe_cloud %}, you can use {% data variables.product.prodname_ghe_server %} to host development work for your enterprise in your data center or a supported cloud.{% elsif ghes %}In addition to {% data variables.product.product_name %}, you can use {% data variables.product.prodname_ghe_cloud %} to host development work for your enterprise on {% data variables.product.prodname_dotcom_the_website %}.{% endif %} For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans#github-enterprise). diff --git a/data/reusables/enterprise/about-ssh-ports.md b/data/reusables/enterprise/about-ssh-ports.md index e8993b7d9a5d..4ff39a4641d8 100644 --- a/data/reusables/enterprise/about-ssh-ports.md +++ b/data/reusables/enterprise/about-ssh-ports.md @@ -1,5 +1,5 @@ Each {% data variables.product.product_name %} instance accepts SSH connections over two ports. Site administrators can access the administrative shell via SSH, then run command-line utilities, troubleshoot, and perform maintenance. Users can connect via SSH to access and write Git data in the instance's repositories. Users do not have shell access to your instance. For more information, see the following articles. -* "[AUTOTITLE](/admin/configuration/configuring-network-settings/network-ports)" -* "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)" -* "[AUTOTITLE](/authentication/connecting-to-github-with-ssh/about-ssh)" +* [AUTOTITLE](/admin/configuration/configuring-network-settings/network-ports) +* [AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh) +* [AUTOTITLE](/authentication/connecting-to-github-with-ssh/about-ssh) diff --git a/data/reusables/enterprise/about-upgrades.md b/data/reusables/enterprise/about-upgrades.md index e90241c08622..9fe19dc32eb8 100644 --- a/data/reusables/enterprise/about-upgrades.md +++ b/data/reusables/enterprise/about-upgrades.md @@ -1,3 +1,3 @@ -{% data reusables.enterprise.constantly-improving %} You are responsible for upgrades to your instance. For more information, see "[AUTOTITLE](/admin/overview/about-upgrades-to-new-releases)." +{% data reusables.enterprise.constantly-improving %} You are responsible for upgrades to your instance. For more information, see [AUTOTITLE](/admin/overview/about-upgrades-to-new-releases). To upgrade an instance, you must plan and communicate the upgrade, choose the appropriate package, back up your data, and then perform the upgrade. diff --git a/data/reusables/enterprise/best-practices.md b/data/reusables/enterprise/best-practices.md index ca49baaa6efc..5f1920ada960 100644 --- a/data/reusables/enterprise/best-practices.md +++ b/data/reusables/enterprise/best-practices.md @@ -1 +1 @@ -To learn how your enterprise can use {% data variables.product.product_name %} most effectively, see "[AUTOTITLE](/admin/overview/best-practices-for-enterprises)." +To learn how your enterprise can use {% data variables.product.product_name %} most effectively, see [AUTOTITLE](/admin/overview/best-practices-for-enterprises). diff --git a/data/reusables/enterprise/editor-role-note.md b/data/reusables/enterprise/editor-role-note.md index fd0638b9d32f..51bcc41fd2d2 100644 --- a/data/reusables/enterprise/editor-role-note.md +++ b/data/reusables/enterprise/editor-role-note.md @@ -4,6 +4,6 @@ {%- ifversion ghes = 3.11 %} 3.11.8{%- endif %} {%- ifversion ghes = 3.10 %} 3.10.10{%- endif %} . For more information, see -{%- ifversion ghes = 3.12 %} "[AUTOTITLE](/enterprise-server@3.12/admin/release-notes#3.12.2-security-fixes)."{%- endif %} -{%- ifversion ghes = 3.11 %} "[AUTOTITLE](/enterprise-server@3.11/admin/release-notes#3.11.8-security-fixes)."{%- endif %} -{%- ifversion ghes = 3.10 %} "[AUTOTITLE](/enterprise-server@3.10/admin/release-notes#3.10.10-security-fixes)."{%- endif %} +{%- ifversion ghes = 3.12 %} [AUTOTITLE](/enterprise-server@3.12/admin/release-notes#3.12.2-security-fixes).{%- endif %} +{%- ifversion ghes = 3.11 %} [AUTOTITLE](/enterprise-server@3.11/admin/release-notes#3.11.8-security-fixes).{%- endif %} +{%- ifversion ghes = 3.10 %} [AUTOTITLE](/enterprise-server@3.10/admin/release-notes#3.10.10-security-fixes).{%- endif %} diff --git a/data/reusables/enterprise/link-to-ghec-trial.md b/data/reusables/enterprise/link-to-ghec-trial.md index 77c1531df76e..1508b1d548de 100644 --- a/data/reusables/enterprise/link-to-ghec-trial.md +++ b/data/reusables/enterprise/link-to-ghec-trial.md @@ -1 +1 @@ -For more information about how you can try {% data variables.product.prodname_ghe_cloud %} for free, see "[Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/admin/overview/setting-up-a-trial-of-github-enterprise-cloud)." +For more information about how you can try {% data variables.product.prodname_ghe_cloud %} for free, see [Setting up a trial of {% data variables.product.prodname_ghe_cloud %}](/admin/overview/setting-up-a-trial-of-github-enterprise-cloud). diff --git a/data/reusables/enterprise/repo-policy-rules-alternative.md b/data/reusables/enterprise/repo-policy-rules-alternative.md index 2b91002f264a..09321b2ee78a 100644 --- a/data/reusables/enterprise/repo-policy-rules-alternative.md +++ b/data/reusables/enterprise/repo-policy-rules-alternative.md @@ -1,3 +1,3 @@ {% ifversion repo-policy-rules %} -We recommend creating a **repository policy** to govern the lifecycle of repositories in your enterprise, such as who can create or delete repositories. Repository policies give you flexibility over which users are affected and which organizations and repositories are targeted. See "[AUTOTITLE](/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise)." +We recommend creating a **repository policy** to govern the lifecycle of repositories in your enterprise, such as who can create or delete repositories. Repository policies give you flexibility over which users are affected and which organizations and repositories are targeted. See [AUTOTITLE](/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise). {% endif %} diff --git a/data/reusables/enterprise/repo-policy-rules-more-flexible.md b/data/reusables/enterprise/repo-policy-rules-more-flexible.md index b9bead1884ce..e336b73675a5 100644 --- a/data/reusables/enterprise/repo-policy-rules-more-flexible.md +++ b/data/reusables/enterprise/repo-policy-rules-more-flexible.md @@ -1 +1 @@ -You can create a repository policy to govern who can create repositories in your organization, how new repositories must be named, and which visibilities are available. Compared to "member privilege" policies, repository policies give you more flexibility over which users are affected and which repositories are targeted. See "[AUTOTITLE](/organizations/managing-organization-settings/governing-how-people-use-repositories-in-your-organization)." +You can create a repository policy to govern who can create repositories in your organization, how new repositories must be named, and which visibilities are available. Compared to "member privilege" policies, repository policies give you more flexibility over which users are affected and which repositories are targeted. See [AUTOTITLE](/organizations/managing-organization-settings/governing-how-people-use-repositories-in-your-organization). diff --git a/data/reusables/enterprise/repo-policy-rules-with-custom-properties.md b/data/reusables/enterprise/repo-policy-rules-with-custom-properties.md index 56354d8bd5d7..49f4efcf9b33 100644 --- a/data/reusables/enterprise/repo-policy-rules-with-custom-properties.md +++ b/data/reusables/enterprise/repo-policy-rules-with-custom-properties.md @@ -2,4 +2,4 @@ We recommend using repository policies alongside **custom repository properties* For example, you can add a property to mark repositories that contain production data or other sensitive information, then prevent anyone from making those repositories public. -To create and set custom properties, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization)." +To create and set custom properties, see [AUTOTITLE](/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization). diff --git a/data/reusables/enterprise/role-permission-hierarchy.md b/data/reusables/enterprise/role-permission-hierarchy.md index 7d03d2a82fe5..004671b4fbda 100644 --- a/data/reusables/enterprise/role-permission-hierarchy.md +++ b/data/reusables/enterprise/role-permission-hierarchy.md @@ -1,2 +1,2 @@ > [!NOTE] -> This policy only impacts repository administrators, specifically. Organization owners and security managers can always enable security features, regardless of how you set this policy. For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." +> This policy only impacts repository administrators, specifically. Organization owners and security managers can always enable security features, regardless of how you set this policy. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization). diff --git a/data/reusables/enterprise/single-organizations-enterprise-migration.md b/data/reusables/enterprise/single-organizations-enterprise-migration.md index d74e8832e861..eaaa6e0d2291 100644 --- a/data/reusables/enterprise/single-organizations-enterprise-migration.md +++ b/data/reusables/enterprise/single-organizations-enterprise-migration.md @@ -1 +1 @@ -> [!NOTE] Currently, {% data variables.product.prodname_ghe_cloud %} customers who use a single organization are being automatically upgraded to an enterprise account at no additional cost. For details, see "[AUTOTITLE](/admin/managing-your-enterprise-account/creating-an-enterprise-account#what-will-happen-after-i-upgrade-my-organization)." +> [!NOTE] Currently, {% data variables.product.prodname_ghe_cloud %} customers who use a single organization are being automatically upgraded to an enterprise account at no additional cost. For details, see [AUTOTITLE](/admin/managing-your-enterprise-account/creating-an-enterprise-account#what-will-happen-after-i-upgrade-my-organization). diff --git a/data/reusables/enterprise/test-in-staging.md b/data/reusables/enterprise/test-in-staging.md index f111ad4f6b4b..0b9f2e768951 100644 --- a/data/reusables/enterprise/test-in-staging.md +++ b/data/reusables/enterprise/test-in-staging.md @@ -1 +1 @@ -{% data variables.product.company_short %} strongly recommends that you verify any new configuration for authentication in a staging environment. An incorrect configuration could result in downtime for {% data variables.location.product_location %}. For more information, see "[AUTOTITLE](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance)." +{% data variables.product.company_short %} strongly recommends that you verify any new configuration for authentication in a staging environment. An incorrect configuration could result in downtime for {% data variables.location.product_location %}. For more information, see [AUTOTITLE](/admin/installation/setting-up-a-github-enterprise-server-instance/setting-up-a-staging-instance). diff --git a/data/reusables/enterprise/user-messages-markdown.md b/data/reusables/enterprise/user-messages-markdown.md index 112ed51a76fe..daab06d8c57d 100644 --- a/data/reusables/enterprise/user-messages-markdown.md +++ b/data/reusables/enterprise/user-messages-markdown.md @@ -1 +1 @@ -You can use Markdown to format your message. For more information, see "[AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github)." +You can use Markdown to format your message. For more information, see [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github). diff --git a/data/reusables/enterprise_clustering/cluster-ip-note.md b/data/reusables/enterprise_clustering/cluster-ip-note.md index bd88734d5371..606832d63ec2 100644 --- a/data/reusables/enterprise_clustering/cluster-ip-note.md +++ b/data/reusables/enterprise_clustering/cluster-ip-note.md @@ -4,9 +4,9 @@ {%- ifversion ghes = 3.11 %} 3.11.8{%- endif %} {%- ifversion ghes = 3.10 %} 3.10.10{%- endif %} . For more information, see -{%- ifversion ghes = 3.12 %} "[AUTOTITLE](/enterprise-server@3.12/admin/release-notes#3.12.2-security-fixes)."{%- endif %} -{%- ifversion ghes = 3.11 %} "[AUTOTITLE](/enterprise-server@3.11/admin/release-notes#3.11.8-security-fixes)."{%- endif %} -{%- ifversion ghes = 3.10 %} "[AUTOTITLE](/enterprise-server@3.10/admin/release-notes#3.10.10-security-fixes)."{%- endif %} +{%- ifversion ghes = 3.12 %} [AUTOTITLE](/enterprise-server@3.12/admin/release-notes#3.12.2-security-fixes).{%- endif %} +{%- ifversion ghes = 3.11 %} [AUTOTITLE](/enterprise-server@3.11/admin/release-notes#3.11.8-security-fixes).{%- endif %} +{%- ifversion ghes = 3.10 %} [AUTOTITLE](/enterprise-server@3.10/admin/release-notes#3.10.10-security-fixes).{%- endif %} > > {% data reusables.enterprise_clustering.failover-blocks-ips %} diff --git a/data/reusables/enterprise_clustering/health_checks.md b/data/reusables/enterprise_clustering/health_checks.md index 5920495f12fb..0527db54c4d6 100644 --- a/data/reusables/enterprise_clustering/health_checks.md +++ b/data/reusables/enterprise_clustering/health_checks.md @@ -2,4 +2,4 @@ Configure the load balancer to check the following URL. `http(s)://HOSTNAME/status` -The endpoint will return status code `200` (OK) if the node is healthy and available to service end-user requests. For more information, see "[AUTOTITLE](/admin/enterprise-management/configuring-high-availability/monitoring-a-high-availability-configuration#monitoring-replication-from-a-remote-system)." +The endpoint will return status code `200` (OK) if the node is healthy and available to service end-user requests. For more information, see [AUTOTITLE](/admin/enterprise-management/configuring-high-availability/monitoring-a-high-availability-configuration#monitoring-replication-from-a-remote-system). diff --git a/data/reusables/enterprise_clustering/load_balancer_dns.md b/data/reusables/enterprise_clustering/load_balancer_dns.md index 34595deac75b..9d4d0eb211cc 100644 --- a/data/reusables/enterprise_clustering/load_balancer_dns.md +++ b/data/reusables/enterprise_clustering/load_balancer_dns.md @@ -1 +1 @@ -DNS lookups for the {% data variables.product.prodname_ghe_server %} hostname should resolve to the load balancer. We recommend that you enable subdomain isolation. If subdomain isolation is enabled, an additional wildcard record (`*.HOSTNAME`) should also resolve to the load balancer. For more information, see "[AUTOTITLE](/admin/configuration/configuring-network-settings/enabling-subdomain-isolation)." +DNS lookups for the {% data variables.product.prodname_ghe_server %} hostname should resolve to the load balancer. We recommend that you enable subdomain isolation. If subdomain isolation is enabled, an additional wildcard record (`*.HOSTNAME`) should also resolve to the load balancer. For more information, see [AUTOTITLE](/admin/configuration/configuring-network-settings/enabling-subdomain-isolation). diff --git a/data/reusables/enterprise_clustering/replacing-a-cluster-node-modify-cluster-conf.md b/data/reusables/enterprise_clustering/replacing-a-cluster-node-modify-cluster-conf.md index 806974a25297..372c3d34c383 100644 --- a/data/reusables/enterprise_clustering/replacing-a-cluster-node-modify-cluster-conf.md +++ b/data/reusables/enterprise_clustering/replacing-a-cluster-node-modify-cluster-conf.md @@ -16,4 +16,4 @@ storage-server = true - You can choose to defer database seeding of a new MySQL replica node, resulting in being able to open your appliance to traffic sooner. For more information, see "[AUTOTITLE](/admin/monitoring-and-managing-your-instance/configuring-clustering/deferring-database-seeding)." + You can choose to defer database seeding of a new MySQL replica node, resulting in being able to open your appliance to traffic sooner. For more information, see [AUTOTITLE](/admin/monitoring-and-managing-your-instance/configuring-clustering/deferring-database-seeding). diff --git a/data/reusables/enterprise_clustering/replacing-a-cluster-node-need-three-nodes.md b/data/reusables/enterprise_clustering/replacing-a-cluster-node-need-three-nodes.md index 46dec358b4c3..010905ff71be 100644 --- a/data/reusables/enterprise_clustering/replacing-a-cluster-node-need-three-nodes.md +++ b/data/reusables/enterprise_clustering/replacing-a-cluster-node-need-three-nodes.md @@ -1 +1 @@ -1. If you're taking a node offline that provides data services, such as `git-server`, `pages-server`, or `storage-server`, evacuate the node. For more information, see "[AUTOTITLE](/admin/enterprise-management/configuring-clustering/evacuating-a-cluster-node-running-data-services)." +1. If you're taking a node offline that provides data services, such as `git-server`, `pages-server`, or `storage-server`, evacuate the node. For more information, see [AUTOTITLE](/admin/enterprise-management/configuring-clustering/evacuating-a-cluster-node-running-data-services). diff --git a/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md b/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md index 627e9b667236..36a234f481cb 100644 --- a/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md +++ b/data/reusables/enterprise_clustering/replacing-a-cluster-node-replacement-name.md @@ -1,7 +1,7 @@ 1. If you're replacing the primary Redis node, in `cluster.conf`, modify the `redis-master` value with the replacement node name. > [!NOTE] - > If your primary Redis node is also your primary MySQL node, see "[Replacing the primary MySQL node](#replacing-the-primary-mysql-node)." + > If your primary Redis node is also your primary MySQL node, see [Replacing the primary MySQL node](#replacing-the-primary-mysql-node). For example, this modified `cluster.conf` file specifies a newly provisioned cluster node, `ghe-replacement-data-node-1` as the primary Redis node: diff --git a/data/reusables/enterprise_clustering/ssh-to-a-node.md b/data/reusables/enterprise_clustering/ssh-to-a-node.md index 8ea69f566d03..b0fdff474480 100644 --- a/data/reusables/enterprise_clustering/ssh-to-a-node.md +++ b/data/reusables/enterprise_clustering/ssh-to-a-node.md @@ -1 +1 @@ -1. SSH into any node in your cluster. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)." +1. SSH into any node in your cluster. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh). diff --git a/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md b/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md index 80595569b966..ab5f4061750f 100644 --- a/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md +++ b/data/reusables/enterprise_enterprise_support/use_ghe_cluster_support_bundle.md @@ -1,2 +1,2 @@ > [!NOTE] -> If {% data variables.location.product_location %} is in a geo-replication configuration, or if your instance is a cluster, you should use the `ghe-cluster-support-bundle` command to retrieve the support bundle. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-cluster-support-bundle)." +> If {% data variables.location.product_location %} is in a geo-replication configuration, or if your instance is a cluster, you should use the `ghe-cluster-support-bundle` command to retrieve the support bundle. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-cluster-support-bundle). diff --git a/data/reusables/enterprise_installation/about-adjusting-resources.md b/data/reusables/enterprise_installation/about-adjusting-resources.md index 8a9ec0b5dffc..c1be4b2ee308 100644 --- a/data/reusables/enterprise_installation/about-adjusting-resources.md +++ b/data/reusables/enterprise_installation/about-adjusting-resources.md @@ -1 +1 @@ -For more information about adjusting resources for an existing instance, see "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity)" and "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources)." +For more information about adjusting resources for an existing instance, see [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity) and [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources). diff --git a/data/reusables/enterprise_installation/azure-instance-recommendation.md b/data/reusables/enterprise_installation/azure-instance-recommendation.md index 807cf2fe370e..57059647e30a 100644 --- a/data/reusables/enterprise_installation/azure-instance-recommendation.md +++ b/data/reusables/enterprise_installation/azure-instance-recommendation.md @@ -1,5 +1,5 @@ -The {% data variables.product.prodname_ghe_server %} appliance requires a premium storage data disk, and is supported on any Azure VM that supports premium storage. Azure VM types with the `s` suffix support premium storage. For more information, see "[What disk types are available in Azure?](https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types#premium-ssd)" and "[Azure premium storage: design for high performance](https://docs.microsoft.com/en-us/azure/virtual-machines/premium-storage-performance)" in the Azure documentation. +The {% data variables.product.prodname_ghe_server %} appliance requires a premium storage data disk, and is supported on any Azure VM that supports premium storage. Azure VM types with the `s` suffix support premium storage. For more information, see [What disk types are available in Azure?](https://docs.microsoft.com/en-us/azure/virtual-machines/disks-types#premium-ssd) and [Azure premium storage: design for high performance](https://docs.microsoft.com/en-us/azure/virtual-machines/premium-storage-performance) in the Azure documentation. -{% data variables.product.company_short %} recommends a memory-optimized VM for {% data variables.product.prodname_ghe_server %}. For more information, see "[Memory optimized virtual machine sizes](https://docs.microsoft.com/en-us/azure/virtual-machines/sizes-memory)" in the Azure documentation. +{% data variables.product.company_short %} recommends a memory-optimized VM for {% data variables.product.prodname_ghe_server %}. For more information, see [Memory optimized virtual machine sizes](https://docs.microsoft.com/en-us/azure/virtual-machines/sizes-memory) in the Azure documentation. -{% data variables.product.prodname_ghe_server %} supports any region that supports your VM type. For more information about the supported regions for each VM, see Azure's "[Products available by region](https://azure.microsoft.com/regions/services/)." +{% data variables.product.prodname_ghe_server %} supports any region that supports your VM type. For more information about the supported regions for each VM, see Azure's [Products available by region](https://azure.microsoft.com/regions/services/). diff --git a/data/reusables/enterprise_installation/create-ghe-instance.md b/data/reusables/enterprise_installation/create-ghe-instance.md index 9209dc7f5382..d4b8194ff61a 100644 --- a/data/reusables/enterprise_installation/create-ghe-instance.md +++ b/data/reusables/enterprise_installation/create-ghe-instance.md @@ -1 +1 @@ -To create the instance, you'll need to import the {% data variables.product.prodname_ghe_server %} image to your virtual machine and attach an additional storage volume for your instance data. For more information, see "[Hardware considerations](#hardware-considerations)." +To create the instance, you'll need to import the {% data variables.product.prodname_ghe_server %} image to your virtual machine and attach an additional storage volume for your instance data. For more information, see [Hardware considerations](#hardware-considerations). diff --git a/data/reusables/enterprise_installation/disable-github-pages-warning.md b/data/reusables/enterprise_installation/disable-github-pages-warning.md index 9f7aa8f7dae5..4b46243af6bd 100644 --- a/data/reusables/enterprise_installation/disable-github-pages-warning.md +++ b/data/reusables/enterprise_installation/disable-github-pages-warning.md @@ -1,6 +1,6 @@ {% ifversion ghes %} > [!WARNING] -> If subdomain isolation is disabled, we recommend also disabling {% data variables.product.prodname_pages %} on your enterprise. There will be no way to isolate user-supplied {% data variables.product.prodname_pages %} content from the rest of your enterprise's data. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-github-pages-for-your-enterprise)." +> If subdomain isolation is disabled, we recommend also disabling {% data variables.product.prodname_pages %} on your enterprise. There will be no way to isolate user-supplied {% data variables.product.prodname_pages %} content from the rest of your enterprise's data. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-github-pages-for-your-enterprise). {% endif %} diff --git a/data/reusables/enterprise_installation/download-license.md b/data/reusables/enterprise_installation/download-license.md index 545c336c615c..45a7e29fda3d 100644 --- a/data/reusables/enterprise_installation/download-license.md +++ b/data/reusables/enterprise_installation/download-license.md @@ -1 +1 @@ -1. Download your license. For more information, see "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise/downloading-your-license-for-github-enterprise)." +1. Download your license. For more information, see [AUTOTITLE](/billing/managing-your-license-for-github-enterprise/downloading-your-license-for-github-enterprise). diff --git a/data/reusables/enterprise_installation/download-note.md b/data/reusables/enterprise_installation/download-note.md index 6e995939bad1..61b62f94cdc5 100644 --- a/data/reusables/enterprise_installation/download-note.md +++ b/data/reusables/enterprise_installation/download-note.md @@ -1 +1 @@ -> [!NOTE] If you've enabled automatic update checks, you don't need to download the upgrade package and can use the file that was automatically downloaded. For more information, see "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/enabling-automatic-update-checks)." +> [!NOTE] If you've enabled automatic update checks, you don't need to download the upgrade package and can use the file that was automatically downloaded. For more information, see [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/enabling-automatic-update-checks). diff --git a/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md b/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md index 8bc40fbdc9e2..228485cc4c86 100644 --- a/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md +++ b/data/reusables/enterprise_installation/hardware-considerations-all-platforms.md @@ -10,7 +10,7 @@ We recommend different hardware configurations depending on the number of user l {% data reusables.actions.more-resources-for-ghes %} -If you plan to enable {% data variables.product.prodname_container_registry %} for the users of your instance, more resources are required. For more information about these requirements, see "[AUTOTITLE](/admin/packages/getting-started-with-github-packages-for-your-enterprise)." +If you plan to enable {% data variables.product.prodname_container_registry %} for the users of your instance, more resources are required. For more information about these requirements, see [AUTOTITLE](/admin/packages/getting-started-with-github-packages-for-your-enterprise). {% data reusables.enterprise_installation.about-adjusting-resources %} @@ -18,18 +18,18 @@ If you plan to enable {% data variables.product.prodname_container_registry %} f We recommend a high-performance SSD with high input/output operations per second (IOPS) and low latency for {% data variables.product.prodname_ghe_server %}. Workloads are I/O intensive. If you use a bare metal hypervisor, we recommend directly attaching the disk or using a disk from a storage area network (SAN). -Your instance requires a persistent data disk separate from the root disk. For more information, see "[AUTOTITLE](/admin/overview/system-overview)." +Your instance requires a persistent data disk separate from the root disk. For more information, see [AUTOTITLE](/admin/overview/system-overview). >[!WARNING] ->Root storage refers to the total size of your instance's root disk. When the instance is booted you will see {% ifversion ghes > 3.14 %}200GB available on the root filesystem. The remaining 200GB{% else %}100GB available on the root filesystem. The remaining 100GB{% endif %} is reserved for upgrades. For more information, see "[AUTOTITLE](/admin/overview/system-overview#storage-architecture)." +>Root storage refers to the total size of your instance's root disk. When the instance is booted you will see {% ifversion ghes > 3.14 %}200GB available on the root filesystem. The remaining 200GB{% else %}100GB available on the root filesystem. The remaining 100GB{% endif %} is reserved for upgrades. For more information, see [AUTOTITLE](/admin/overview/system-overview#storage-architecture). {% ifversion ghes %} -To configure {% data variables.product.prodname_actions %}, you must provide external blob storage. For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server##external-storage-requirements)." +To configure {% data variables.product.prodname_actions %}, you must provide external blob storage. For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server##external-storage-requirements). {% endif %} -The available space on the root filesystem will be 50% of the total disk size. You can resize your instance's root disk by building a new instance or using an existing instance. For more information, see "[AUTOTITLE](/admin/overview/system-overview#storage-architecture)" and "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity)." +The available space on the root filesystem will be 50% of the total disk size. You can resize your instance's root disk by building a new instance or using an existing instance. For more information, see [AUTOTITLE](/admin/overview/system-overview#storage-architecture) and [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-storage-capacity). ### CPU and memory @@ -39,15 +39,15 @@ Any VMs you provision for {% data variables.location.product_location %} must us {% ifversion ghes %} -If you plan to enable {% data variables.product.prodname_actions %} for the users of your {% data variables.product.prodname_ghe_server %} instance, you may need to provision additional CPU and memory resources for your instance. For more information, see "[AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations)." +If you plan to enable {% data variables.product.prodname_actions %} for the users of your {% data variables.product.prodname_ghe_server %} instance, you may need to provision additional CPU and memory resources for your instance. For more information, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-github-actions-for-github-enterprise-server#review-hardware-considerations). {% endif %} {% data reusables.enterprise_installation.increasing-cpus-req %} > [!WARNING] -> We recommend that users configure webhook events to notify external systems of activity on {% data variables.product.prodname_ghe_server %}. Automated checks for changes, or _polling_, will negatively impact the performance and scalability of your instance. For more information, see "[AUTOTITLE](/get-started/exploring-integrations/about-webhooks)." +> We recommend that users configure webhook events to notify external systems of activity on {% data variables.product.prodname_ghe_server %}. Automated checks for changes, or _polling_, will negatively impact the performance and scalability of your instance. For more information, see [AUTOTITLE](/get-started/exploring-integrations/about-webhooks). -For more information about monitoring the capacity and performance of {% data variables.product.prodname_ghe_server %}, see "[AUTOTITLE](/admin/enterprise-management/monitoring-your-appliance)." +For more information about monitoring the capacity and performance of {% data variables.product.prodname_ghe_server %}, see [AUTOTITLE](/admin/enterprise-management/monitoring-your-appliance). -You can increase your instance's CPU or memory resources. For more information, see "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources)." +You can increase your instance's CPU or memory resources. For more information, see [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/increasing-cpu-or-memory-resources). diff --git a/data/reusables/enterprise_installation/hotpatching-explanation.md b/data/reusables/enterprise_installation/hotpatching-explanation.md index 9eff688e9880..5a27285fac30 100644 --- a/data/reusables/enterprise_installation/hotpatching-explanation.md +++ b/data/reusables/enterprise_installation/hotpatching-explanation.md @@ -4,4 +4,4 @@ You can use hotpatching to upgrade to a newer patch release, but not a feature r Hotpatches do not always require a reboot. When you install the hotpatch, you'll see a message in the terminal if any of the packages need a reboot to complete the update. You can schedule this reboot at a convenient time but we recommend rebooting as soon as practical, especially if there are any security fixes. -Hotpatches require a configuration run, which can cause a brief period of errors or unresponsiveness for some or all services on {% data variables.location.product_location %}. You are not required to enable maintenance mode during installation of a hotpatch, but doing so will guarantee that users see a maintenance page instead of errors or timeouts. See "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode)." +Hotpatches require a configuration run, which can cause a brief period of errors or unresponsiveness for some or all services on {% data variables.location.product_location %}. You are not required to enable maintenance mode during installation of a hotpatch, but doing so will guarantee that users see a maintenance page instead of errors or timeouts. See [AUTOTITLE](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode). diff --git a/data/reusables/enterprise_installation/increase-resources-communicate-and-enable-maintenance-mode.md b/data/reusables/enterprise_installation/increase-resources-communicate-and-enable-maintenance-mode.md index c1e90c69de10..91620db2a2e1 100644 --- a/data/reusables/enterprise_installation/increase-resources-communicate-and-enable-maintenance-mode.md +++ b/data/reusables/enterprise_installation/increase-resources-communicate-and-enable-maintenance-mode.md @@ -1,4 +1,4 @@ 1. Communicate the upcoming downtime to your users and enable maintenance mode. For more information, see the following articles. - * "[AUTOTITLE](/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-mandatory-message)" - * "[AUTOTITLE](/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode)" + * [AUTOTITLE](/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-mandatory-message) + * [AUTOTITLE](/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode) diff --git a/data/reusables/enterprise_installation/increase-resources-shut-down.md b/data/reusables/enterprise_installation/increase-resources-shut-down.md index a84ba9dacd4c..a8a17938ea6a 100644 --- a/data/reusables/enterprise_installation/increase-resources-shut-down.md +++ b/data/reusables/enterprise_installation/increase-resources-shut-down.md @@ -1,4 +1,4 @@ -1. To stop the instance, SSH into the instance, then run the following command. For more information, see "[AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/accessing-the-administrative-shell-ssh)." +1. To stop the instance, SSH into the instance, then run the following command. For more information, see [AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/accessing-the-administrative-shell-ssh). ```shell sudo poweroff diff --git a/data/reusables/enterprise_installation/increase-resources-test-in-maintenance-mode.md b/data/reusables/enterprise_installation/increase-resources-test-in-maintenance-mode.md index f96da497ec3a..65d4295e133d 100644 --- a/data/reusables/enterprise_installation/increase-resources-test-in-maintenance-mode.md +++ b/data/reusables/enterprise_installation/increase-resources-test-in-maintenance-mode.md @@ -1,3 +1,3 @@ {%- ifversion ip-exception-list %} -1. Optionally, you can validate the changes by configuring an IP exception list to allow access from specified IP addresses. For more information, see "[AUTOTITLE](/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list)." +1. Optionally, you can validate the changes by configuring an IP exception list to allow access from specified IP addresses. For more information, see [AUTOTITLE](/admin/administering-your-instance/configuring-maintenance-mode/enabling-and-scheduling-maintenance-mode#validating-changes-in-maintenance-mode-using-the-ip-exception-list). {%- endif %} diff --git a/data/reusables/enterprise_installation/replication-status-upgrade.md b/data/reusables/enterprise_installation/replication-status-upgrade.md index 9f27796ddc27..6b59b87ce3f9 100644 --- a/data/reusables/enterprise_installation/replication-status-upgrade.md +++ b/data/reusables/enterprise_installation/replication-status-upgrade.md @@ -13,4 +13,4 @@ If the command returns `Replication is not running`, the replication may still b > CRITICAL: mssql replication is down, didn't find Token_Configuration! > ``` - If `ghe-repl-status` did not return `OK`, and the explanation isn't listed in the note above, contact {% data variables.contact.enterprise_support %}. For more information, see "[AUTOTITLE](/support/contacting-github-support)." + If `ghe-repl-status` did not return `OK`, and the explanation isn't listed in the note above, contact {% data variables.contact.enterprise_support %}. For more information, see [AUTOTITLE](/support/contacting-github-support). diff --git a/data/reusables/enterprise_installation/request-a-trial.md b/data/reusables/enterprise_installation/request-a-trial.md index 4c4919b71fae..a2f0351e3b35 100644 --- a/data/reusables/enterprise_installation/request-a-trial.md +++ b/data/reusables/enterprise_installation/request-a-trial.md @@ -1 +1 @@ -You can request a trial to evaluate {% data variables.product.prodname_ghe_server %}. For more information, see "[Setting up a trial of {% data variables.product.prodname_ghe_server %}](/admin/overview/setting-up-a-trial-of-github-enterprise-server)." +You can request a trial to evaluate {% data variables.product.prodname_ghe_server %}. For more information, see [Setting up a trial of {% data variables.product.prodname_ghe_server %}](/admin/overview/setting-up-a-trial-of-github-enterprise-server). diff --git a/data/reusables/enterprise_installation/software-license.md b/data/reusables/enterprise_installation/software-license.md index 9ecbdc0faf22..a94fa9ccb96d 100644 --- a/data/reusables/enterprise_installation/software-license.md +++ b/data/reusables/enterprise_installation/software-license.md @@ -1 +1 @@ -You must have a {% data variables.product.prodname_enterprise %} license file. For more information, see "[AUTOTITLE](/admin/overview/setting-up-a-trial-of-github-enterprise-server)" and "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise/about-licenses-for-github-enterprise)." +You must have a {% data variables.product.prodname_enterprise %} license file. For more information, see [AUTOTITLE](/admin/overview/setting-up-a-trial-of-github-enterprise-server) and [AUTOTITLE](/billing/managing-your-license-for-github-enterprise/about-licenses-for-github-enterprise). diff --git a/data/reusables/enterprise_installation/ssh-into-cluster-node.md b/data/reusables/enterprise_installation/ssh-into-cluster-node.md index 22986ce026ad..5e33d39093fd 100644 --- a/data/reusables/enterprise_installation/ssh-into-cluster-node.md +++ b/data/reusables/enterprise_installation/ssh-into-cluster-node.md @@ -1,4 +1,4 @@ -1. To connect to {% data variables.location.product_location %}, SSH into any of your cluster's nodes. From your workstation, run the following command. Replace HOSTNAME with the node's hostname. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)." +1. To connect to {% data variables.location.product_location %}, SSH into any of your cluster's nodes. From your workstation, run the following command. Replace HOSTNAME with the node's hostname. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh). ```shell copy ssh -p 122 admin@HOSTNAME diff --git a/data/reusables/enterprise_installation/ssh-into-staging-instance.md b/data/reusables/enterprise_installation/ssh-into-staging-instance.md index 8126b1c59763..935536db53ba 100644 --- a/data/reusables/enterprise_installation/ssh-into-staging-instance.md +++ b/data/reusables/enterprise_installation/ssh-into-staging-instance.md @@ -1,4 +1,4 @@ -1. SSH into the staging instance. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)." +1. SSH into the staging instance. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh). ```shell copy ssh -p 122 admin@HOSTNAME diff --git a/data/reusables/enterprise_installation/upload-a-license-file.md b/data/reusables/enterprise_installation/upload-a-license-file.md index 5ebfdca0a0f5..fcf6cec80b33 100644 --- a/data/reusables/enterprise_installation/upload-a-license-file.md +++ b/data/reusables/enterprise_installation/upload-a-license-file.md @@ -1 +1 @@ -1. At the prompt, upload your license file and set a management console password. For more information, see "[AUTOTITLE](/billing/managing-your-license-for-github-enterprise)." +1. At the prompt, upload your license file and set a management console password. For more information, see [AUTOTITLE](/billing/managing-your-license-for-github-enterprise). diff --git a/data/reusables/enterprise_installation/warning-on-upgrading-physical-resources.md b/data/reusables/enterprise_installation/warning-on-upgrading-physical-resources.md index 5395ec9db5e5..72c8d10af4b7 100644 --- a/data/reusables/enterprise_installation/warning-on-upgrading-physical-resources.md +++ b/data/reusables/enterprise_installation/warning-on-upgrading-physical-resources.md @@ -1 +1 @@ -The process for allocating new system resources varies by virtualization platform and resource type. You should always configure the monitoring and alerting of key system resources. For more information, see "[AUTOTITLE](/admin/enterprise-management/monitoring-your-appliance)." +The process for allocating new system resources varies by virtualization platform and resource type. You should always configure the monitoring and alerting of key system resources. For more information, see [AUTOTITLE](/admin/enterprise-management/monitoring-your-appliance). diff --git a/data/reusables/enterprise_installation/when-9418-necessary.md b/data/reusables/enterprise_installation/when-9418-necessary.md index 44881b401520..0db417862d1b 100644 --- a/data/reusables/enterprise_installation/when-9418-necessary.md +++ b/data/reusables/enterprise_installation/when-9418-necessary.md @@ -1 +1 @@ -If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access)." +If you have enabled private mode on your instance, then opening this port is only required if you also enabled anonymous Git read access. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#configuring-anonymous-git-read-access). diff --git a/data/reusables/enterprise_management_console/api-deprecation.md b/data/reusables/enterprise_management_console/api-deprecation.md index e929452dcda0..74b8b6790b2b 100644 --- a/data/reusables/enterprise_management_console/api-deprecation.md +++ b/data/reusables/enterprise_management_console/api-deprecation.md @@ -1,6 +1,6 @@ {% ifversion management-console-manage-ghes-parity %} > [!NOTE] -> The {% data variables.enterprise.management_console %} endpoints will be deprecated in a future version of {% data variables.product.prodname_ghe_server %}. You can access the same functionality using the Manage {% data variables.product.prodname_ghe_server %} endpoints. For more information, see "[AUTOTITLE](/rest/enterprise-admin/manage-ghes)." +> The {% data variables.enterprise.management_console %} endpoints will be deprecated in a future version of {% data variables.product.prodname_ghe_server %}. You can access the same functionality using the Manage {% data variables.product.prodname_ghe_server %} endpoints. For more information, see [AUTOTITLE](/rest/enterprise-admin/manage-ghes). {% endif %} diff --git a/data/reusables/enterprise_management_console/test-domain-settings-failure.md b/data/reusables/enterprise_management_console/test-domain-settings-failure.md index f6e72109813e..1cde36f24e28 100644 --- a/data/reusables/enterprise_management_console/test-domain-settings-failure.md +++ b/data/reusables/enterprise_management_console/test-domain-settings-failure.md @@ -1 +1 @@ -1. If you don't receive a green checkmark next to all entries, review your configuration for the setting that failed. For more information, see "[AUTOTITLE](/admin/configuration/configuring-network-settings/configuring-dns-nameservers)." +1. If you don't receive a green checkmark next to all entries, review your configuration for the setting that failed. For more information, see [AUTOTITLE](/admin/configuration/configuring-network-settings/configuring-dns-nameservers). diff --git a/data/reusables/enterprise_management_console/type-management-console-password.md b/data/reusables/enterprise_management_console/type-management-console-password.md index 0659306b5d86..2fb3c67ac288 100644 --- a/data/reusables/enterprise_management_console/type-management-console-password.md +++ b/data/reusables/enterprise_management_console/type-management-console-password.md @@ -1,5 +1,5 @@ {%- ifversion enterprise-management-console-multi-user-auth %} -1. If you have created multiple {% data variables.enterprise.management_console %} user accounts, select **Root site admin** or **{% data variables.enterprise.management_console %} user**. For more information about {% data variables.enterprise.management_console %} user accounts see, "[AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/managing-access-to-the-management-console)." +1. If you have created multiple {% data variables.enterprise.management_console %} user accounts, select **Root site admin** or **{% data variables.enterprise.management_console %} user**. For more information about {% data variables.enterprise.management_console %} user accounts see, [AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/managing-access-to-the-management-console). 1. Type your {% data variables.enterprise.management_console %} credentials. Then click **Continue**. {%- else %} 1. If prompted, type your {% data variables.enterprise.management_console %} password. diff --git a/data/reusables/enterprise_management_console/unlocking-management-console-with-shell.md b/data/reusables/enterprise_management_console/unlocking-management-console-with-shell.md index 867f3f5e416f..de72c870971d 100644 --- a/data/reusables/enterprise_management_console/unlocking-management-console-with-shell.md +++ b/data/reusables/enterprise_management_console/unlocking-management-console-with-shell.md @@ -1 +1 @@ -If the root site administrator's {% data variables.enterprise.management_console %} login is locked, someone with administrative SSH access must unlock the login. To immediately unlock access to the {% data variables.enterprise.management_console %}{% ifversion enterprise-management-console-multi-user-auth %} by the root site administrator{% endif %}, use the `ghe-reactivate-admin-login` command via the administrative shell. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-reactivate-admin-login)" and "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh)." +If the root site administrator's {% data variables.enterprise.management_console %} login is locked, someone with administrative SSH access must unlock the login. To immediately unlock access to the {% data variables.enterprise.management_console %}{% ifversion enterprise-management-console-multi-user-auth %} by the root site administrator{% endif %}, use the `ghe-reactivate-admin-login` command via the administrative shell. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-reactivate-admin-login) and [AUTOTITLE](/admin/configuration/configuring-your-enterprise/accessing-the-administrative-shell-ssh). diff --git a/data/reusables/enterprise_migrations/locking-repositories.md b/data/reusables/enterprise_migrations/locking-repositories.md index ed0da5d3533e..d72d7130f3ff 100644 --- a/data/reusables/enterprise_migrations/locking-repositories.md +++ b/data/reusables/enterprise_migrations/locking-repositories.md @@ -1,4 +1,4 @@ > [!NOTE] > Locking a repository prevents all write access to the repository. You cannot associate new teams or collaborators with a locked repository. > ->If you're performing a trial run, you do not need to lock the repository. When you migrate data from a repository that's in use, {% data variables.product.company_short %} strongly recommends locking the repository. For more information, see "[AUTOTITLE](/migrations/using-ghe-migrator/about-ghe-migrator#types-of-migrations)." +>If you're performing a trial run, you do not need to lock the repository. When you migrate data from a repository that's in use, {% data variables.product.company_short %} strongly recommends locking the repository. For more information, see [AUTOTITLE](/migrations/using-ghe-migrator/about-ghe-migrator#types-of-migrations). diff --git a/data/reusables/enterprise_migrations/ready-to-import-migrations.md b/data/reusables/enterprise_migrations/ready-to-import-migrations.md index 48011f01db71..e2bf56a3af70 100644 --- a/data/reusables/enterprise_migrations/ready-to-import-migrations.md +++ b/data/reusables/enterprise_migrations/ready-to-import-migrations.md @@ -1 +1 @@ -1. To prepare the archived migration data for import into a {% data variables.product.prodname_ghe_server %} instance, see "[AUTOTITLE](/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server#preparing-the-migrated-data)". +1. To prepare the archived migration data for import into a {% data variables.product.prodname_ghe_server %} instance, see [AUTOTITLE](/migrations/using-ghe-migrator/migrating-data-to-github-enterprise-server#preparing-the-migrated-data). diff --git a/data/reusables/enterprise_site_admin_settings/add-key-to-web-flow-user.md b/data/reusables/enterprise_site_admin_settings/add-key-to-web-flow-user.md index 75794fcbc5f5..fb1edd550423 100644 --- a/data/reusables/enterprise_site_admin_settings/add-key-to-web-flow-user.md +++ b/data/reusables/enterprise_site_admin_settings/add-key-to-web-flow-user.md @@ -6,7 +6,7 @@ 1. Copy your PGP key, beginning with `-----BEGIN PGP PUBLIC KEY BLOCK-----` and ending with `-----END PGP PUBLIC KEY BLOCK-----`. 1. Sign into {% data variables.product.prodname_ghe_server %} as the user created for web commit signing, for example, `web-flow`. -1. Add the public PGP key to the user's profile. For more information, see "[AUTOTITLE](/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account)." +1. Add the public PGP key to the user's profile. For more information, see [AUTOTITLE](/authentication/managing-commit-signature-verification/adding-a-gpg-key-to-your-github-account). > [!NOTE] > Do not remove other public keys from the list of GPG keys. If a public key is deleted, any commits signed with the corresponding private key will no longer be marked as verified. diff --git a/data/reusables/enterprise_site_admin_settings/maintenance-mode-status.md b/data/reusables/enterprise_site_admin_settings/maintenance-mode-status.md index 58307e656431..1d9ee0487843 100644 --- a/data/reusables/enterprise_site_admin_settings/maintenance-mode-status.md +++ b/data/reusables/enterprise_site_admin_settings/maintenance-mode-status.md @@ -1,2 +1,2 @@ > [!NOTE] -> When the appliance is in maintenance mode, the `https://HOSTNAME/status` URL will return status code `503` (Service Unavailable). For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode)." +> When the appliance is in maintenance mode, the `https://HOSTNAME/status` URL will return status code `503` (Service Unavailable). For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode). diff --git a/data/reusables/enterprise_site_admin_settings/management-console-access.md b/data/reusables/enterprise_site_admin_settings/management-console-access.md index c1650cb0c65e..c3209cdf2d3c 100644 --- a/data/reusables/enterprise_site_admin_settings/management-console-access.md +++ b/data/reusables/enterprise_site_admin_settings/management-console-access.md @@ -1,5 +1,5 @@ ## About access to the {% data variables.enterprise.management_console %} -{% data reusables.enterprise_site_admin_settings.management-console-overview %} For more information, see "[AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/about-the-management-console)." +{% data reusables.enterprise_site_admin_settings.management-console-overview %} For more information, see [AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/about-the-management-console). You can access the {% data variables.enterprise.management_console %}{% ifversion enterprise-management-console-multi-user-auth %} as the root site administrator or a {% data variables.enterprise.management_console %} user{% endif %}. An administrator created the {% ifversion enterprise-management-console-multi-user-auth %}root site administrator {% endif %}password during the initial setup process for {% data variables.location.product_location %}. diff --git a/data/reusables/enterprise_site_admin_settings/sign-in-as-root-administrator.md b/data/reusables/enterprise_site_admin_settings/sign-in-as-root-administrator.md index 505767103e63..af2fcc5962cd 100644 --- a/data/reusables/enterprise_site_admin_settings/sign-in-as-root-administrator.md +++ b/data/reusables/enterprise_site_admin_settings/sign-in-as-root-administrator.md @@ -1 +1 @@ -1. Sign into the {% data variables.enterprise.management_console %} as the root site administrator. For more information, see "[AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/accessing-the-management-console)." +1. Sign into the {% data variables.enterprise.management_console %} as the root site administrator. For more information, see [AUTOTITLE](/admin/configuration/administering-your-instance-from-the-management-console/accessing-the-management-console). diff --git a/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md b/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md index f20fbad50491..bf1fdbcd77cc 100644 --- a/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md +++ b/data/reusables/enterprise_user_management/SAML-to-OIDC-migration-for-EMU.md @@ -1 +1 @@ -If you currently use SAML SSO for authentication and would prefer to use OIDC and benefit from CAP support, you can follow a migration path. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc)." +If you currently use SAML SSO for authentication and would prefer to use OIDC and benefit from CAP support, you can follow a migration path. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/migrating-from-saml-to-oidc). diff --git a/data/reusables/enterprise_user_management/alternatively-enable-external-authentication.md b/data/reusables/enterprise_user_management/alternatively-enable-external-authentication.md index c02f92af602e..58ccbeade70e 100644 --- a/data/reusables/enterprise_user_management/alternatively-enable-external-authentication.md +++ b/data/reusables/enterprise_user_management/alternatively-enable-external-authentication.md @@ -1 +1 @@ -Alternatively, you can configure external authentication for {% data variables.location.product_location %}. If you use external authentication, you must invite people to use your instance through your authentication provider. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#external-authentication)." +Alternatively, you can configure external authentication for {% data variables.location.product_location %}. If you use external authentication, you must invite people to use your instance through your authentication provider. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/about-authentication-for-your-enterprise#external-authentication). diff --git a/data/reusables/enterprise_user_management/built-in-authentication-option.md b/data/reusables/enterprise_user_management/built-in-authentication-option.md index 8858826f1a44..c31801e77201 100644 --- a/data/reusables/enterprise_user_management/built-in-authentication-option.md +++ b/data/reusables/enterprise_user_management/built-in-authentication-option.md @@ -1 +1 @@ -Optionally, to allow people without an account on your external authentication system to sign in with built-in authentication, select **Allow built-in authentication**. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)." +Optionally, to allow people without an account on your external authentication system to sign in with built-in authentication, select **Allow built-in authentication**. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider). diff --git a/data/reusables/enterprise_user_management/built-in-authentication.md b/data/reusables/enterprise_user_management/built-in-authentication.md index 712d2eb1f329..81a707f84d8c 100644 --- a/data/reusables/enterprise_user_management/built-in-authentication.md +++ b/data/reusables/enterprise_user_management/built-in-authentication.md @@ -1 +1 @@ -If you want to allow authentication for some people who don't have an account on your external authentication provider, you can allow fallback authentication to local accounts on {% data variables.location.product_location %}. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider)." +If you want to allow authentication for some people who don't have an account on your external authentication provider, you can allow fallback authentication to local accounts on {% data variables.location.product_location %}. For more information, see [AUTOTITLE](/admin/identity-and-access-management/managing-iam-for-your-enterprise/allowing-built-in-authentication-for-users-outside-your-provider). diff --git a/data/reusables/enterprise_user_management/external_auth_disables_2fa.md b/data/reusables/enterprise_user_management/external_auth_disables_2fa.md index c991cb477fca..3321688fa036 100644 --- a/data/reusables/enterprise_user_management/external_auth_disables_2fa.md +++ b/data/reusables/enterprise_user_management/external_auth_disables_2fa.md @@ -1 +1 @@ -When using SAML or CAS, two-factor authentication is not supported or managed on the {% data variables.product.prodname_ghe_server %} instance, but may be supported by the external authentication provider. Two-factor authentication enforcement on organizations is not available. For more information about enforcing two-factor authentication on organizations, see "[AUTOTITLE](/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization)." +When using SAML or CAS, two-factor authentication is not supported or managed on the {% data variables.product.prodname_ghe_server %} instance, but may be supported by the external authentication provider. Two-factor authentication enforcement on organizations is not available. For more information about enforcing two-factor authentication on organizations, see [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization). diff --git a/data/reusables/enterprise_user_management/ghec-supported-idps.md b/data/reusables/enterprise_user_management/ghec-supported-idps.md index 6a8f9586c14a..52832470c4cf 100644 --- a/data/reusables/enterprise_user_management/ghec-supported-idps.md +++ b/data/reusables/enterprise_user_management/ghec-supported-idps.md @@ -1,3 +1,3 @@ -If you choose to create an enterprise that uses personal accounts on {% data variables.product.prodname_dotcom_the_website %}, you can configure additional authentication with an external identity management system that adheres to the SAML 2.0 standard. {% data variables.product.company_short %} also officially supports and tests some identity management systems. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise#supported-identity-providers)." +If you choose to create an enterprise that uses personal accounts on {% data variables.product.prodname_dotcom_the_website %}, you can configure additional authentication with an external identity management system that adheres to the SAML 2.0 standard. {% data variables.product.company_short %} also officially supports and tests some identity management systems. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-saml-for-enterprise-iam/configuring-saml-single-sign-on-for-your-enterprise#supported-identity-providers). -{% data reusables.enterprise_user_management.emu-paved-path-iam-integrations %} If you use a partner identity provider (IdP), you can configure one application on your IdP to provide authentication and provisioning. The IdP must support the SAML 2.0 standard. Alternatively, if you use Entra ID (previously known as Azure AD), you can configure OpenID Connect (OIDC) authentication. If you don't use a partner IdP, or if you only use a partner IdP for authentication, you can integrate IdPs that implement the SAML 2.0 and System for Cross-domain Identity Management (SCIM) 2.0 standards. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/about-enterprise-managed-users#about-authentication-and-user-provisioning)." +{% data reusables.enterprise_user_management.emu-paved-path-iam-integrations %} If you use a partner identity provider (IdP), you can configure one application on your IdP to provide authentication and provisioning. The IdP must support the SAML 2.0 standard. Alternatively, if you use Entra ID (previously known as Azure AD), you can configure OpenID Connect (OIDC) authentication. If you don't use a partner IdP, or if you only use a partner IdP for authentication, you can integrate IdPs that implement the SAML 2.0 and System for Cross-domain Identity Management (SCIM) 2.0 standards. For more information, see [AUTOTITLE](/admin/identity-and-access-management/understanding-iam-for-enterprises/about-enterprise-managed-users#about-authentication-and-user-provisioning). diff --git a/data/reusables/enterprise_user_management/ldap-sync-nested-teams.md b/data/reusables/enterprise_user_management/ldap-sync-nested-teams.md index 9f173b7cfd7a..51988782bc89 100644 --- a/data/reusables/enterprise_user_management/ldap-sync-nested-teams.md +++ b/data/reusables/enterprise_user_management/ldap-sync-nested-teams.md @@ -1,3 +1,3 @@ {% ifversion ghes %} -As part of its optimization configuration, LDAP Sync will not transfer your nested team structure. To create child and parent team relationships, you must manually recreate the nested team structure and sync it with the corresponding LDAP group. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/creating-a-team#creating-teams-with-ldap-sync-enabled)" +As part of its optimization configuration, LDAP Sync will not transfer your nested team structure. To create child and parent team relationships, you must manually recreate the nested team structure and sync it with the corresponding LDAP group. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/creating-a-team#creating-teams-with-ldap-sync-enabled) {% endif %} diff --git a/data/reusables/enterprise_user_management/manage-global-webhooks-api.md b/data/reusables/enterprise_user_management/manage-global-webhooks-api.md index 104275e1251d..c2caab4a6f01 100644 --- a/data/reusables/enterprise_user_management/manage-global-webhooks-api.md +++ b/data/reusables/enterprise_user_management/manage-global-webhooks-api.md @@ -1,3 +1,3 @@ {% ifversion ghes %} -You can also use the REST API to manage global webhooks. For a complete list of endpoints, see "[AUTOTITLE](/rest/enterprise-admin/global-webhooks)." +You can also use the REST API to manage global webhooks. For a complete list of endpoints, see [AUTOTITLE](/rest/enterprise-admin/global-webhooks). {% endif %} diff --git a/data/reusables/enterprise_user_management/migration-teams-warning.md b/data/reusables/enterprise_user_management/migration-teams-warning.md index cacdbe21c553..614394a5388e 100644 --- a/data/reusables/enterprise_user_management/migration-teams-warning.md +++ b/data/reusables/enterprise_user_management/migration-teams-warning.md @@ -1 +1 @@ -When you migrate to a new IdP or tenant, connections between {% data variables.product.prodname_dotcom %} teams and IdP groups are removed, and are not reinstated after the migration. This will remove all members from the team and leave the team unconnected to your IdP, which may cause disruption if you use team sync to manage access to organizations or licenses from your IdP. We recommend you use the "External groups" endpoints of the REST API to gather information about your teams setup before you migrate, and to reinstate connections afterwards. For more information, see "[AUTOTITLE](/rest/teams/external-groups)." +When you migrate to a new IdP or tenant, connections between {% data variables.product.prodname_dotcom %} teams and IdP groups are removed, and are not reinstated after the migration. This will remove all members from the team and leave the team unconnected to your IdP, which may cause disruption if you use team sync to manage access to organizations or licenses from your IdP. We recommend you use the "External groups" endpoints of the REST API to gather information about your teams setup before you migrate, and to reinstate connections afterwards. For more information, see [AUTOTITLE](/rest/teams/external-groups). diff --git a/data/reusables/enterprise_user_management/scim-manages-user-lifecycle.md b/data/reusables/enterprise_user_management/scim-manages-user-lifecycle.md index efe68a83c7e5..16d3f4333893 100644 --- a/data/reusables/enterprise_user_management/scim-manages-user-lifecycle.md +++ b/data/reusables/enterprise_user_management/scim-manages-user-lifecycle.md @@ -6,5 +6,5 @@ With SCIM, you manage the lifecycle of user accounts from your IdP: * If you reassign a user to the IdP application or reactivate their account on your IdP, the user account will be reactivated, and the username will be restored. {% ifversion ghec or ghes > 3.13 %} -To configure team and organization membership, repository access, and permissions on {% data variables.product.product_name %}, you can use groups on your IdP. For more information, see "[AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups)." +To configure team and organization membership, repository access, and permissions on {% data variables.product.product_name %}, you can use groups on your IdP. For more information, see [AUTOTITLE](/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/managing-team-memberships-with-identity-provider-groups). {% endif %} diff --git a/data/reusables/files/choose-commit-email.md b/data/reusables/files/choose-commit-email.md index e8da0f234971..cf11b47c6ef1 100644 --- a/data/reusables/files/choose-commit-email.md +++ b/data/reusables/files/choose-commit-email.md @@ -1,5 +1,5 @@ {%- ifversion fpt or ghec %} -1. If you have more than one email address associated with your account on {% data variables.product.prodname_dotcom %}, click the email address drop-down menu and select the email address to use as the Git author email address. Only verified email addresses appear in this drop-down menu. If you enabled email address privacy, then a no-reply will be the default commit author email address. For more information about the exact form the no-reply email address can take, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address)." +1. If you have more than one email address associated with your account on {% data variables.product.prodname_dotcom %}, click the email address drop-down menu and select the email address to use as the Git author email address. Only verified email addresses appear in this drop-down menu. If you enabled email address privacy, then a no-reply will be the default commit author email address. For more information about the exact form the no-reply email address can take, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address). ![Screenshot of a {% data variables.product.prodname_dotcom %} pull request showing a dropdown menu with options to choose the commit author email address. octocat@github.com is selected.](/assets/images/help/repository/choose-commit-email-address.png) {%- endif %} diff --git a/data/reusables/files/choose_commit_branch.md b/data/reusables/files/choose_commit_branch.md index ad0dad44ea14..852683542363 100644 --- a/data/reusables/files/choose_commit_branch.md +++ b/data/reusables/files/choose_commit_branch.md @@ -1,3 +1,3 @@ -1. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)." +1. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). ![Screenshot of a {% data variables.product.prodname_dotcom %} pull request showing a radio button to commit directly to the main branch or to create a new branch. New branch is selected.](/assets/images/help/repository/choose-commit-branch.png) diff --git a/data/reusables/files/commit-author-email-options.md b/data/reusables/files/commit-author-email-options.md index bbd1b696eefa..cd7e1024b7d1 100644 --- a/data/reusables/files/commit-author-email-options.md +++ b/data/reusables/files/commit-author-email-options.md @@ -1,3 +1,3 @@ {% ifversion fpt or ghec %} -If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on {% data variables.product.product_name %}. If you enabled email address privacy, then the commit author email address cannot be changed and will be a no-reply by default. For more information about the exact form the no-reply email address can take, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address)." +If you haven't enabled email address privacy, you can choose which verified email address to author changes with when you edit, delete, or create files or merge a pull request on {% data variables.product.product_name %}. If you enabled email address privacy, then the commit author email address cannot be changed and will be a no-reply by default. For more information about the exact form the no-reply email address can take, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address). {% endif %} diff --git a/data/reusables/files/commit-message.md b/data/reusables/files/commit-message.md index c34e5f604ca9..e45ff9e179ce 100644 --- a/data/reusables/files/commit-message.md +++ b/data/reusables/files/commit-message.md @@ -1 +1 @@ -1. In the "Commit message" field, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "[AUTOTITLE](/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors)." +1. In the "Commit message" field, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see [AUTOTITLE](/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors). diff --git a/data/reusables/files/delete_branch.md b/data/reusables/files/delete_branch.md index f190ebf954b7..a28e43c25bb8 100644 --- a/data/reusables/files/delete_branch.md +++ b/data/reusables/files/delete_branch.md @@ -1 +1 @@ -1. Optionally, delete the branch. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)." +1. Optionally, delete the branch. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository). diff --git a/data/reusables/files/merge_pull_request.md b/data/reusables/files/merge_pull_request.md index ef861d070717..65a6f7584e62 100644 --- a/data/reusables/files/merge_pull_request.md +++ b/data/reusables/files/merge_pull_request.md @@ -1 +1 @@ -1. Click **Merge pull request**. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)." +1. Click **Merge pull request**. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request). diff --git a/data/reusables/files/write_commit_message.md b/data/reusables/files/write_commit_message.md index e26568855c00..897b4c292a53 100644 --- a/data/reusables/files/write_commit_message.md +++ b/data/reusables/files/write_commit_message.md @@ -1,4 +1,4 @@ {% ifversion code-view-ui %} 1. Click **Commit changes...** {% endif %} -1. In the "Commit message" field, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "[AUTOTITLE](/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors)." +1. In the "Commit message" field, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see [AUTOTITLE](/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors). diff --git a/data/reusables/gated-features/cluster.md b/data/reusables/gated-features/cluster.md index 32821142a22b..a2dd12567407 100644 --- a/data/reusables/gated-features/cluster.md +++ b/data/reusables/gated-features/cluster.md @@ -1 +1 @@ -{% data variables.product.company_short %} determines eligibility for clustering, and must enable the configuration for your instance's license. Clustering requires careful planning and additional administrative overhead. For more information, see "[AUTOTITLE](/admin/enterprise-management/configuring-clustering/about-clustering)." +{% data variables.product.company_short %} determines eligibility for clustering, and must enable the configuration for your instance's license. Clustering requires careful planning and additional administrative overhead. For more information, see [AUTOTITLE](/admin/enterprise-management/configuring-clustering/about-clustering). diff --git a/data/reusables/gated-features/code-review-assignment.md b/data/reusables/gated-features/code-review-assignment.md index 0c72d4db5641..cb18c0ec267b 100644 --- a/data/reusables/gated-features/code-review-assignment.md +++ b/data/reusables/gated-features/code-review-assignment.md @@ -1 +1 @@ -Code review settings are available in all public repositories owned by an organization, and all private repositories owned by organizations on {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_server %}, and {% data variables.product.prodname_ghe_cloud %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +Code review settings are available in all public repositories owned by an organization, and all private repositories owned by organizations on {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_server %}, and {% data variables.product.prodname_ghe_cloud %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans). diff --git a/data/reusables/gated-features/codespaces-classroom-articles.md b/data/reusables/gated-features/codespaces-classroom-articles.md index ab0c01198373..2b82acaead85 100644 --- a/data/reusables/gated-features/codespaces-classroom-articles.md +++ b/data/reusables/gated-features/codespaces-classroom-articles.md @@ -1 +1 @@ -{% data variables.product.prodname_github_codespaces %} is available to use with {% data variables.product.prodname_classroom %} for organizations that use {% data variables.product.prodname_team %}. To find out if you qualify for a free upgrade to {% data variables.product.prodname_team %}, see "[AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-education-for-teachers/apply-to-github-education-as-a-teacher)." +{% data variables.product.prodname_github_codespaces %} is available to use with {% data variables.product.prodname_classroom %} for organizations that use {% data variables.product.prodname_team %}. To find out if you qualify for a free upgrade to {% data variables.product.prodname_team %}, see [AUTOTITLE](/education/explore-the-benefits-of-teaching-and-learning-with-github-education/github-education-for-teachers/apply-to-github-education-as-a-teacher). diff --git a/data/reusables/gated-features/codespaces-org.md b/data/reusables/gated-features/codespaces-org.md index bef77b6c2727..4c99f8e5c88e 100644 --- a/data/reusables/gated-features/codespaces-org.md +++ b/data/reusables/gated-features/codespaces-org.md @@ -1 +1 @@ -Organizations on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %} plans can pay for members' and collaborators' use of {% data variables.product.prodname_github_codespaces %}. These organizations can then access settings and policies to manage codespaces paid for by the organization. For more information, see "[AUTOTITLE](/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization#about-ownership-of-codespaces)" and "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +Organizations on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %} plans can pay for members' and collaborators' use of {% data variables.product.prodname_github_codespaces %}. These organizations can then access settings and policies to manage codespaces paid for by the organization. For more information, see [AUTOTITLE](/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization#about-ownership-of-codespaces) and [AUTOTITLE](/get-started/learning-about-github/githubs-plans). diff --git a/data/reusables/gated-features/codespaces-repo.md b/data/reusables/gated-features/codespaces-repo.md index 412e974d12e4..45ee3bd6cec3 100644 --- a/data/reusables/gated-features/codespaces-repo.md +++ b/data/reusables/gated-features/codespaces-repo.md @@ -1,3 +1,3 @@ Repository-level settings for {% data variables.product.prodname_github_codespaces %} are available for all repositories owned by personal accounts.

-For repositories owned by organizations, repository-level settings for {% data variables.product.prodname_github_codespaces %} are available for organizations on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %} plans. To access the settings, the organization or its parent enterprise must have added a payment method and set a spending limit for {% data variables.product.prodname_github_codespaces %}. For more information, see "[AUTOTITLE](/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization)" and "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +For repositories owned by organizations, repository-level settings for {% data variables.product.prodname_github_codespaces %} are available for organizations on {% data variables.product.prodname_team %} and {% data variables.product.prodname_enterprise %} plans. To access the settings, the organization or its parent enterprise must have added a payment method and set a spending limit for {% data variables.product.prodname_github_codespaces %}. For more information, see [AUTOTITLE](/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization) and [AUTOTITLE](/get-started/learning-about-github/githubs-plans). diff --git a/data/reusables/gated-features/delegated-bypass.md b/data/reusables/gated-features/delegated-bypass.md index dee876fb33bf..ba1cb7223c91 100644 --- a/data/reusables/gated-features/delegated-bypass.md +++ b/data/reusables/gated-features/delegated-bypass.md @@ -1,4 +1,4 @@ -Delegated bypass requires push protection to be enabled for the organization or the repository. See "[AUTOTITLE](/code-security/secret-scanning/introduction/about-push-protection)." +Delegated bypass requires push protection to be enabled for the organization or the repository. See [AUTOTITLE](/code-security/secret-scanning/introduction/about-push-protection). Delegated bypass is available for the following repositories: diff --git a/data/reusables/gated-features/display-names.md b/data/reusables/gated-features/display-names.md index d3ec098710fa..812fe5cdf321 100644 --- a/data/reusables/gated-features/display-names.md +++ b/data/reusables/gated-features/display-names.md @@ -1 +1 @@ -Allowing members to see comment authors' profile names is available with {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_server %}, and {% data variables.product.prodname_ghe_cloud %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +Allowing members to see comment authors' profile names is available with {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_server %}, and {% data variables.product.prodname_ghe_cloud %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans). diff --git a/data/reusables/gated-features/emus.md b/data/reusables/gated-features/emus.md index d50d56ff8638..596cce27d0e0 100644 --- a/data/reusables/gated-features/emus.md +++ b/data/reusables/gated-features/emus.md @@ -1,5 +1,5 @@ {% ifversion ghec %} -{% data variables.product.prodname_emus %} is available for new enterprise accounts on {% data variables.product.prodname_ghe_cloud %}. See "[AUTOTITLE](/enterprise-cloud@latest/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users)." +{% data variables.product.prodname_emus %} is available for new enterprise accounts on {% data variables.product.prodname_ghe_cloud %}. See [AUTOTITLE](/enterprise-cloud@latest/admin/identity-and-access-management/using-enterprise-managed-users-for-iam/about-enterprise-managed-users). {% endif %} diff --git a/data/reusables/gated-features/generated-health-checks.md b/data/reusables/gated-features/generated-health-checks.md index 53374a57556b..18bcc91c95f6 100644 --- a/data/reusables/gated-features/generated-health-checks.md +++ b/data/reusables/gated-features/generated-health-checks.md @@ -1 +1 @@ -Generating a Health Check is available with {% data variables.contact.premium_support %}. For more information, see "[AUTOTITLE](/support/learning-about-github-support/about-github-premium-support)." +Generating a Health Check is available with {% data variables.contact.premium_support %}. For more information, see [AUTOTITLE](/support/learning-about-github-support/about-github-premium-support). diff --git a/data/reusables/gated-features/ghas-ghec.md b/data/reusables/gated-features/ghas-ghec.md index c490a5f9f720..755c9b2b0f73 100644 --- a/data/reusables/gated-features/ghas-ghec.md +++ b/data/reusables/gated-features/ghas-ghec.md @@ -1,3 +1,3 @@ -{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}.{% ifversion fpt or ghec %} Some features of {% data variables.product.prodname_GH_advanced_security %} are also available for public repositories on {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)."{% endif %} +{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %}.{% ifversion fpt or ghec %} Some features of {% data variables.product.prodname_GH_advanced_security %} are also available for public repositories on {% data variables.product.prodname_dotcom %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans).{% endif %} {% data reusables.advanced-security.ghas-for-azdo-link %} diff --git a/data/reusables/gated-features/ghas.md b/data/reusables/gated-features/ghas.md index a67b1d5c0776..25d238c4b0a3 100644 --- a/data/reusables/gated-features/ghas.md +++ b/data/reusables/gated-features/ghas.md @@ -1,3 +1,3 @@ -{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} Some features of {% data variables.product.prodname_GH_advanced_security %} are also available for public repositories on {% data variables.product.prodname_dotcom %}.{% endif %} For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +{% data variables.product.prodname_GH_advanced_security %} is available for enterprise accounts on {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} Some features of {% data variables.product.prodname_GH_advanced_security %} are also available for public repositories on {% data variables.product.prodname_dotcom %}.{% endif %} For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans). {% data reusables.advanced-security.ghas-for-azdo-link %} diff --git a/data/reusables/gated-features/more-info-org-products.md b/data/reusables/gated-features/more-info-org-products.md index 7913778d01c9..16baddaae07e 100644 --- a/data/reusables/gated-features/more-info-org-products.md +++ b/data/reusables/gated-features/more-info-org-products.md @@ -1 +1 @@ -{% ifversion fpt or ghec %}For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)."{% endif %} +{% ifversion fpt or ghec %}For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans).{% endif %} diff --git a/data/reusables/gated-features/more-info.md b/data/reusables/gated-features/more-info.md index 7913778d01c9..16baddaae07e 100644 --- a/data/reusables/gated-features/more-info.md +++ b/data/reusables/gated-features/more-info.md @@ -1 +1 @@ -{% ifversion fpt or ghec %}For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)."{% endif %} +{% ifversion fpt or ghec %}For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans).{% endif %} diff --git a/data/reusables/gated-features/packages.md b/data/reusables/gated-features/packages.md index b960a78e0974..f08328788cb3 100644 --- a/data/reusables/gated-features/packages.md +++ b/data/reusables/gated-features/packages.md @@ -1,6 +1,6 @@ {% ifversion fpt or ghec %} -{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %} 3.0 or higher.{% ifversion ghes %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see "[AUTOTITLE](/admin/overview/about-upgrades-to-new-releases)" and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} +{% data variables.product.prodname_registry %} is available with {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_free_team %} for organizations, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %} 3.0 or higher.{% ifversion ghes %} For more information about upgrading your {% data variables.product.prodname_ghe_server %} instance, see [AUTOTITLE](/admin/overview/about-upgrades-to-new-releases) and refer to the [{% data variables.enterprise.upgrade_assistant %}](https://support.github.com/enterprise/server-upgrade) to find the upgrade path from your current release version.{% endif %} {% ifversion fpt or ghec %} -
{% data variables.product.prodname_registry %} is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access registries that support granular permissions, because these accounts are billed by repository.{% ifversion ghec %} {% data variables.product.prodname_emus %} do not have individual storage allocation to publish packages within their account's namespace, but can publish to an organization's namespace. For additional information on {% data variables.product.prodname_emus %}, see "[AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users)."{% endif %} For the list of registries that support granular permissions, see "[AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#granular-permissions-for-userorganization-scoped-packages)." {% data reusables.gated-features.more-info %} +
{% data variables.product.prodname_registry %} is not available for private repositories owned by accounts using legacy per-repository plans. Also, accounts using legacy per-repository plans cannot access registries that support granular permissions, because these accounts are billed by repository.{% ifversion ghec %} {% data variables.product.prodname_emus %} do not have individual storage allocation to publish packages within their account's namespace, but can publish to an organization's namespace. For additional information on {% data variables.product.prodname_emus %}, see [AUTOTITLE](/admin/managing-iam/understanding-iam-for-enterprises/about-enterprise-managed-users).{% endif %} For the list of registries that support granular permissions, see [AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#granular-permissions-for-userorganization-scoped-packages). {% data reusables.gated-features.more-info %} {% endif %} {% endif %} diff --git a/data/reusables/gated-features/pages.md b/data/reusables/gated-features/pages.md index 94ceae037c62..7128d564baa5 100644 --- a/data/reusables/gated-features/pages.md +++ b/data/reusables/gated-features/pages.md @@ -1,3 +1,3 @@ {% data variables.product.prodname_pages %} is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}. {% ifversion fpt or ghec %}{% data reusables.gated-features.more-info %}{% endif %} -{% ifversion fpt or ghec %}{% data variables.product.prodname_pages %} now uses {% data variables.product.prodname_actions %} to execute the Jekyll build. When using a branch as the source of your build, {% data variables.product.prodname_actions %} must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if {% data variables.product.prodname_actions %} is unavailable or disabled, adding a `.nojekyll` file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository)."{% endif %} +{% ifversion fpt or ghec %}{% data variables.product.prodname_pages %} now uses {% data variables.product.prodname_actions %} to execute the Jekyll build. When using a branch as the source of your build, {% data variables.product.prodname_actions %} must be enabled in your repository if you want to use the built-in Jekyll workflow. Alternatively, if {% data variables.product.prodname_actions %} is unavailable or disabled, adding a `.nojekyll` file to the root of your source branch will bypass the Jekyll build process and deploy the content directly. For more information on enabling {% data variables.product.prodname_actions %}, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository).{% endif %} diff --git a/data/reusables/gated-features/repository-insights.md b/data/reusables/gated-features/repository-insights.md index d39ebe7079b1..b36679dc5c7d 100644 --- a/data/reusables/gated-features/repository-insights.md +++ b/data/reusables/gated-features/repository-insights.md @@ -1 +1 @@ -This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} For more information, see "[AUTOTITLE](/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs)" and "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)."{% endif %} +This repository insights graph is available in public repositories with {% data variables.product.prodname_free_user %} and {% data variables.product.prodname_free_team %} for organizations, and in public and private repositories with {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, {% data variables.product.prodname_ghe_cloud %}, and {% data variables.product.prodname_ghe_server %}.{% ifversion fpt or ghec %} For more information, see [AUTOTITLE](/repositories/viewing-activity-and-data-for-your-repository/about-repository-graphs) and [AUTOTITLE](/get-started/learning-about-github/githubs-plans).{% endif %} diff --git a/data/reusables/gated-features/restrict-email-domain.md b/data/reusables/gated-features/restrict-email-domain.md index eed0377b4282..b17d82c6c6e6 100644 --- a/data/reusables/gated-features/restrict-email-domain.md +++ b/data/reusables/gated-features/restrict-email-domain.md @@ -1 +1 @@ -Restriction of email notifications to approved or verified domains is available with {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +Restriction of email notifications to approved or verified domains is available with {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans). diff --git a/data/reusables/gated-features/verify-and-approve-domain.md b/data/reusables/gated-features/verify-and-approve-domain.md index 2c0ee90114a9..e7e05b554d64 100644 --- a/data/reusables/gated-features/verify-and-approve-domain.md +++ b/data/reusables/gated-features/verify-and-approve-domain.md @@ -1 +1 @@ -Verification and approval of domains is available with {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +Verification and approval of domains is available with {% data variables.product.prodname_ghe_cloud %} and {% data variables.product.prodname_ghe_server %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans).