diff --git a/.github/branch_protection_settings/main.json b/.github/branch_protection_settings/main.json index 39c2b0491e00..29e0c828d766 100644 --- a/.github/branch_protection_settings/main.json +++ b/.github/branch_protection_settings/main.json @@ -41,7 +41,10 @@ "workflows", "lint-code", "secret-scanning", - "pagelist" + "pagelist", + "docs-internal-docker-image / docs-internal-docker-image", + "docs-internal-docker-security / docs-internal-docker-security", + "docs-internal-moda-config-bundle / docs-internal-moda-config-bundle" ], "contexts_url": "https://api.github.com/repos/github/docs-internal/branches/main/protection/required_status_checks/contexts", "checks": [ @@ -85,7 +88,19 @@ { "context": "workflows", "app_id": 15368 }, { "context": "lint-code", "app_id": 15368 }, { "context": "secret-scanning", "app_id": 15368 }, - { "context": "pagelist", "app_id": 15368 } + { "context": "pagelist", "app_id": 15368 }, + { + "context": "docs-internal-docker-image / docs-internal-docker-image", + "app_id": 15368 + }, + { + "context": "docs-internal-docker-security / docs-internal-docker-security", + "app_id": 15368 + }, + { + "context": "docs-internal-moda-config-bundle / docs-internal-moda-config-bundle", + "app_id": 15368 + } ] }, "restrictions": { diff --git a/.github/workflows/azure-prod-build-deploy.yml b/.github/workflows/azure-prod-build-deploy.yml index 7e5e27bea77e..9a09b5f18599 100644 --- a/.github/workflows/azure-prod-build-deploy.yml +++ b/.github/workflows/azure-prod-build-deploy.yml @@ -5,9 +5,6 @@ name: Azure Production - Build and Deploy # **Who does it impact**: All contributors. on: - push: - branches: - - main workflow_dispatch: permissions: diff --git a/.github/workflows/codeowners-legal.yml b/.github/workflows/codeowners-legal.yml index ca9edb14b8b0..e783f5ad4321 100644 --- a/.github/workflows/codeowners-legal.yml +++ b/.github/workflows/codeowners-legal.yml @@ -20,6 +20,7 @@ on: permissions: contents: read pull-requests: write + repository-projects: read jobs: codeowners-legal: @@ -33,7 +34,7 @@ jobs: uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1 with: # Picking this number is a "best guess". If we make it too large, - # the checkout will take potentially unnecessariily long. + # the checkout will take potentially unnecessarily long. # This reduces the chance that tj-actions/changed-files has to # fetch deeper history. But if it needs to, it will. fetch-depth: 10 @@ -58,19 +59,14 @@ jobs: CHANGED_FILE_PATHS: ${{ steps.changed-files.outputs.all_changed_files }} CONTENT_TYPE: 'rai' - - name: Add Legal team as a reviewer + - name: Check for reviewers-legal label, add if missing and request review if: steps.checkContentType.outputs.containsContentType == 'true' env: - # The GH CLI uses a slightly different env name for - # the token than the GITHUB_TOKEN used by actions - GH_TOKEN: ${{ secrets.DOCS_BOT_PAT_WRITEORG_PROJECT }} + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} PR: ${{ github.event.pull_request.html_url }} run: | - has_reviewer=$( - gh pr view $PR --json reviews | - jq 'any(.reviews[]; select(length > 0))' - ) - if ! $has_reviewer - then + labels=$(gh pr view ${{ github.event.pull_request.number }} --json labels --jq '.labels[].name') + if ! echo "$labels" | grep -q 'reviewers-legal'; then gh pr edit $PR --add-reviewer github/legal-product + gh pr edit $PR --add-label reviewers-legal fi diff --git a/.github/workflows/purge-fastly.yml b/.github/workflows/purge-fastly.yml index b0415c6c44bd..aa02af6bf3e8 100644 --- a/.github/workflows/purge-fastly.yml +++ b/.github/workflows/purge-fastly.yml @@ -5,6 +5,7 @@ name: Purge Fastly # **Who does it impact**: Writers and engineers. on: + deployment_status: workflow_dispatch: inputs: nuke_all: @@ -16,9 +17,6 @@ on: description: "Comma separated languages. E.g. 'en,ja, es' (defaults to all)" required: false default: '' - push: - branches: - - main permissions: contents: read @@ -29,11 +27,12 @@ env: jobs: send-purges: + # Run when workflow_dispatch is the event (manual) or when deployment_status is the event (automatic) and it's a successful production deploy if: >- ${{ github.repository == 'github/docs-internal' && - (github.event_name != 'workflow_run' || - github.event.workflow_run.conclusion == 'success') + (github.event_name != 'deployment_status' || + github.event.deployment_status.state == 'success' && github.event.deployment_status.environment == 'production') }} runs-on: ubuntu-latest steps: diff --git a/config/kubernetes/production/deployments/webapp.yaml b/config/kubernetes/production/deployments/webapp.yaml index 35e49765e9d0..fc0bfb0feb54 100644 --- a/config/kubernetes/production/deployments/webapp.yaml +++ b/config/kubernetes/production/deployments/webapp.yaml @@ -23,10 +23,10 @@ spec: image: docs-internal resources: requests: - cpu: 4000m - memory: 5Gi + cpu: 8000m + memory: 10Gi limits: - cpu: 4000m + cpu: 16000m memory: 14Gi ports: - name: http diff --git a/config/moda/deployment.yaml b/config/moda/deployment.yaml index a8edafe09980..d77c5bb51341 100644 --- a/config/moda/deployment.yaml +++ b/config/moda/deployment.yaml @@ -1,13 +1,36 @@ -required_builds: - - docs-internal-moda-config-bundle / docs-internal-moda-config-bundle - - docs-internal-docker-image / docs-internal-docker-image - - docs-internal-docker-security / docs-internal-docker-security +# Deploy configuration reference: https://thehub.github.com/epd/engineering/products-and-services/internal/moda/reference/deployment-yaml/ + environments: - name: production - auto_deploy: true + require_pipeline: true cluster_selector: profile: general region: iad + +required_builds: + - docs-internal-moda-config-bundle / docs-internal-moda-config-bundle + - docs-internal-docker-image / docs-internal-docker-image + - docs-internal-docker-security / docs-internal-docker-security + +# Make the pipeline start automatically when a PR is enqueued +auto_start_pipeline: production_rollout + +pipelines: + production_rollout: + thread_notifications: true + notify_users_via_dm: false + timeout: 1200 + stages: + - name: full_production + kind: deployment + start_message: We are now going to deploy {{app}}/{{ref}}! Please pause or cancel the pipeline after the deploy if you want more time before auto-merging your pull request(s). + config: + environment: production + timeout: 1200 + # gates: + # - kind: timer + # duration: 1200 + notifications: slack_channels: - '#docs-ops' diff --git a/content/actions/administering-github-actions/usage-limits-billing-and-administration.md b/content/actions/administering-github-actions/usage-limits-billing-and-administration.md index b39687f11afd..cf36742d9775 100644 --- a/content/actions/administering-github-actions/usage-limits-billing-and-administration.md +++ b/content/actions/administering-github-actions/usage-limits-billing-and-administration.md @@ -45,7 +45,7 @@ There are some limits on {% data variables.product.prodname_actions %} usage whe * **Job execution time** - Each job in a workflow can run for up to 6 hours of execution time. If a job reaches this limit, the job is terminated and fails to complete. {% data reusables.actions.usage-workflow-run-time %} {% data reusables.actions.usage-api-requests %} -* **Webhook rate limit** - Each repository is limited to 1500 triggered events every 10 seconds. +* **Webhook rate limit** - Each repository is limited to 1500 events triggering a workflow run every 10 seconds. When the limit is reached, the workflow runs that were supposed to be triggered by the webhook events will be blocked and will not be queued. * **Concurrent jobs** - The number of concurrent jobs you can run in your account depends on your {% data variables.product.prodname_dotcom %} plan, as well as the type of runner used. If exceeded, any additional jobs are queued. **Standard {% data variables.product.prodname_dotcom %}-hosted runners** diff --git a/content/actions/hosting-your-own-runners/managing-self-hosted-runners/running-scripts-before-or-after-a-job.md b/content/actions/hosting-your-own-runners/managing-self-hosted-runners/running-scripts-before-or-after-a-job.md index 739fbb652f77..28fb850343eb 100644 --- a/content/actions/hosting-your-own-runners/managing-self-hosted-runners/running-scripts-before-or-after-a-job.md +++ b/content/actions/hosting-your-own-runners/managing-self-hosted-runners/running-scripts-before-or-after-a-job.md @@ -49,7 +49,8 @@ The scripts are automatically executed when the runner has the following environ * `ACTIONS_RUNNER_HOOK_JOB_STARTED`: The script defined in this environment variable is triggered when a job has been assigned to a runner, but before the job starts running. * `ACTIONS_RUNNER_HOOK_JOB_COMPLETED`: The script defined in this environment variable is triggered at the end of the job, after all the steps defined in the workflow have run. -To set these environment variables, you can either add them to the operating system, or add them to a file named `.env` within the self-hosted runner application directory (that is, the directory into which you downloaded and unpacked the runner software). For example, the following `.env` entry will have the runner automatically run a script, saved as `/opt/runner/cleanup_script.sh` on the runner machine, before each job runs: +To set these environment variables, you can either add them to the operating system, or add them to a file named `.env` within the self-hosted runner application directory (that is, the directory into which you downloaded and unpacked the runner software). Note that any change to the `.env` file will require restarting the runner. +For example, the following `.env` entry will have the runner automatically run a script, saved as `/opt/runner/cleanup_script.sh` on the runner machine, before each job runs: ```bash ACTIONS_RUNNER_HOOK_JOB_STARTED=/opt/runner/cleanup_script.sh diff --git a/content/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow.md b/content/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow.md index 3416f054f945..4cbdecc86572 100644 --- a/content/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow.md +++ b/content/actions/hosting-your-own-runners/managing-self-hosted-runners/using-self-hosted-runners-in-a-workflow.md @@ -17,7 +17,7 @@ shortTitle: Use runners in a workflow You can target self-hosted runners for use in a workflow based on the labels assigned to the runners{% ifversion target-runner-groups %}, or their group membership, or a combination of these{% endif %}. ->[!NOTE]Actions Runner Controller does not support multiple labels, only the name of the runner can be used in place of a label +>[!IMPORTANT]Runner Scale Sets do not support multiple labels, only the name of the runner can be used in place of a label. See [AUTOTITLE](/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller). ## About self-hosted runner labels @@ -109,9 +109,9 @@ These labels operate cumulatively, so a self-hosted runner must have all four la ## Routing precedence for self-hosted runners -When routing a job to a self-hosted runner, {% data variables.product.prodname_dotcom %} looks for a runner that matches the job's `runs-on` labels{% ifversion target-runner-groups %} and/or groups{% endif %}: +When routing a job to a self-hosted runner, {% data variables.product.prodname_dotcom %} looks for a runner that matches the job's `runs-on` labels{% ifversion target-runner-groups %} and groups{% endif %}: -* If {% data variables.product.prodname_dotcom %} finds an online and idle runner that matches the job's `runs-on` labels{% ifversion target-runner-groups %} and/or groups{% endif %}, the job is then assigned and sent to the runner. +* If {% data variables.product.prodname_dotcom %} finds an online and idle runner that matches the job's `runs-on` labels{% ifversion target-runner-groups %} and groups{% endif %}, the job is then assigned and sent to the runner. * If the runner doesn't pick up the assigned job within 60 seconds, the job is re-queued so that a new runner can accept it. -* If {% data variables.product.prodname_dotcom %} doesn't find an online and idle runner that matches the job's `runs-on` labels {% ifversion target-runner-groups %} and/or groups{% endif %}, then the job will remain queued until a runner comes online. +* If {% data variables.product.prodname_dotcom %} doesn't find an online and idle runner that matches the job's `runs-on` labels {% ifversion target-runner-groups %} and groups{% endif %}, then the job will remain queued until a runner comes online. * If the job remains queued for more than 24 hours, the job will fail. diff --git a/content/actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform.md b/content/actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform.md index 9839084bd93a..cbf49af87bdc 100644 --- a/content/actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform.md +++ b/content/actions/security-for-github-actions/security-hardening-your-deployments/configuring-openid-connect-in-google-cloud-platform.md @@ -29,6 +29,16 @@ This guide gives an overview of how to configure GCP to trust {% data variables. {% data reusables.actions.oidc-on-ghecom %} +{% ifversion ghes %} +{% data reusables.actions.oidc-endpoints %} + + + > [!NOTE] + > Google Cloud Platform does not have fixed IP ranges defined for these endpoints. + +* Make sure that the value of the issuer claim that's included with the JSON Web Token (JWT) is set to a publicly routable URL. For more information, see [AUTOTITLE](/enterprise-server@latest/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect). +{% endif %} + ## Adding a Google Cloud Workload Identity Provider To configure the OIDC identity provider in GCP, you will need to perform the following configuration. For instructions on making these changes, refer to [the GCP documentation](https://github.com/google-github-actions/auth). diff --git a/content/actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven.md b/content/actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven.md index 13230c3a7323..4cd3b9aeccab 100644 --- a/content/actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven.md +++ b/content/actions/use-cases-and-examples/building-and-testing/building-and-testing-java-with-maven.md @@ -117,7 +117,7 @@ You can cache your dependencies to speed up your workflow runs. After a successf ```yaml copy steps: - uses: {% data reusables.actions.action-checkout %} - - name: Set up JDK 11 + - name: Set up JDK 17 uses: {% data reusables.actions.action-setup-java %} with: java-version: '17' diff --git a/content/actions/writing-workflows/quickstart.md b/content/actions/writing-workflows/quickstart.md index c5e0b1706ecb..22072df36d2e 100644 --- a/content/actions/writing-workflows/quickstart.md +++ b/content/actions/writing-workflows/quickstart.md @@ -5,6 +5,7 @@ allowTitleToDifferFromFilename: true redirect_from: - /actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates - /actions/quickstart + - /actions/getting-started-with-github-actions versions: fpt: '*' ghes: '*' diff --git a/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md b/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md index f888091172dc..1ad086136291 100644 --- a/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md +++ b/content/admin/data-residency/about-github-enterprise-cloud-with-data-residency.md @@ -14,7 +14,7 @@ redirect_from: By default, {% data variables.product.company_short %} stores data for {% data variables.product.prodname_dotcom_the_website %} in the USA. {% data reusables.data-residency.when-you-adopt-data-residency %} To learn how {% data variables.product.company_short %} handles data storage, see [AUTOTITLE](/admin/data-residency/about-storage-of-your-data-with-data-residency). -Access to this feature is currently managed by {% data variables.contact.contact_enterprise_sales %}. +To get {% data variables.enterprise.data_residency_short %} for your enterprise, **contact {% data variables.contact.contact_sales_data_residency %}**. ## What is {% data variables.product.product_name %}? @@ -107,7 +107,7 @@ When reading the documentation, readers may need to substitute references to {% ## Getting started -When you have worked with your account team in {% data variables.contact.contact_enterprise_sales %} to create a new enterprise account and choose a subdomain on {% data variables.enterprise.data_residency_site %}, you can get started with your new enterprise. +When you have worked with your account team to create a new enterprise account and choose a subdomain on {% data variables.enterprise.data_residency_site %}, you can get started with your new enterprise. You will: diff --git a/content/admin/data-residency/about-storage-of-your-data-with-data-residency.md b/content/admin/data-residency/about-storage-of-your-data-with-data-residency.md index 55cabec355da..18fbea1006d2 100644 --- a/content/admin/data-residency/about-storage-of-your-data-with-data-residency.md +++ b/content/admin/data-residency/about-storage-of-your-data-with-data-residency.md @@ -16,7 +16,7 @@ redirect_from: Although your code and user data are stored within your chosen region, {% data variables.product.company_short %} may store certain types of data outside your region, and may need to transfer some data outside your region. -If you are in doubt about any aspect of {% data variables.enterprise.data_residency_short %}, contact your account manager in {% data variables.contact.contact_enterprise_sales %}. +If you are in doubt about any aspect of {% data variables.enterprise.data_residency_short %}, contact your account manager. ## Data stored in your region diff --git a/content/admin/data-residency/getting-started-with-data-residency-for-github-enterprise-cloud.md b/content/admin/data-residency/getting-started-with-data-residency-for-github-enterprise-cloud.md index 8378b7465145..f84cea879251 100644 --- a/content/admin/data-residency/getting-started-with-data-residency-for-github-enterprise-cloud.md +++ b/content/admin/data-residency/getting-started-with-data-residency-for-github-enterprise-cloud.md @@ -17,7 +17,7 @@ redirect_from: When you adopt {% data variables.enterprise.data_residency %}, you can choose where your company's code and data are stored. -After you have **worked with {% data variables.contact.contact_enterprise_sales %}** to create an enterprise account with a dedicated URL on {% data variables.enterprise.data_residency_site %}, you'll use this guide to set up your enterprise. You will: +After you have **worked with {% data variables.contact.contact_sales_data_residency %}** to create an enterprise account with a dedicated URL on {% data variables.enterprise.data_residency_site %}, you'll use this guide to set up your enterprise. You will: * Add users by configuring authentication and provisioning with an identity management system * Set up billing for your enterprise diff --git a/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md b/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md index c357b7736a1d..73c2a95c5e58 100644 --- a/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md +++ b/content/admin/overview/setting-up-a-trial-of-github-enterprise-cloud.md @@ -18,10 +18,10 @@ shortTitle: Enterprise Cloud trial You can set up a trial to evaluate the additional features that come with {% data variables.product.prodname_ghe_cloud %}, such as SAML single sign-on (SSO), internal repositories, and audit log streaming. For a list of available features, see our [Pricing](https://github.com/pricing) page. -Your trial **won't** include {% data variables.enterprise.data_residency_short %} on {% data variables.enterprise.data_residency_site %} or access to {% data variables.product.prodname_ghe_server %}. To test these features, contact {% data variables.contact.contact_enterprise_sales %}. - Set up a trial of {% data variables.product.prodname_ghe_cloud %} {% octicon "link-external" height:16 %} +>[!IMPORTANT] Your trial enterprise will be hosted in the USA. If you require {% data variables.enterprise.data_residency_short %} outside the USA, contact {% data variables.contact.contact_sales_data_residency %}. + To set up a trial, you must be signed in to a personal account. If you don't have a personal account, see [AUTOTITLE](/free-pro-team@latest/get-started/start-your-journey/creating-an-account-on-github). You do not need to provide a payment method during the trial. diff --git a/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md b/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md index d008ecb45603..63e32f7fe85c 100644 --- a/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md +++ b/content/authentication/keeping-your-account-and-data-secure/about-authentication-to-github.md @@ -55,7 +55,7 @@ If you need to use multiple accounts on {% data variables.location.product_locat * If you enable 2FA, after you successfully enter your username and password, we'll also prompt you to provide a code that's generated by a time-based one time password (TOTP) application on your mobile device{% ifversion fpt or ghec %} or sent as a text message (SMS).{% endif %}{% ifversion 2fa-check-up-period %} * After you configure 2FA, your account enters a check up period for 28 days. You can leave the check up period by successfully performing 2FA within those 28 days. If you don't perform 2FA in that timespan, you'll then be asked to perform 2FA inside one of your existing {% data variables.product.prodname_dotcom %} sessions. * If you cannot perform 2FA to pass the 28th day checkup, you will be provided a shortcut that lets you reconfigure your 2FA settings. You must reconfigure your settings before you can access the rest of {% data variables.product.prodname_dotcom %}{% endif %}. For more information, see [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/accessing-github-using-two-factor-authentication#providing-a-2fa-code-when-signing-in-to-the-website){% ifversion 2fa-check-up-period %} and [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication){% endif %}. - * In addition to authentication with a TOTP application{% ifversion fpt or ghec %} or a text message{% endif %}, you can optionally add an alternative method of authentication with {% ifversion fpt or ghec %}{% data variables.product.prodname_mobile %} or{% endif %} a security key using WebAuthn. For more information, see {% ifversion fpt or ghec %}[AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) and {% endif %}[AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key). + * In addition to authentication with a TOTP application{% ifversion fpt or ghec %} or a text message{% endif %}, you can optionally add an alternative method of authentication with {% ifversion fpt or ghec %}{% data variables.product.prodname_mobile %} or{% endif %} a security key using WebAuthn. See {% ifversion fpt or ghec %}[Configuring two-factor authentication using {% data variables.product.prodname_mobile %}](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-github-mobile) or {% endif %}[Configuring two-factor authentication using a security key](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication#configuring-two-factor-authentication-using-a-security-key). {% ifversion fpt or ghec %} diff --git a/content/code-security/codeql-for-vs-code/using-the-advanced-functionality-of-the-codeql-for-vs-code-extension/telemetry-in-codeql-for-visual-studio-code.md b/content/code-security/codeql-for-vs-code/using-the-advanced-functionality-of-the-codeql-for-vs-code-extension/telemetry-in-codeql-for-visual-studio-code.md index 9dd459694a6f..cbbc3d4635d0 100644 --- a/content/code-security/codeql-for-vs-code/using-the-advanced-functionality-of-the-codeql-for-vs-code-extension/telemetry-in-codeql-for-visual-studio-code.md +++ b/content/code-security/codeql-for-vs-code/using-the-advanced-functionality-of-the-codeql-for-vs-code-extension/telemetry-in-codeql-for-visual-studio-code.md @@ -11,7 +11,7 @@ topics: - CodeQL type: reference allowTitleToDifferFromFilename: true -intro: 'If you specifically opt in to permit {% data variables.product.company_short %} to do so, {% data variables.product.company_short %} will collect usage data and metrics for the purposes of helping the core developers to improve the {% data variables.product.prodname_codeql %} extension for {% data variables.product.prodname_vscode_shortname %}.' +intro: 'If {% data variables.product.prodname_vscode_shortname %} telemetry is enabled, {% data variables.product.company_short %} will collect usage data and metrics for the purposes of helping the core developers to improve the {% data variables.product.prodname_codeql %} extension for {% data variables.product.prodname_vscode_shortname %}.' redirect_from: - /code-security/codeql-for-vs-code/about-telemetry-in-codeql-for-visual-studio-code --- @@ -19,7 +19,7 @@ redirect_from: This data will not be shared with any parties outside of {% data variables.product.company_short %}. IP addresses and installation IDs will be retained for a maximum of 30 days. Anonymous data will be retained for a maximum of 180 days. > [!NOTE] -> Telemetry collection is disabled by default in {% data variables.product.prodname_codeql %} for {% data variables.product.prodname_vscode %}. When telemetry collection is disabled, no data will be sent to {% data variables.product.company_short %} servers. +> Telemetry collection in {% data variables.product.prodname_codeql %} for {% data variables.product.prodname_vscode %} follows the {% data variables.product.prodname_vscode_shortname %} telemetry settings. When telemetry collection is disabled, no data will be sent to {% data variables.product.company_short %} servers. ## Why we collect data @@ -27,7 +27,7 @@ This data will not be shared with any parties outside of {% data variables.produ ## What data is collected -If you opt in, {% data variables.product.company_short %} collects the following information related to the usage of the extension. The data collected are: +If telemetry is enabled, {% data variables.product.company_short %} collects the following information related to the usage of the extension. The data collected are: * The identifiers of any {% data variables.product.prodname_codeql %}-related {% data variables.product.prodname_vscode_shortname %} commands that are run. For each command, these are: the timestamp, time taken, and whether or not the command completed successfully. @@ -69,9 +69,7 @@ We only collect the minimal amount of data we need to answer the questions about ## Disabling telemetry reporting -You can disable telemetry collection by setting `codeQL.telemetry.enableTelemetry` to `false` in your settings. For more information, see [AUTOTITLE](/code-security/codeql-for-vs-code/using-the-advanced-functionality-of-the-codeql-for-vs-code-extension/customizing-settings). - -Additionally, telemetry collection will be disabled if the global `telemetry.telemetryLevel` setting is set to `off`. For more information about global telemetry collection, see [Visual Studio Code FAQ](https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting) in the {% data variables.product.prodname_vscode %} documentation. +You can disable telemetry collection by setting the global `telemetry.telemetryLevel` setting to `off`. For more information, see the [Visual Studio Code Telemetry page](https://code.visualstudio.com/docs/getstarted/telemetry) in the {% data variables.product.prodname_vscode %} documentation. ## Further reading diff --git a/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md b/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md index 854d068e81aa..2b31ed7892f7 100644 --- a/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md +++ b/content/code-security/dependabot/working-with-dependabot/dependabot-options-reference.md @@ -267,7 +267,7 @@ When `ignore` is used {% data variables.product.prodname_dependabot %} uses the |------------|---------| | `dependency-name` | Ignore updates for dependencies with matching names, optionally using `*` to match zero or more characters. | | `versions` | Ignore specific versions or ranges of versions. | -| `update-types` | Ignore updates to one or more semantic versioning levels. Supported values: `sem-ver:minor`, `sem-ver:patch`, and `sem-ver:major`. | +| `update-types` | Ignore updates to one or more semantic versioning levels. Supported values: `version-update:semver-minor`, `version-update:semver-patch`, and `version-update:semver-major`. | ### `dependency-name` (`ignore`) diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md index b226acb324c5..c544aa66399e 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github.md @@ -17,15 +17,17 @@ Before you configure your {% data variables.product.prodname_copilot_agent_short ## Verifying that payloads are coming from {% data variables.product.github %} -Before your {% data variables.product.prodname_copilot_agent_short %} begins processing a request, you should verify that the request came from {% data variables.product.github %}, and that it is intended for your agent. All agent requests contain the `Github-Public-Key-Identifier` and `Github-Public-Key-Signature` headers. To verify the signature for a particular request, compare the signature in the `Github-Public-Key-Signature` header with a signed copy of the request body using the current public key listed at https://api.github.com/meta/public_keys/copilot_api. +Before your {% data variables.product.prodname_copilot_agent_short %} begins processing a request, you should verify that the request came from {% data variables.product.github %}, and that it is intended for your agent. All agent requests contain the `X-GitHub-Public-Key-Identifier` and `X-GitHub-Public-Key-Signature` headers. To verify the signature for a particular request, compare the signature in the `X-GitHub-Public-Key-Signature` header with a signed copy of the request body using the current public key listed at https://api.github.com/meta/public_keys/copilot_api. For more details and examples of signature verification in specific languages, see the [`github-technology-partners/signature-verification`](https://github.com/github-technology-partners/signature-verification) repository. +> ⚠️ **Note:** We currently send duplicate pairs of these headers. One set has the prefix `Github-Public-...`; the other has `X-GitHub-Public...`. The former will be {% data variables.release-phases.closing_down %} **by March 31st**. Please update your relevant checks to the correct prefix (`X-GitHub-Public...`) by then. + ## Fetching resources from the {% data variables.product.github %} API -Requests to your {% data variables.product.prodname_copilot_agent_short %} will receive an `X-Github-Token` header. This header contains an API token that can be used to fetch resources from the {% data variables.product.github %} API on behalf of the user interacting with your agent. The permissions of this token are the overlap of the user's own permissions and the permissions granted to your {% data variables.product.prodname_github_app %} installation. +Requests to your {% data variables.product.prodname_copilot_agent_short %} will receive an `X-GitHub-Token` header. This header contains an API token that can be used to fetch resources from the {% data variables.product.github %} API on behalf of the user interacting with your agent. The permissions of this token are the overlap of the user's own permissions and the permissions granted to your {% data variables.product.prodname_github_app %} installation. -For an example of how you might use `X-Github-Token`, see the following code sample: +For an example of how you might use `X-GitHub-Token`, see the following code sample: ```typescript async function whoami(req) { diff --git a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md index 097b74fc2677..fc9035ed9e15 100644 --- a/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md +++ b/content/copilot/building-copilot-extensions/building-a-copilot-skillset-for-your-copilot-extension/building-copilot-skillsets.md @@ -5,7 +5,7 @@ versions: feature: copilot-extensions topics: - Copilot -shortTitle: Build {% data variables.product.prodname_copilot_skillsets_short %} +shortTitle: Build {% data variables.product.prodname_copilot_skillsets_short %} type: how_to --- @@ -25,7 +25,7 @@ Before you begin, make sure you have the following: * Be able to verify the signature of requests from {% data variables.product.github %} to authenticate their origin and prevent unauthorized access * Be publicly accessible via HTTPS -For more information about signature verification, see [Verifying that payloads are coming from Github](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github#verifying-that-payloads-are-coming-from-github). +For more information about signature verification, see [Verifying that payloads are coming from {% data variables.product.github %}](/copilot/building-copilot-extensions/building-a-copilot-agent-for-your-copilot-extension/configuring-your-copilot-agent-to-communicate-with-github#verifying-that-payloads-are-coming-from-github). ## Configuration requirements diff --git a/content/copilot/index.md b/content/copilot/index.md index 02a950857d96..af2527d18645 100644 --- a/content/copilot/index.md +++ b/content/copilot/index.md @@ -30,6 +30,7 @@ children: - /using-github-copilot - /example-prompts-for-github-copilot-chat - /managing-copilot + - /rolling-out-github-copilot-at-scale - /customizing-copilot - /building-copilot-extensions - /troubleshooting-github-copilot diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/index.md b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/index.md index cb4aaf7bfb49..319f8b7e59e8 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/index.md +++ b/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/index.md @@ -9,5 +9,4 @@ topics: children: - /reviewing-user-activity-data-for-copilot-in-your-organization - /reviewing-audit-logs-for-copilot-business - - /analyzing-usage-over-time-with-the-copilot-metrics-api --- diff --git a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/analyzing-usage-over-time-with-the-copilot-metrics-api.md b/content/copilot/rolling-out-github-copilot-at-scale/analyzing-usage-over-time-with-the-copilot-metrics-api.md similarity index 98% rename from content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/analyzing-usage-over-time-with-the-copilot-metrics-api.md rename to content/copilot/rolling-out-github-copilot-at-scale/analyzing-usage-over-time-with-the-copilot-metrics-api.md index d9cbf05e1bea..fc1a7e7cfb6b 100644 --- a/content/copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/analyzing-usage-over-time-with-the-copilot-metrics-api.md +++ b/content/copilot/rolling-out-github-copilot-at-scale/analyzing-usage-over-time-with-the-copilot-metrics-api.md @@ -5,6 +5,8 @@ intro: 'Learn how to connect to the API, store data, and analyze usage trends.' versions: feature: copilot product: '{% data variables.product.prodname_copilot_for_business %} or {% data variables.product.prodname_copilot_enterprise %}' +redirect_from: + - /copilot/managing-copilot/managing-github-copilot-in-your-organization/reviewing-activity-related-to-github-copilot-in-your-organization/analyzing-usage-over-time-with-the-copilot-metrics-api permissions: 'Organization owners, enterprise owners, and billing managers' layout: inline topics: diff --git a/content/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company.md b/content/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company.md new file mode 100644 index 000000000000..7a0093269063 --- /dev/null +++ b/content/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company.md @@ -0,0 +1,90 @@ +--- +title: Driving Copilot adoption in your company +shortTitle: Drive Copilot adoption +intro: 'Learn how to plan an effective enablement process to drive Copilot adoption.' +versions: + feature: copilot +topics: + - Copilot +--- + +An effective enablement process is essential to drive adoption of {% data variables.product.prodname_copilot_short %} in your organization. This process should be tailored to your organization's needs and goals, and should be designed to help your teams understand how to use {% data variables.product.prodname_copilot_short %} effectively. + +Your enablement process may evolve based on feedback and results. You should regularly review and update the process to ensure it continues to meet your organization's needs. + +The {% data variables.product.prodname_copilot %} enablement process can be broken down into the following stages: + +* Granting licenses +* Supporting users setting up their environment +* Supporting effective use of {% data variables.product.prodname_copilot_short %} + +## Prerequisites + +* {% data variables.product.prodname_copilot %} must be set up in your {% ifversion ghec %}enterprise and {% endif %}organization. For more information, see {% ifversion ghec %}[AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise) and {% endif %}[AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization). + +## Granting licenses + +Before you can drive adoption of {% data variables.product.prodname_copilot %}, you need to ensure that your teams have access to the product. For more information, see [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-access-to-github-copilot-in-your-organization/granting-access-to-copilot-for-members-of-your-organization). + +Depending on the size of your organization, you may want to start with a small pilot program. This will allow you to test your enablement process and make any necessary adjustments before rolling it out to the rest of your organization. + +You can start by identifying a small number of teams that are interested in using {% data variables.product.prodname_copilot_short %}. You can then work with these teams to help them get started with {% data variables.product.prodname_copilot_short %}. + +## Supporting users setting up their environment + +Once your teams have access to {% data variables.product.prodname_copilot %}, ensure they're confident with setting up their environment. {% data variables.product.github %} provides comprehensive documentation to help users set up their environment and resolve common issues. See [AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself) and [AUTOTITLE](/copilot/troubleshooting-github-copilot). + +If your company uses a corporate proxy or firewall, there are additional steps for ensuring users can connect to {% data variables.product.prodname_copilot %}: + +* Ensure that key URLs are added to the allowlist for the proxy server or firewall. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/configuring-your-proxy-server-or-firewall-for-copilot). +* Provide guidance for your users to set up their environment to connect via your proxy. You may also need to install custom SSL certificates on your users' machines. See [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/configuring-network-settings-for-github-copilot). + +For more complex issues, you may also choose to designate an internal point of contact to help users resolve issues, or escalate them to {% data variables.contact.github_support %}. You should choose a point of contact who is confident troubleshooting firewall and network configuration issues. + +## Supporting effective use of {% data variables.product.prodname_copilot_short %} in your organization + +This section offers examples of how you can support effective use of {% data variables.product.prodname_copilot_short %}. You can use these examples as a starting point and adapt them to meet your organization's needs and goals. + +### Creating onboarding resources + +You may choose to create internal onboarding materials to help teams get started with {% data variables.product.prodname_copilot_short %}. These materials could include your organization's policies and guidelines for using {% data variables.product.prodname_copilot_short %}, {% data variables.product.github %} documentation, relevant {% data variables.product.github %} blog posts, and any other resources that you think will be helpful. + +{% data variables.product.github %} documentation that you may want to feature in your onboarding materials includes: + +* [AUTOTITLE](/copilot/using-github-copilot/best-practices-for-using-github-copilot) +* [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot) +* [AUTOTITLE](/copilot/using-github-copilot/getting-code-suggestions-in-your-ide-with-github-copilot) +* [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide) + +You can also create a {% data variables.product.github %} repository to store these materials, and encourage teams to contribute their own resources and best practices. This can help foster a sense of community among teams that are using {% data variables.product.prodname_copilot_short %}, and make it easier for new teams to get started. + +### Working with your pilot program + +Once the users in your pilot program have used your onboarding resources, you will have an initial opportunity for feedback, to see whether there are any sticking points that should be resolved before rolling out {% data variables.product.prodname_copilot_short %} on a larger scale. + +One way to gather feedback is with a survey. You can use the {% data variables.product.prodname_copilot_short %} survey engine to create an app that will trigger a survey at specific points in the {% data variables.product.prodname_copilot_short %} experience. See the [{% data variables.product.prodname_copilot_short %} survey engine](https://github.com/github/copilot-survey-engine). + +### Offering training and support + +From your pilot program, you can identify a group of {% data variables.product.prodname_copilot_short %} champions who are enthusiastic about using {% data variables.product.prodname_copilot_short %} and are willing to help others get started. You can work with these champions to create training sessions, workshops, and other resources to help teams get started with {% data variables.product.prodname_copilot_short %}. + +You can also use {% data variables.product.prodname_discussions %} to create a space where teams can ask questions, share best practices, and learn from each other. This can help foster a sense of community among teams that are using {% data variables.product.prodname_copilot_short %}, and make it easier for new teams to get started. + +{% data variables.product.github %} also provides a dedicated {% data variables.product.prodname_copilot_short %} Workshops repository, which contains a selection of workshops designed to help teams learn how to use {% data variables.product.prodname_copilot_short %} effectively. See [Copilot Workshops](https://github.com/copilot-workshops). + +### Providing learning resources + +In addition to your onboarding resources, you may want to provide a library of learning resources to help teams advance their skills with {% data variables.product.prodname_copilot_short %}. The {% data variables.product.prodname_copilot_chat_short %} Cookbook is a great place to start. The Cookbook is a collection of example prompts that you can use to learn how to ask {% data variables.product.prodname_copilot_short %} for help with a wide range of tasks. See [AUTOTITLE](/copilot/example-prompts-for-github-copilot-chat). + +### Communicating expectations + +If your organization has specific {% data variables.product.prodname_copilot_short %} usage guidelines, these should be clearly communicated in onboarding materials and anywhere else that teams might look for information. For example, if you plan to revoke access to {% data variables.product.prodname_copilot_short %} for users who have not used it in a certain period of time, ensure that your users are aware of this policy. + +### Ongoing analysis and optimization + +Once you have implemented your {% data variables.product.prodname_copilot_short %} enablement process, you should regularly review and optimize it to ensure it continues to meet your organization's needs. Some ways you can do this are: + +* Monitoring usage data to identify trends and patterns. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/analyzing-usage-over-time-with-the-copilot-metrics-api). +* Following up with users who haven't been using their assigned license. You can use the API to see the latest activity date for each assigned seat. See [AUTOTITLE](/rest/copilot/copilot-user-management#list-all-copilot-seat-assignments-for-an-organization). +* Gathering feedback from teams to understand what is working well and what could be improved +* Reviewing {% data variables.product.prodname_discussions %} and other communication channels to identify common issues and questions diff --git a/content/copilot/rolling-out-github-copilot-at-scale/index.md b/content/copilot/rolling-out-github-copilot-at-scale/index.md new file mode 100644 index 000000000000..c00a2a386dbb --- /dev/null +++ b/content/copilot/rolling-out-github-copilot-at-scale/index.md @@ -0,0 +1,12 @@ +--- +title: Rolling out GitHub Copilot at scale +shortTitle: Roll out Copilot at scale +intro: 'Learn how to manage a Copilot rollout in your organization or enterprise.' +versions: + feature: copilot +topics: + - Copilot +children: + - /driving-copilot-adoption-in-your-company + - /analyzing-usage-over-time-with-the-copilot-metrics-api +--- diff --git a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md index f6d4545ac627..dacb7c244e3a 100644 --- a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md +++ b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-enterprise.md @@ -34,8 +34,6 @@ Enable {% data variables.product.prodname_copilot_short %} for some or all organ If your enterprise is on {% data variables.enterprise.data_residency_site %}, users must perform some additional setup to authenticate to their account from their development environment. See [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/using-github-copilot-with-an-account-on-ghecom). -## 5. Share onboarding material +## 5. Drive {% data variables.product.prodname_copilot_short %} adoption -* **Share onboarding material:** Share onboarding material with each organization that you granted {% data variables.product.prodname_copilot_short %} access to. See [AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization). -* **Encourage adoption:** Encouragement from leadership can help drive adoption of {% data variables.product.prodname_copilot_short %} in your enterprise. Consider messaging your support of {% data variables.product.prodname_copilot_short %} and how it can help your enterprise. -* **Set up training sessions or workshops:** Training sessions or workshops can help members learn how to use {% data variables.product.prodname_copilot_short %} effectively. +Planning and implementing an effective enablement process is essential to drive adoption of {% data variables.product.prodname_copilot_short %} in your enterprise. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company). diff --git a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md index 0cf641815700..3c304b2552ee 100644 --- a/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md +++ b/content/copilot/setting-up-github-copilot/setting-up-github-copilot-for-your-organization.md @@ -41,11 +41,9 @@ Alternatively, you can set up a self-serve workflow using the API. See [Add team If your organization is part of an enterprise on {% data variables.enterprise.data_residency_site %}, users must perform some additional setup to authenticate to their account from their development environment. See [AUTOTITLE](/copilot/managing-copilot/configure-personal-settings/using-github-copilot-with-an-account-on-ghecom). -## 5. Share onboarding material +## 5. Drive {% data variables.product.prodname_copilot_short %} adoption -* **Share onboarding material:** Share onboarding material with each member that you granted {% data variables.product.prodname_copilot_short %} access to. See [AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself) and [AUTOTITLE](/copilot/using-github-copilot/best-practices-for-using-github-copilot). -* **Encourage adoption:** Encouragement from leadership can help drive adoption of {% data variables.product.prodname_copilot_short %} in your organization. Consider messaging your support of {% data variables.product.prodname_copilot_short %} and how it can help your organization. -* **Set up training sessions or workshops:** Training sessions or workshops can help members learn how to use {% data variables.product.prodname_copilot_short %} effectively. +Planning and implementing an effective enablement process is essential to drive adoption of {% data variables.product.prodname_copilot_short %} in your organization. See [AUTOTITLE](/copilot/rolling-out-github-copilot-at-scale/driving-copilot-adoption-in-your-company). ## 6. Enhance the {% data variables.product.prodname_copilot_short %} experience @@ -54,13 +52,3 @@ Enhance the {% data variables.product.prodname_copilot_short %} experience for y * **Setting up knowledge bases** for use with {% data variables.product.prodname_copilot_chat_short %} _({% data variables.product.prodname_copilot_enterprise_short %} only)_. See [AUTOTITLE](/enterprise-cloud@latest/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/managing-copilot-knowledge-bases). * **Fine tuning {% data variables.product.prodname_copilot_short %}** by creating a custom large language model. See [AUTOTITLE](/copilot/customizing-copilot/creating-a-custom-model-for-github-copilot). * **Installing {% data variables.product.prodname_copilot_extensions_short %}** to integrate other tools with {% data variables.product.prodname_copilot_chat_short %}. See [AUTOTITLE](/copilot/managing-copilot/managing-github-copilot-in-your-organization/managing-github-copilot-features-in-your-organization/installing-github-copilot-extensions-for-your-organization). - -## 7. Drive adoption - -To help your organization get the most out of {% data variables.product.prodname_copilot_short %}, reach out to users who have not used {% data variables.product.prodname_copilot_short %} recently. (You can use the API to identify users who have not used {% data variables.product.prodname_copilot_short %} recently.) To help those users, consider: - -* Sharing resources to help them get started, such as [AUTOTITLE](/copilot/setting-up-github-copilot/setting-up-github-copilot-for-yourself), [AUTOTITLE](/copilot/using-github-copilot/best-practices-for-using-github-copilot), and [AUTOTITLE](/copilot/using-github-copilot/prompt-engineering-for-github-copilot) -* Learning about their barriers to using {% data variables.product.prodname_copilot_short %} -* Addressing any concerns they have about using {% data variables.product.prodname_copilot_short %} -* Giving them ideas for how to incorporate {% data variables.product.prodname_copilot_short %} into their work -* Pairing them with a mentor who can help them understand how to take advantage of {% data variables.product.prodname_copilot_short %} diff --git a/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md b/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md index 231ca6bf6dd9..0ee52bf715db 100644 --- a/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md +++ b/content/copilot/using-github-copilot/using-claude-sonnet-in-github-copilot.md @@ -53,3 +53,7 @@ For details of how to change the model for {% data variables.product.prodname_co * [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-githubcom#changing-your-ai-model) * [AUTOTITLE](/copilot/using-github-copilot/asking-github-copilot-questions-in-your-ide#changing-your-ai-model) + +## Leaving feedback + +To leave feedback about Claude 3.5 Sonnet in {% data variables.product.prodname_copilot %}, or to ask a question, see the {% data variables.product.prodname_github_community %} discussion "[Claude 3.5 Sonnet is now available to all {% data variables.product.prodname_copilot_short %} users in Public Preview](https://github.com/orgs/community/discussions/143337)." diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md index 6ae903404090..248b788a8cab 100644 --- a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/index.md @@ -14,5 +14,6 @@ children: - /creating-gists - /forking-and-cloning-gists - /saving-gists-with-stars + - /moderating-gist-comments shortTitle: Share content with gists --- diff --git a/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md new file mode 100644 index 000000000000..1e2a3df5c860 --- /dev/null +++ b/content/get-started/writing-on-github/editing-and-sharing-content-with-gists/moderating-gist-comments.md @@ -0,0 +1,24 @@ +--- +title: Moderating gist comments +intro: 'You can moderate comments on gists by turning them off or deleting unwanted entries.' +versions: + fpt: '*' + ghes: '>=3.17' + ghec: '*' +--- +## Disabling comments + +You can hide existing comments and prevent new comments from being added to a gist by disabling comments for the gist. You can re-enable comments at any time. This will make existing comments visible. + +1. Navigate to {% data variables.gists.gist_user %} and select the gist you want to moderate. +1. In the top right corner, select **{% octicon "pencil" aria-hidden="true" %} Edit**. +1. In the top right corner, select **{% octicon "comment" aria-hidden="true" %} Disable comments**. + +## Deleting comments + +You can delete a comment on a gist if you are the author of the gist or the author of the comment. + +1. Navigate to {% data variables.gists.gist_user %} and select the gist you want to moderate. +1. On the upper-right corner of the comment box, select **{% octicon "kebab-horizontal" aria-label="Open dropdown menu" %}**. +1. From the dropdown menu select **Delete**. +1. Select **OK** to confirm. diff --git a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md index ab9e23aa22e7..fd9b73681670 100644 --- a/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md +++ b/content/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax.md @@ -265,15 +265,9 @@ Here are some examples for using relative links to display an image. For more information, see [Relative Links](#relative-links). -### Specifying the theme an image is shown to +### The Picture element -You can specify the theme an image is displayed for in Markdown by using the HTML `` element in combination with the `prefers-color-scheme` media feature. We distinguish between light and dark color modes, so there are two options available. You can use these options to display images optimized for dark or light backgrounds. This is particularly helpful for transparent PNG images. - -For example, the following code displays a sun image for light themes and a moon for dark themes: - -{% data reusables.getting-started.picture-element-example %} - -The old method of specifying images based on the theme, by using a fragment appended to the URL (`#gh-dark-mode-only` or `#gh-light-mode-only`), is {% data variables.release-phases.closing_down %} and will be removed in favor of the new method described above. +The `` HTML element is supported. ## Lists diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md b/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md index 1ad7172042c6..83a4fd280108 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/about-task-lists.md @@ -44,7 +44,7 @@ If you add a task list to the body of an issue, the list has added functionality {% data reusables.repositories.task-list-markdown %} -> [!TIP] +> [!NOTE] > You cannot create task list items within closed issues or issues with linked pull requests. ## Reordering tasks diff --git a/content/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization.md b/content/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization.md index b53a7cc60334..6d7a92a8c0da 100644 --- a/content/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization.md +++ b/content/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization.md @@ -120,7 +120,7 @@ Some of the features listed below are limited to organizations using {% data var | {% ifversion repo-rules %} | | View [rulesets for a repository](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets) | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | | {% endif %} | -| [Push to protected branches](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches) | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | +| [Push to protected branches](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)
{% ifversion repo-rules %}Doesn't apply to rulesets as these have a different bypass model. See [Granting bypass permissions for your branch or tag ruleset](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/creating-rulesets-for-a-repository#granting-bypass-permissions-for-your-branch-or-tag-ruleset).{% endif %} | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | | Merge pull requests on protected branches, even if there are no approving reviews | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | | {% ifversion ghes < 3.16 %} | | Create tags that match a [tag protection rule](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/configuring-tag-protection-rules) | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "x" aria-label="No" %} | {% octicon "check" aria-label="Yes" %} | {% octicon "check" aria-label="Yes" %} | diff --git a/content/packages/learn-github-packages/deleting-and-restoring-a-package.md b/content/packages/learn-github-packages/deleting-and-restoring-a-package.md index 2fcf4da0c4c2..9cc8d0726299 100644 --- a/content/packages/learn-github-packages/deleting-and-restoring-a-package.md +++ b/content/packages/learn-github-packages/deleting-and-restoring-a-package.md @@ -19,10 +19,10 @@ shortTitle: Delete & restore a package ## Package deletion and restoration support on {% data variables.product.prodname_dotcom %} On {% data variables.product.prodname_dotcom %} if you have the required access, you can delete: -* an entire private package -* an entire public package, if there's not more than 5000 downloads of any version of the package -* a specific version of a private package -* a specific version of a public package, if the package version doesn't have more than 5,000 downloads +* An entire private package +* An entire public package, if there's not more than 5000 downloads of any version of the package +* A specific version of a private package +* A specific version of a public package, if the package version doesn't have more than 5,000 downloads > [!NOTE] > * You cannot delete a public package if any version of the package has more than 5,000 downloads. In this scenario, contact us through the {% data variables.contact.contact_support_portal %} for further assistance. diff --git a/content/pages/getting-started-with-github-pages/about-github-pages.md b/content/pages/getting-started-with-github-pages/about-github-pages.md index 5fe9a21bb32b..e2af4547ee82 100644 --- a/content/pages/getting-started-with-github-pages/about-github-pages.md +++ b/content/pages/getting-started-with-github-pages/about-github-pages.md @@ -117,7 +117,7 @@ Using {% data variables.product.prodname_pages %} to create a copy of an existin {% data variables.product.prodname_pages %} sites are subject to the following usage limits: -* {% data variables.product.prodname_pages %} source repositories have a recommended limit of 1 GB.{% ifversion fpt or ghec %} For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/about-large-files-on-github#file-and-repository-size-limitations){% endif %} +* {% data variables.product.prodname_pages %} source repositories have a recommended limit of 1 GB.{% ifversion fpt or ghec %} For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/about-large-files-on-github#file-and-repository-size-limitations){% endif %}. * Published {% data variables.product.prodname_pages %} sites may be no larger than 1 GB. * {% data variables.product.prodname_pages %} deployments will timeout if they take longer than 10 minutes. {% ifversion fpt or ghec %} diff --git a/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md b/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md index 53fe3929bb37..e2a6314aec56 100644 --- a/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md +++ b/content/pages/getting-started-with-github-pages/using-submodules-with-github-pages.md @@ -18,7 +18,7 @@ If the repository for your {% data variables.product.prodname_pages %} site cont You can only use submodules that point to public repositories, because the {% data variables.product.prodname_pages %} server cannot access private repositories. -Use the `https://` read-only URL for your submodules, including nested submodules. You can make this change in your _.gitmodules_ file. +Use the `https://` read-only URL for your submodules, including nested submodules. You can make this change in your `.gitmodules` file. ## Further reading diff --git a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md index 03d8cbb022b5..734b229c3f92 100644 --- a/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md +++ b/content/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll.md @@ -25,10 +25,10 @@ People with write permissions for a repository can add a theme to a {% data vari {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.navigate-publishing-source %} -1. Navigate to __config.yml_. +1. Navigate to `_config.yml`. {% data reusables.repositories.edit-file %} 1. Add a new line to the file for the theme name. - * To use a supported theme, type `theme: THEME-NAME`, replacing _THEME-NAME_ with the name of the theme as shown in the `_config.yml` of the theme's repository (most themes follow a `jekyll-theme-NAME` naming convention). For a list of supported themes, see [Supported themes](https://pages.github.com/themes/) on the {% data variables.product.prodname_pages %} site. For example, to select the Minimal theme, type `theme: jekyll-theme-minimal`. + * To use a supported theme, type `theme: THEME-NAME`, replacing THEME-NAME with the name of the theme as shown in the `_config.yml` of the theme's repository (most themes follow a `jekyll-theme-NAME` naming convention). For a list of supported themes, see [Supported themes](https://pages.github.com/themes/) on the {% data variables.product.prodname_pages %} site. For example, to select the Minimal theme, type `theme: jekyll-theme-minimal`. * To use any other Jekyll theme hosted on {% data variables.product.prodname_dotcom %}, type `remote_theme: THEME-NAME`, replacing THEME-NAME with the name of the theme as shown in the README of the theme's repository. {% data reusables.files.write_commit_message %} {% data reusables.files.choose-commit-email %} @@ -43,7 +43,7 @@ People with write permissions for a repository can add a theme to a {% data vari {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.navigate-publishing-source %} -1. Create a new file called _/assets/css/style.scss_. +1. Create a new file called `/assets/css/style.scss`. 1. Add the following content to the top of the file: ```scss @@ -61,12 +61,12 @@ People with write permissions for a repository can add a theme to a {% data vari {% data reusables.pages.theme-customization-help %} -1. On {% data variables.product.prodname_dotcom %}, navigate to your theme's source repository. For example, the source repository for Minimal is https://github.com/pages-themes/minimal. -1. In the __layouts_ folder, navigate to your theme's _default.html_ file. +1. On {% data variables.product.prodname_dotcom %}, navigate to your theme's source repository. For example, the source repository for Minimal is `https://github.com/pages-themes/minimal`. +1. In the `_layouts` folder, navigate to your theme's `_default.html` file. 1. Copy the contents of the file. {% data reusables.pages.navigate-site-repo %} {% data reusables.pages.navigate-publishing-source %} -1. Create a file called __layouts/default.html_. +1. Create a file called `_layouts/default.html`. 1. Paste the default layout content you copied earlier. 1. Customize the layout as you'd like. diff --git a/content/rest/index.md b/content/rest/index.md index 6322d88ce478..9987a9f92c42 100644 --- a/content/rest/index.md +++ b/content/rest/index.md @@ -75,6 +75,7 @@ children: - /orgs - /packages - /pages + - /private-registries - /projects - /pulls - /rate-limit diff --git a/content/rest/private-registries/index.md b/content/rest/private-registries/index.md new file mode 100644 index 000000000000..2532d3ce1501 --- /dev/null +++ b/content/rest/private-registries/index.md @@ -0,0 +1,13 @@ +--- +title: Private registries +topics: + - API +autogenerated: rest +allowTitleToDifferFromFilename: true +children: + - /organization-configurations +versions: + fpt: '*' + ghec: '*' +--- + diff --git a/content/rest/private-registries/organization-configurations.md b/content/rest/private-registries/organization-configurations.md new file mode 100644 index 000000000000..649e5a58edbc --- /dev/null +++ b/content/rest/private-registries/organization-configurations.md @@ -0,0 +1,17 @@ +--- +title: Organization configurations +shortTitle: Organization configurations +intro: Use the REST API to manage private registry configurations for organizations. +versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖 + fpt: '*' + ghec: '*' +topics: + - API +autogenerated: rest +allowTitleToDifferFromFilename: true +--- + +> [!NOTE] +> The ability to use the REST API to manage private registries is currently in {% data variables.release-phases.public_preview %} and subject to change. + + diff --git a/content/webhooks/using-webhooks/validating-webhook-deliveries.md b/content/webhooks/using-webhooks/validating-webhook-deliveries.md index 75cb20c2b573..4ad442197c6e 100644 --- a/content/webhooks/using-webhooks/validating-webhook-deliveries.md +++ b/content/webhooks/using-webhooks/validating-webhook-deliveries.md @@ -57,8 +57,8 @@ There are a few important things to keep in mind when validating webhook payload You can use the following `secret` and `payload` values to verify that your implementation is correct: -* `secret`: "It's a Secret to Everybody" -* `payload`: "Hello, World!" +* `secret`: `It's a Secret to Everybody` +* `payload`: `Hello, World!` If your implementation is correct, the signatures that you generate should match the following signature values: diff --git a/data/features/viewscreen-and-notebooks.yml b/data/features/viewscreen-and-notebooks.yml deleted file mode 100644 index 4fe043a4479a..000000000000 --- a/data/features/viewscreen-and-notebooks.yml +++ /dev/null @@ -1,6 +0,0 @@ -# Issues #7825 -# Standing up Viewscreen and Notebooks services to replace Render service -versions: - fpt: '*' - ghec: '*' - ghes: '>=3.7' diff --git a/data/reusables/actions/about-oidc-short-overview.md b/data/reusables/actions/about-oidc-short-overview.md index 2bbcbd9cd490..7232f31662e8 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/disable-selfhosted-runners-crossrefs.md b/data/reusables/actions/disable-selfhosted-runners-crossrefs.md index 2cc86e9ea8fb..d275c5ae2767 100644 --- a/data/reusables/actions/disable-selfhosted-runners-crossrefs.md +++ b/data/reusables/actions/disable-selfhosted-runners-crossrefs.md @@ -1,4 +1,4 @@ -{% 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 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 %} diff --git a/data/reusables/code-scanning/beta-model-packs.md b/data/reusables/code-scanning/beta-model-packs.md index 01626cd9ea68..a4f2ac8d0b5c 100644 --- a/data/reusables/code-scanning/beta-model-packs.md +++ b/data/reusables/code-scanning/beta-model-packs.md @@ -1,6 +1,8 @@ {% ifversion codeql-model-packs %} > [!NOTE] -> {% data variables.product.prodname_codeql %} model packs and the {% data variables.product.prodname_codeql %} model editor are currently in {% data variables.release-phases.public_preview %} and subject to change. Model packs are supported by {% data variables.code-scanning.codeql_model_packs_support %} analysis. +> {% data variables.product.prodname_codeql %} model packs are currently in {% data variables.release-phases.public_preview %} and subject to change. Model packs are supported for {% data variables.code-scanning.codeql_model_packs_support %} analysis. +> +> The {% data variables.product.prodname_codeql %} model editor in the {% data variables.product.prodname_codeql %} extension for {% data variables.product.prodname_vscode %} supports modeling dependencies for {% data variables.code-scanning.codeql_model_editor_support %}. {% endif %} diff --git a/data/reusables/enterprise-accounts/emu-cap-public-preview.md b/data/reusables/enterprise-accounts/emu-cap-public-preview.md index adcc16b1e947..585c6a5b06eb 100644 --- a/data/reusables/enterprise-accounts/emu-cap-public-preview.md +++ b/data/reusables/enterprise-accounts/emu-cap-public-preview.md @@ -1,3 +1,4 @@ >[!NOTE] CAP protection for web sessions is currently in {% data variables.release-phases.public_preview %} and may change. > > If IdP CAP support is already enabled for your enterprise, you can opt into extended protection for web sessions from your enterprise's "Authentication security" settings. To enable this feature, your enterprise must have 1,000 or fewer members, active or suspended. +> When web session protection is enabled and a user's IP conditions are not satisfied, they can view and filter all user-owned resources but cannot view the details of the results for notifications, searches, personal dashboards, or starred repositories. diff --git a/data/reusables/getting-started/about-and-creating-teams.md b/data/reusables/getting-started/about-and-creating-teams.md index 99e0326e23c7..49dc2882e74e 100644 --- a/data/reusables/getting-started/about-and-creating-teams.md +++ b/data/reusables/getting-started/about-and-creating-teams.md @@ -1,3 +1,3 @@ -Teams are groups of organization members that you can create to reflect your company or group's structure with cascading access permissions and mentions. Organization members can send notifications to a team or request reviews, and teams can be visible or secret. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/about-teams)." +Teams are groups of organization members that you can create to reflect your company or group's structure with cascading access permissions and mentions. Organization members can send notifications to a team or request reviews, and teams can be visible or secret. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/about-teams). -You can create independent teams or have multiple levels of nested teams to reflect your group or company's hierarchy. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/creating-a-team)." +You can create independent teams or have multiple levels of nested teams to reflect your group or company's hierarchy. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/creating-a-team). diff --git a/data/reusables/getting-started/actions.md b/data/reusables/getting-started/actions.md index e8388bd4e9b0..aae55bd4c716 100644 --- a/data/reusables/getting-started/actions.md +++ b/data/reusables/getting-started/actions.md @@ -1 +1 @@ -With {% data variables.product.prodname_actions %}, you can automate and customize {% data variables.location.product_location %}'s development workflow on {% data variables.product.product_name %}. You can create your own actions, and use and customize actions shared by the {% data variables.product.prodname_dotcom %} community. For more information, see "[AUTOTITLE](/actions/learn-github-actions)." +With {% data variables.product.prodname_actions %}, you can automate and customize {% data variables.location.product_location %}'s development workflow on {% data variables.product.product_name %}. You can create your own actions, and use and customize actions shared by the {% data variables.product.prodname_dotcom %} community. For more information, see [AUTOTITLE](/actions/learn-github-actions). diff --git a/data/reusables/getting-started/adding-members-to-organizations.md b/data/reusables/getting-started/adding-members-to-organizations.md index cd4aeff18189..ee8dc25a1745 100644 --- a/data/reusables/getting-started/adding-members-to-organizations.md +++ b/data/reusables/getting-started/adding-members-to-organizations.md @@ -1 +1 @@ -You can add members to organizations in {% data variables.location.product_location %} as long as you are an organization owner in the organizations you want to manage. You can also configure visibility of organization membership. For more information, see "[AUTOTITLE](/organizations/managing-membership-in-your-organization/adding-people-to-your-organization)" and "[AUTOTITLE](/admin/user-management/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership)." +You can add members to organizations in {% data variables.location.product_location %} as long as you are an organization owner in the organizations you want to manage. You can also configure visibility of organization membership. For more information, see [AUTOTITLE](/organizations/managing-membership-in-your-organization/adding-people-to-your-organization) and [AUTOTITLE](/admin/user-management/managing-organizations-in-your-enterprise/configuring-visibility-for-organization-membership). diff --git a/data/reusables/getting-started/api.md b/data/reusables/getting-started/api.md index 7600eebef8d2..cf5cb60692a2 100644 --- a/data/reusables/getting-started/api.md +++ b/data/reusables/getting-started/api.md @@ -1 +1 @@ -There are two versions of the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API: the REST API and the GraphQL API. You can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs to automate common tasks, [back up your data](/repositories/archiving-a-github-repository/backing-up-a-repository), or {% ifversion fpt or ghec %}[create integrations](/get-started/exploring-integrations/about-integrations){% else %}create integrations{% endif %} that extend {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/rest/overview/about-githubs-apis)." +There are two versions of the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API: the REST API and the GraphQL API. You can use the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} APIs to automate common tasks, [back up your data](/repositories/archiving-a-github-repository/backing-up-a-repository), or {% ifversion fpt or ghec %}[create integrations](/get-started/exploring-integrations/about-integrations){% else %}create integrations{% endif %} that extend {% data variables.product.product_name %}. For more information, see [AUTOTITLE](/rest/overview/about-githubs-apis). diff --git a/data/reusables/getting-started/being-social.md b/data/reusables/getting-started/being-social.md index eabd146c179e..12110f1ada15 100644 --- a/data/reusables/getting-started/being-social.md +++ b/data/reusables/getting-started/being-social.md @@ -1 +1 @@ -Each repository on {% data variables.product.prodname_dotcom %} is owned by a person or an organization. You can interact with the people, repositories, and organizations by connecting and following them on {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/get-started/start-your-journey/finding-inspiration-on-github)." +Each repository on {% data variables.product.prodname_dotcom %} is owned by a person or an organization. You can interact with the people, repositories, and organizations by connecting and following them on {% data variables.product.product_name %}. For more information, see [AUTOTITLE](/get-started/start-your-journey/finding-inspiration-on-github). diff --git a/data/reusables/getting-started/configuring-security-features.md b/data/reusables/getting-started/configuring-security-features.md index 5aa47ecad58d..4ba3ffa6bb6f 100644 --- a/data/reusables/getting-started/configuring-security-features.md +++ b/data/reusables/getting-started/configuring-security-features.md @@ -1 +1 @@ -To keep {% ifversion ghes %}the organizations in {% data variables.location.product_location %}{% else %}your organization{% endif %} secure, you can use a variety of {% data variables.product.prodname_dotcom %} security features, including security policies, dependency graphs, secret scanning and Dependabot security and version updates. For more information, see {% ifversion security-configurations %}"[AUTOTITLE](/code-security/securing-your-organization)."{% else %}"[AUTOTITLE](/code-security/getting-started/quickstart-for-securing-your-organization)."{% endif %} +To keep {% ifversion ghes %}the organizations in {% data variables.location.product_location %}{% else %}your organization{% endif %} secure, you can use a variety of {% data variables.product.prodname_dotcom %} security features, including security policies, dependency graphs, secret scanning and Dependabot security and version updates. For more information, see {% ifversion security-configurations %}[AUTOTITLE](/code-security/securing-your-organization).{% else %}[AUTOTITLE](/code-security/getting-started/quickstart-for-securing-your-organization).{% endif %} diff --git a/data/reusables/getting-started/contact-support-enterprise.md b/data/reusables/getting-started/contact-support-enterprise.md index 9539346c0036..656d138072af 100644 --- a/data/reusables/getting-started/contact-support-enterprise.md +++ b/data/reusables/getting-started/contact-support-enterprise.md @@ -1 +1 @@ -{% data variables.product.product_name %} includes access to {% data variables.contact.enterprise_support %}. {% data variables.contact.enterprise_support %} can help you troubleshoot issues that come up on {% data variables.product.product_name %}. {% ifversion ghes %}You can also choose to sign up for {% data variables.product.prodname_dotcom %} Premium Support for additional features. {% endif %}For more information, see "[AUTOTITLE](/support/learning-about-github-support/about-github-support)." +{% data variables.product.product_name %} includes access to {% data variables.contact.enterprise_support %}. {% data variables.contact.enterprise_support %} can help you troubleshoot issues that come up on {% data variables.product.product_name %}. {% ifversion ghes %}You can also choose to sign up for {% data variables.product.prodname_dotcom %} Premium Support for additional features. {% endif %}For more information, see [AUTOTITLE](/support/learning-about-github-support/about-github-support). diff --git a/data/reusables/getting-started/contact-support.md b/data/reusables/getting-started/contact-support.md index fe4c8c352d40..8dc90d65f37d 100644 --- a/data/reusables/getting-started/contact-support.md +++ b/data/reusables/getting-started/contact-support.md @@ -1 +1 @@ -{% data variables.contact.github_support %} can help you troubleshoot issues you run into while using {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/support/learning-about-github-support/about-github-support)." +{% data variables.contact.github_support %} can help you troubleshoot issues you run into while using {% data variables.product.prodname_dotcom %}. For more information, see [AUTOTITLE](/support/learning-about-github-support/about-github-support). diff --git a/data/reusables/getting-started/create-a-repository.md b/data/reusables/getting-started/create-a-repository.md index 8ab19ccbc204..7434050ef559 100644 --- a/data/reusables/getting-started/create-a-repository.md +++ b/data/reusables/getting-started/create-a-repository.md @@ -1 +1 @@ -Creating a repository for your project allows you to store code in {% data variables.product.prodname_dotcom %}. This provides a backup of your work that you can choose to share with other developers. For more information, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories)." +Creating a repository for your project allows you to store code in {% data variables.product.prodname_dotcom %}. This provides a backup of your work that you can choose to share with other developers. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/quickstart-for-repositories). diff --git a/data/reusables/getting-started/creating-organizations.md b/data/reusables/getting-started/creating-organizations.md index 5b22742820c4..cfd04e759983 100644 --- a/data/reusables/getting-started/creating-organizations.md +++ b/data/reusables/getting-started/creating-organizations.md @@ -1 +1 @@ -You can create new organizations in {% data variables.location.product_location %} to reflect your company or group's structure. For more information, see "[AUTOTITLE](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch)." +You can create new organizations in {% data variables.location.product_location %} to reflect your company or group's structure. For more information, see [AUTOTITLE](/organizations/collaborating-with-groups-in-organizations/creating-a-new-organization-from-scratch). diff --git a/data/reusables/getting-started/creating-teams.md b/data/reusables/getting-started/creating-teams.md index d11164be85a6..521b38a7152b 100644 --- a/data/reusables/getting-started/creating-teams.md +++ b/data/reusables/getting-started/creating-teams.md @@ -1 +1 @@ -Teams are groups of organization members that can be granted permissions to specific repositories as a group. You can create individual teams or multiple levels of nested teams in each of your organizations. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/creating-a-team)" and "[AUTOTITLE](/organizations/organizing-members-into-teams/adding-organization-members-to-a-team)." +Teams are groups of organization members that can be granted permissions to specific repositories as a group. You can create individual teams or multiple levels of nested teams in each of your organizations. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/creating-a-team) and [AUTOTITLE](/organizations/organizing-members-into-teams/adding-organization-members-to-a-team). diff --git a/data/reusables/getting-started/enforcing-repo-management-policies.md b/data/reusables/getting-started/enforcing-repo-management-policies.md index fa8da7f8d77f..c0374b60a306 100644 --- a/data/reusables/getting-started/enforcing-repo-management-policies.md +++ b/data/reusables/getting-started/enforcing-repo-management-policies.md @@ -1 +1 @@ -As an enterprise owner, you can set repository management policies for all organizations in {% data variables.location.product_location %}, or allow policies to be set separately in each organization. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise)." +As an enterprise owner, you can set repository management policies for all organizations in {% data variables.location.product_location %}, or allow policies to be set separately in each organization. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise). diff --git a/data/reusables/getting-started/enterprise-advanced-security.md b/data/reusables/getting-started/enterprise-advanced-security.md index c1814ae91d2d..a3c9b3743ca6 100644 --- a/data/reusables/getting-started/enterprise-advanced-security.md +++ b/data/reusables/getting-started/enterprise-advanced-security.md @@ -1 +1 @@ -If you have a GitHub Advanced Security license for your enterprise account, you can enforce policies to manage {% data variables.product.prodname_GH_advanced_security %} features for organizations owned by an enterprise account. For more information, see "[AUTOTITLE](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise)." +If you have a GitHub Advanced Security license for your enterprise account, you can enforce policies to manage {% data variables.product.prodname_GH_advanced_security %} features for organizations owned by an enterprise account. For more information, see [AUTOTITLE](/enterprise-cloud@latest/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise). diff --git a/data/reusables/getting-started/fork-a-repository.md b/data/reusables/getting-started/fork-a-repository.md index b8489b72efa3..7eeeb2d446b2 100644 --- a/data/reusables/getting-started/fork-a-repository.md +++ b/data/reusables/getting-started/fork-a-repository.md @@ -1 +1 @@ -Forking a repository will allow you to make changes to another repository without affecting the original. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)." +Forking a repository will allow you to make changes to another repository without affecting the original. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo). diff --git a/data/reusables/getting-started/github-pages-enterprise.md b/data/reusables/getting-started/github-pages-enterprise.md index b9675fbf505f..172661c72abc 100644 --- a/data/reusables/getting-started/github-pages-enterprise.md +++ b/data/reusables/getting-started/github-pages-enterprise.md @@ -1 +1 @@ -{% data variables.product.prodname_pages %} is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository and publishes a website. You can enable or disable {% data variables.product.prodname_pages %} for your enterprise members at the organization level. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-github-pages-for-your-enterprise)" and "[AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages)." +{% data variables.product.prodname_pages %} is a static site hosting service that takes HTML, CSS, and JavaScript files straight from a repository and publishes a website. You can enable or disable {% data variables.product.prodname_pages %} for your enterprise members at the organization level. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-github-pages-for-your-enterprise) and [AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages). diff --git a/data/reusables/getting-started/giving-access-to-repositories-projects-apps.md b/data/reusables/getting-started/giving-access-to-repositories-projects-apps.md index c9b44a9aa123..4a93f91211f9 100644 --- a/data/reusables/getting-started/giving-access-to-repositories-projects-apps.md +++ b/data/reusables/getting-started/giving-access-to-repositories-projects-apps.md @@ -1,3 +1,3 @@ -You can give organization members, teams, and outside collaborators different levels of access to repositories owned by your organization with repository roles. For more information, see "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)." +You can give organization members, teams, and outside collaborators different levels of access to repositories owned by your organization with repository roles. For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization). -You can also customize access to your organization's projects and allow individual organization members to manage your organization's {% data variables.product.prodname_github_apps %}. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects)," "[AUTOTITLE](/organizations/managing-access-to-your-organizations-project-boards)," and "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization)." +You can also customize access to your organization's projects and allow individual organization members to manage your organization's {% data variables.product.prodname_github_apps %}. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects), [AUTOTITLE](/organizations/managing-access-to-your-organizations-project-boards), and [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization). diff --git a/data/reusables/getting-started/learning-enterprise.md b/data/reusables/getting-started/learning-enterprise.md index 481527db7243..4c1089bdba33 100644 --- a/data/reusables/getting-started/learning-enterprise.md +++ b/data/reusables/getting-started/learning-enterprise.md @@ -1,3 +1,3 @@ Your enterprise members can learn new skills by completing fun, realistic projects in their very own GitHub repository with [{% data variables.product.prodname_learning %}](https://skills.github.com/). Each course is a hands-on lesson created by the GitHub community and taught by a friendly bot. -For more information, see "[AUTOTITLE](/get-started/start-your-journey/git-and-github-learning-resources)." +For more information, see [AUTOTITLE](/get-started/start-your-journey/git-and-github-learning-resources). diff --git a/data/reusables/getting-started/learning.md b/data/reusables/getting-started/learning.md index 81f4f7c2a033..cc86a12b02fe 100644 --- a/data/reusables/getting-started/learning.md +++ b/data/reusables/getting-started/learning.md @@ -1,3 +1,3 @@ You can learn new skills by completing fun, realistic projects in your very own GitHub repository with [{% data variables.product.prodname_learning %}](https://skills.github.com/). Each course is a hands-on lesson created by the GitHub community and taught by a friendly bot. -For more information, see "[AUTOTITLE](/get-started/start-your-journey/git-and-github-learning-resources)." +For more information, see [AUTOTITLE](/get-started/start-your-journey/git-and-github-learning-resources). diff --git a/data/reusables/getting-started/managing-enterprise-members.md b/data/reusables/getting-started/managing-enterprise-members.md index f162a21d6c40..cc70f7d9d05e 100644 --- a/data/reusables/getting-started/managing-enterprise-members.md +++ b/data/reusables/getting-started/managing-enterprise-members.md @@ -1 +1 @@ -You can manage settings and audit activity for the members of {% data variables.location.product_location %}. You can {% ifversion ghes %}promote an enterprise member to be a site administrator, {% endif %}manage dormant users, view the audit log for user activity, and customize messages that enterprise members will see. For more information, see "[AUTOTITLE](/admin/user-management/managing-users-in-your-enterprise)." +You can manage settings and audit activity for the members of {% data variables.location.product_location %}. You can {% ifversion ghes %}promote an enterprise member to be a site administrator, {% endif %}manage dormant users, view the audit log for user activity, and customize messages that enterprise members will see. For more information, see [AUTOTITLE](/admin/user-management/managing-users-in-your-enterprise). diff --git a/data/reusables/getting-started/managing-org-members.md b/data/reusables/getting-started/managing-org-members.md index d484bcd24a80..c2d77e212f50 100644 --- a/data/reusables/getting-started/managing-org-members.md +++ b/data/reusables/getting-started/managing-org-members.md @@ -1 +1 @@ -You can invite anyone to be a member of your organization, as long as they have a personal account on {% data variables.product.prodname_dotcom %}. You can also remove members and reinstate former members. For more information, see "[AUTOTITLE](/organizations/managing-membership-in-your-organization)." +You can invite anyone to be a member of your organization, as long as they have a personal account on {% data variables.product.prodname_dotcom %}. You can also remove members and reinstate former members. For more information, see [AUTOTITLE](/organizations/managing-membership-in-your-organization). diff --git a/data/reusables/getting-started/managing-org-policies.md b/data/reusables/getting-started/managing-org-policies.md index d0875f482b88..bb02d80159b1 100644 --- a/data/reusables/getting-started/managing-org-policies.md +++ b/data/reusables/getting-started/managing-org-policies.md @@ -1,5 +1,5 @@ You can manage permissions and policies for a number of different actions and features in your organization. -For example, to protect your organization's data, you can restrict repository creation in your organization. You can also choose to allow or prevent the forking of private repositories owned by your organization. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/restricting-repository-creation-in-your-organization)" and "[AUTOTITLE](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization)." +For example, to protect your organization's data, you can restrict repository creation in your organization. You can also choose to allow or prevent the forking of private repositories owned by your organization. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/restricting-repository-creation-in-your-organization) and [AUTOTITLE](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization). -For the full list of settings you can configure for your organization, see "[AUTOTITLE](/organizations/managing-organization-settings)." +For the full list of settings you can configure for your organization, see [AUTOTITLE](/organizations/managing-organization-settings). diff --git a/data/reusables/getting-started/managing-repo-changes.md b/data/reusables/getting-started/managing-repo-changes.md index fa5ba0d7f99f..bbcb5afe7e6d 100644 --- a/data/reusables/getting-started/managing-repo-changes.md +++ b/data/reusables/getting-started/managing-repo-changes.md @@ -1,3 +1,3 @@ -You can configure permissions for creating, transferring and deleting repositories in your organization, including which types members can create. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/restricting-repository-creation-in-your-organization)" and "[AUTOTITLE](/organizations/managing-organization-settings/setting-permissions-for-deleting-or-transferring-repositories)." +You can configure permissions for creating, transferring and deleting repositories in your organization, including which types members can create. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/restricting-repository-creation-in-your-organization) and [AUTOTITLE](/organizations/managing-organization-settings/setting-permissions-for-deleting-or-transferring-repositories). -You can also restrict or grant the ability to change repository visibility. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/restricting-repository-visibility-changes-in-your-organization)." +You can also restrict or grant the ability to change repository visibility. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/restricting-repository-visibility-changes-in-your-organization). diff --git a/data/reusables/getting-started/managing-team-settings.md b/data/reusables/getting-started/managing-team-settings.md index dfe54662690e..e7964fedcaf3 100644 --- a/data/reusables/getting-started/managing-team-settings.md +++ b/data/reusables/getting-started/managing-team-settings.md @@ -1,3 +1,3 @@ -You can designate a "team maintainer" to manage team settings and discussions, among other privileges. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/assigning-the-team-maintainer-role-to-a-team-member)." +You can designate a "team maintainer" to manage team settings and discussions, among other privileges. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/assigning-the-team-maintainer-role-to-a-team-member). -You can manage code review assignments for your team, change team visibility, manage scheduled reminders for your team, and more in your team's settings. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams)." +You can manage code review assignments for your team, change team visibility, manage scheduled reminders for your team, and more in your team's settings. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams). diff --git a/data/reusables/getting-started/math-and-diagrams.md b/data/reusables/getting-started/math-and-diagrams.md index e2589d42093b..6f886caeb6aa 100644 --- a/data/reusables/getting-started/math-and-diagrams.md +++ b/data/reusables/getting-started/math-and-diagrams.md @@ -1 +1 @@ -{% ifversion mermaid %}You can use Markdown to add rendered math expressions, diagrams, maps, and 3D models to your wiki. For more information on creating rendered math expressions, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions)." For more information on creating diagrams, maps and 3D models, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams)."{% endif %} +{% ifversion mermaid %}You can use Markdown to add rendered math expressions, diagrams, maps, and 3D models to your wiki. For more information on creating rendered math expressions, see [AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions). For more information on creating diagrams, maps and 3D models, see [AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams).{% endif %} diff --git a/data/reusables/getting-started/open-source-projects.md b/data/reusables/getting-started/open-source-projects.md index 2d5021cd6a2a..60cd5013b28c 100644 --- a/data/reusables/getting-started/open-source-projects.md +++ b/data/reusables/getting-started/open-source-projects.md @@ -1,4 +1,4 @@ -Contributing to open source projects on {% data variables.product.prodname_dotcom %} can be a rewarding way to learn, teach, and build experience in just about any skill you can imagine. For more information, see "[How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)" in the Open Source Guides. +Contributing to open source projects on {% data variables.product.prodname_dotcom %} can be a rewarding way to learn, teach, and build experience in just about any skill you can imagine. For more information, see [How to Contribute to Open Source](https://opensource.guide/how-to-contribute/) in the Open Source Guides. -You can find personalized recommendations for projects and good first issues based on your past contributions, stars, and other activities in [Explore {% data variables.product.prodname_dotcom %}](https://github.com/explore).{% ifversion fpt or ghec %} For more information, see "[AUTOTITLE](/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github)." +You can find personalized recommendations for projects and good first issues based on your past contributions, stars, and other activities in [Explore {% data variables.product.prodname_dotcom %}](https://github.com/explore).{% ifversion fpt or ghec %} For more information, see [AUTOTITLE](/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github). {% endif %} diff --git a/data/reusables/getting-started/org-permissions-and-roles.md b/data/reusables/getting-started/org-permissions-and-roles.md index 4060a1c276b2..34157bbece5a 100644 --- a/data/reusables/getting-started/org-permissions-and-roles.md +++ b/data/reusables/getting-started/org-permissions-and-roles.md @@ -1 +1 @@ -Each person in your organization has a role that defines their level of access to the organization. The member role is the default, and you can assign owner and billing manager roles as well as "team maintainer" permissions. For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." +Each person in your organization has a role that defines their level of access to the organization. The member role is the default, and you can assign owner and billing manager roles as well as "team maintainer" permissions. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization). diff --git a/data/reusables/getting-started/packages.md b/data/reusables/getting-started/packages.md index ffaa354cfbe7..04495d94ae1e 100644 --- a/data/reusables/getting-started/packages.md +++ b/data/reusables/getting-started/packages.md @@ -1 +1 @@ -{% data variables.product.prodname_registry %} is a software package hosting service that allows you to host your software packages privately or publicly and use packages as dependencies in your projects. For more information, see "[AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages)." +{% data variables.product.prodname_registry %} is a software package hosting service that allows you to host your software packages privately or publicly and use packages as dependencies in your projects. For more information, see [AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages). diff --git a/data/reusables/getting-started/requiring-2fa.md b/data/reusables/getting-started/requiring-2fa.md index 89a787a7e0c8..97dcbca86f43 100644 --- a/data/reusables/getting-started/requiring-2fa.md +++ b/data/reusables/getting-started/requiring-2fa.md @@ -1 +1 @@ -You can view whether your organization members have two-factor authentication enabled and choose to require two-factor authentication in your organization. For more information, see "[AUTOTITLE](/organizations/keeping-your-organization-secure/managing-two-factor-authentication-for-your-organization/requiring-two-factor-authentication-in-your-organization)." +You can view whether your organization members have two-factor authentication enabled and choose to require two-factor authentication in your organization. For more information, 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/getting-started/reviewing-org-audit-log-and-integrations.md b/data/reusables/getting-started/reviewing-org-audit-log-and-integrations.md index 1fb69fe3a375..ad4052d5165c 100644 --- a/data/reusables/getting-started/reviewing-org-audit-log-and-integrations.md +++ b/data/reusables/getting-started/reviewing-org-audit-log-and-integrations.md @@ -1,3 +1,3 @@ -The audit log for your organization allows you, as an organization owner, to review the actions performed by members of the organization within the last 180 days. For more information, see "[AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization)." +The audit log for your organization allows you, as an organization owner, to review the actions performed by members of the organization within the last 180 days. For more information, see [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization). -You can also review and configure the permission levels for your organization's installed integrations. For more information, see "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/reviewing-github-apps-installed-in-your-organization)." +You can also review and configure the permission levels for your organization's installed integrations. For more information, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/reviewing-github-apps-installed-in-your-organization). diff --git a/data/reusables/getting-started/setting-org-and-repo-permissions.md b/data/reusables/getting-started/setting-org-and-repo-permissions.md index b31dc6af078f..2e27a5f0d061 100644 --- a/data/reusables/getting-started/setting-org-and-repo-permissions.md +++ b/data/reusables/getting-started/setting-org-and-repo-permissions.md @@ -1,3 +1,3 @@ -We recommend giving a limited number of members in each organization an organization owner role, which provides complete administrative access for that organization. For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." +We recommend giving a limited number of members in each organization an organization owner role, which provides complete administrative access for that organization. For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization). -For organizations where you have admin permissions, you can also customize access to each repository with granular permission levels. For more information, see "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)." +For organizations where you have admin permissions, you can also customize access to each repository with granular permission levels. For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization). diff --git a/data/reusables/getting-started/sponsors.md b/data/reusables/getting-started/sponsors.md index 45fcf128e686..1488db5ef866 100644 --- a/data/reusables/getting-started/sponsors.md +++ b/data/reusables/getting-started/sponsors.md @@ -1 +1 @@ -{% data variables.product.prodname_sponsors %} allows you to make a monthly recurring payment to a developer or organization who designs, creates, or maintains open source projects you depend on. For more information, see "[AUTOTITLE](/sponsors/getting-started-with-github-sponsors/about-github-sponsors)." +{% data variables.product.prodname_sponsors %} allows you to make a monthly recurring payment to a developer or organization who designs, creates, or maintains open source projects you depend on. For more information, see [AUTOTITLE](/sponsors/getting-started-with-github-sponsors/about-github-sponsors). diff --git a/data/reusables/getting-started/using-org-community-files-and-moderation-tools.md b/data/reusables/getting-started/using-org-community-files-and-moderation-tools.md index 12d126fd6e12..0a75118a27c3 100644 --- a/data/reusables/getting-started/using-org-community-files-and-moderation-tools.md +++ b/data/reusables/getting-started/using-org-community-files-and-moderation-tools.md @@ -1,3 +1,3 @@ -You can create default community health files, such as a CONTRIBUTING.md file, a CODE_OF_CONDUCT.md file, or even issue and pull request templates, for your organization. These default files will be used for any repository owned by your organization that does not contain its own file of that type. For more information, see "[AUTOTITLE](/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file)." +You can create default community health files, such as a CONTRIBUTING.md file, a CODE_OF_CONDUCT.md file, or even issue and pull request templates, for your organization. These default files will be used for any repository owned by your organization that does not contain its own file of that type. For more information, see [AUTOTITLE](/communities/setting-up-your-project-for-healthy-contributions/creating-a-default-community-health-file). -{% data variables.product.prodname_dotcom %} offers multiple tools for moderating and managing your community. For more information, see "[AUTOTITLE](/communities/setting-up-your-project-for-healthy-contributions/about-community-management-and-moderation#tools-for-moderating-your-community)." +{% data variables.product.prodname_dotcom %} offers multiple tools for moderating and managing your community. For more information, see [AUTOTITLE](/communities/setting-up-your-project-for-healthy-contributions/about-community-management-and-moderation#tools-for-moderating-your-community). diff --git a/data/reusables/github-connect/enable-github-connect.md b/data/reusables/github-connect/enable-github-connect.md index 529643110db9..2f53e55187f9 100644 --- a/data/reusables/github-connect/enable-github-connect.md +++ b/data/reusables/github-connect/enable-github-connect.md @@ -1,4 +1,4 @@ {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} -1. Under "{% data variables.product.prodname_github_connect %} is not enabled yet", click **Enable {% data variables.product.prodname_github_connect %}**. By clicking **Enable {% data variables.product.prodname_github_connect %}**, you agree to the "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#connect)." +1. Under "{% data variables.product.prodname_github_connect %} is not enabled yet", click **Enable {% data variables.product.prodname_github_connect %}**. By clicking **Enable {% data variables.product.prodname_github_connect %}**, you agree to the [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#connect). 1. To the right of the enterprise account you'd like to connect, click **Connect**. diff --git a/data/reusables/github-connect/license-sync.md b/data/reusables/github-connect/license-sync.md index 91a3b95c2f74..36e6629bb723 100644 --- a/data/reusables/github-connect/license-sync.md +++ b/data/reusables/github-connect/license-sync.md @@ -1 +1 @@ -| Automatic user license sync | Manage license usage across your {% data variables.product.prodname_enterprise %} deployments by automatically syncing user licenses from {% data variables.location.product_location %} to {% data variables.product.prodname_ghe_cloud %}. | "[AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise)" | +| Automatic user license sync | Manage license usage across your {% data variables.product.prodname_enterprise %} deployments by automatically syncing user licenses from {% data variables.location.product_location %} to {% data variables.product.prodname_ghe_cloud %}. | [AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-automatic-user-license-sync-for-your-enterprise) | diff --git a/data/reusables/github-connect/unified-contributions.md b/data/reusables/github-connect/unified-contributions.md index ea8a33390c20..f01a3c06eb0d 100644 --- a/data/reusables/github-connect/unified-contributions.md +++ b/data/reusables/github-connect/unified-contributions.md @@ -1 +1 @@ -| Unified contributions | Allow users to include anonymized contribution counts for their work on {% data variables.location.product_location %} in their contribution graphs on {% data variables.product.prodname_ghe_cloud %}. | "[AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-unified-contributions-for-your-enterprise)" | +| Unified contributions | Allow users to include anonymized contribution counts for their work on {% data variables.location.product_location %} in their contribution graphs on {% data variables.product.prodname_ghe_cloud %}. | [AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-unified-contributions-for-your-enterprise) | diff --git a/data/reusables/github-connect/unified-search.md b/data/reusables/github-connect/unified-search.md index af97acbf7fec..3c923e35bf31 100644 --- a/data/reusables/github-connect/unified-search.md +++ b/data/reusables/github-connect/unified-search.md @@ -1 +1 @@ -| Unified search | Allow users to include repositories on {% data variables.product.prodname_ghe_cloud %} in their search results when searching from {% data variables.location.product_location %}. | "[AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise)" | +| Unified search | Allow users to include repositories on {% data variables.product.prodname_ghe_cloud %} in their search results when searching from {% data variables.location.product_location %}. | [AUTOTITLE](/admin/configuration/configuring-github-connect/enabling-unified-search-for-your-enterprise) | diff --git a/data/reusables/gpg/set-auto-sign.md b/data/reusables/gpg/set-auto-sign.md index 7246571da029..8c98b3ac2ae6 100644 --- a/data/reusables/gpg/set-auto-sign.md +++ b/data/reusables/gpg/set-auto-sign.md @@ -5,4 +5,4 @@ git config --global tag.gpgSign true ``` - For more information, see "[AUTOTITLE](/authentication/managing-commit-signature-verification/signing-commits)." + For more information, see [AUTOTITLE](/authentication/managing-commit-signature-verification/signing-commits). diff --git a/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md b/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md index a9b99865fe57..fcadb9fceaac 100644 --- a/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md +++ b/data/reusables/identity-and-permissions/about-enabling-allowed-ip-addresses.md @@ -7,4 +7,4 @@ After you create an IP allow list, you can enable allowed IP addresses. When you {% endif %} -Before you enable your IP allow list, you can check whether your allow list will permit a connection from a particular IP address. For more information, see "[Checking if an IP address is permitted](#checking-if-an-ip-address-is-permitted)." +Before you enable your IP allow list, you can check whether your allow list will permit a connection from a particular IP address. For more information, see [Checking if an IP address is permitted](#checking-if-an-ip-address-is-permitted). diff --git a/data/reusables/identity-and-permissions/check-ip-address.md b/data/reusables/identity-and-permissions/check-ip-address.md index 003e8a36b457..05b53dd97fca 100644 --- a/data/reusables/identity-and-permissions/check-ip-address.md +++ b/data/reusables/identity-and-permissions/check-ip-address.md @@ -1 +1 @@ -1. Optionally, check if a particular IP address would be allowed by any of the enabled entries in your list. For more information, see "[Checking if an IP address is permitted](#checking-if-an-ip-address-is-permitted)." +1. Optionally, check if a particular IP address would be allowed by any of the enabled entries in your list. For more information, see [Checking if an IP address is permitted](#checking-if-an-ip-address-is-permitted). diff --git a/data/reusables/identity-and-permissions/ip-allow-lists-cidr-notation.md b/data/reusables/identity-and-permissions/ip-allow-lists-cidr-notation.md index 0d2e7a9bf497..09b6af21a4ac 100644 --- a/data/reusables/identity-and-permissions/ip-allow-lists-cidr-notation.md +++ b/data/reusables/identity-and-permissions/ip-allow-lists-cidr-notation.md @@ -1 +1 @@ -You can approve access for a single IP address, or a range of addresses, using CIDR notation. For more information, see "[CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation)" on Wikipedia. +You can approve access for a single IP address, or a range of addresses, using CIDR notation. For more information, see [CIDR notation](https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing#CIDR_notation) on Wikipedia. diff --git a/data/reusables/identity-and-permissions/ip-allow-lists-enterprise.md b/data/reusables/identity-and-permissions/ip-allow-lists-enterprise.md index 107cabfbea58..acef567708a9 100644 --- a/data/reusables/identity-and-permissions/ip-allow-lists-enterprise.md +++ b/data/reusables/identity-and-permissions/ip-allow-lists-enterprise.md @@ -1,5 +1,5 @@ When you enable the allow list, the IP addresses you have configured are immediately added to the allow lists of organizations in your enterprise. If you disable the allow list, the addresses are removed from the organization allow lists. -{% data reusables.identity-and-permissions.org-enterprise-allow-list-interaction %} For more information, see "[AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization)." +{% data reusables.identity-and-permissions.org-enterprise-allow-list-interaction %} For more information, see [AUTOTITLE](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization). -You can choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} installed in your enterprise. The creator of a {% data variables.product.prodname_github_app %} can configure an allow list for their application, specifying the IP addresses at which the application runs. By inheriting their allow list into yours, you avoid connection requests from the application being refused. For more information, see "[Allowing access by GitHub Apps](#allowing-access-by-github-apps)." +You can choose to automatically add to your allow list any IP addresses configured for {% data variables.product.prodname_github_apps %} installed in your enterprise. The creator of a {% data variables.product.prodname_github_app %} can configure an allow list for their application, specifying the IP addresses at which the application runs. By inheriting their allow list into yours, you avoid connection requests from the application being refused. For more information, see [Allowing access by GitHub Apps](#allowing-access-by-github-apps). diff --git a/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md b/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md index 35e16222db81..d3554c088e24 100644 --- a/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md +++ b/data/reusables/identity-and-permissions/ip-allow-lists-githubapps-enterprise.md @@ -4,7 +4,7 @@ If you're using an allow list, you can also choose to automatically add to your {% data reusables.apps.ip-allow-list-only-apps %} -For more information about how to create an allow list for a {% data variables.product.prodname_github_app %} you have created, see "[AUTOTITLE](/apps/maintaining-github-apps/managing-allowed-ip-addresses-for-a-github-app)." +For more information about how to create an allow list for a {% data variables.product.prodname_github_app %} you have created, see [AUTOTITLE](/apps/maintaining-github-apps/managing-allowed-ip-addresses-for-a-github-app). To enable automatic addition of IP addresses for {% data variables.product.prodname_github_apps %}: diff --git a/data/reusables/identity-and-permissions/revoking-identity-team-sync.md b/data/reusables/identity-and-permissions/revoking-identity-team-sync.md index 2d7cfcfb8039..4abf19ba22d4 100644 --- a/data/reusables/identity-and-permissions/revoking-identity-team-sync.md +++ b/data/reusables/identity-and-permissions/revoking-identity-team-sync.md @@ -1,2 +1,2 @@ > [!WARNING] -> If your organization uses team synchronization, revoking a person's SSO identity will remove that person from any teams mapped to IdP groups. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)." +> If your organization uses team synchronization, revoking a person's SSO identity will remove that person from any teams mapped to IdP groups. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group). diff --git a/data/reusables/identity-and-permissions/sync-team-with-idp-group.md b/data/reusables/identity-and-permissions/sync-team-with-idp-group.md index dcd5d9fa9d75..5b3b7a8496b2 100644 --- a/data/reusables/identity-and-permissions/sync-team-with-idp-group.md +++ b/data/reusables/identity-and-permissions/sync-team-with-idp-group.md @@ -1 +1 @@ -After you enable team synchronization, team maintainers and organization owners can connect a team to an IdP group on {% data variables.product.prodname_dotcom %} or through the API. For more information, see "[AUTOTITLE](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group)" and "[AUTOTITLE](/rest/teams#team-sync)." +After you enable team synchronization, team maintainers and organization owners can connect a team to an IdP group on {% data variables.product.prodname_dotcom %} or through the API. For more information, see [AUTOTITLE](/organizations/organizing-members-into-teams/synchronizing-a-team-with-an-identity-provider-group) and [AUTOTITLE](/rest/teams#team-sync). diff --git a/data/reusables/identity-and-permissions/team-sync-confirm-scim.md b/data/reusables/identity-and-permissions/team-sync-confirm-scim.md index 060bb62330d9..fb365957d63b 100644 --- a/data/reusables/identity-and-permissions/team-sync-confirm-scim.md +++ b/data/reusables/identity-and-permissions/team-sync-confirm-scim.md @@ -1 +1 @@ -1. We recommend you confirm that your users have SAML enabled and have a linked SCIM identity to avoid potential provisioning errors. For more information, see "[AUTOTITLE](/organizations/managing-saml-single-sign-on-for-your-organization/troubleshooting-identity-and-access-management-for-your-organization)." +1. We recommend you confirm that your users have SAML enabled and have a linked SCIM identity to avoid potential provisioning errors. For more information, see [AUTOTITLE](/organizations/managing-saml-single-sign-on-for-your-organization/troubleshooting-identity-and-access-management-for-your-organization). diff --git a/data/reusables/identity-and-permissions/team-sync-okta-requirements.md b/data/reusables/identity-and-permissions/team-sync-okta-requirements.md index fb0136a4e10c..bb84c3de2cd6 100644 --- a/data/reusables/identity-and-permissions/team-sync-okta-requirements.md +++ b/data/reusables/identity-and-permissions/team-sync-okta-requirements.md @@ -1,5 +1,5 @@ Before you enable team synchronization for Okta, you or your IdP administrator must: -* Configure the SAML, SSO, and SCIM integration for your organization using Okta. For more information, see "[AUTOTITLE](/organizations/managing-saml-single-sign-on-for-your-organization/configuring-saml-single-sign-on-and-scim-using-okta)." +* Configure the SAML, SSO, and SCIM integration for your organization using Okta. For more information, see [AUTOTITLE](/organizations/managing-saml-single-sign-on-for-your-organization/configuring-saml-single-sign-on-and-scim-using-okta). * Provide the tenant URL for your Okta instance. * Generate a valid SSWS token with read-only admin permissions for your Okta installation as a service user. For more information, see [Create the token](https://developer.okta.com/docs/guides/create-an-api-token/create-the-token/) and [Service users](https://help.okta.com/asa/en-us/Content/Topics/Adv_Server_Access/docs/service-users.htm) in Okta's documentation. diff --git a/data/reusables/identity-and-permissions/verification-status-check.md b/data/reusables/identity-and-permissions/verification-status-check.md index 53d269b0da3d..2e87736793fe 100644 --- a/data/reusables/identity-and-permissions/verification-status-check.md +++ b/data/reusables/identity-and-permissions/verification-status-check.md @@ -1 +1 @@ -You can check the verification status of your signed commits or tags on {% data variables.product.product_name %} and view why your commit signatures might be unverified. For more information, see "[AUTOTITLE](/authentication/troubleshooting-commit-signature-verification/checking-your-commit-and-tag-signature-verification-status)." +You can check the verification status of your signed commits or tags on {% data variables.product.product_name %} and view why your commit signatures might be unverified. For more information, see [AUTOTITLE](/authentication/troubleshooting-commit-signature-verification/checking-your-commit-and-tag-signature-verification-status). diff --git a/data/reusables/issues/release-stage.md b/data/reusables/issues/release-stage.md index b503d75980de..b109f204bece 100644 --- a/data/reusables/issues/release-stage.md +++ b/data/reusables/issues/release-stage.md @@ -1,3 +1,3 @@ >[!NOTE] ->Issue types, sub-issues, and advanced issue search are currently in an opt-in {% data variables.release-phases.public_preview %} for organizations. To learn more and add your organization to the waitlist, see the "[GitHub Blog](https://github.blog/changelog/2024-10-01-evolving-github-issues-public-preview)." +>Issue types, sub-issues, and advanced issue search are currently in an opt-in {% data variables.release-phases.public_preview %} for organizations. To learn more and add your organization to the waitlist, see the [GitHub Blog](https://github.blog/changelog/2024-10-01-evolving-github-issues-public-preview). diff --git a/data/reusables/large_files/can-include-lfs-objects-archives.md b/data/reusables/large_files/can-include-lfs-objects-archives.md index 215145ff14a1..e5025e47220a 100644 --- a/data/reusables/large_files/can-include-lfs-objects-archives.md +++ b/data/reusables/large_files/can-include-lfs-objects-archives.md @@ -1,3 +1,3 @@ {% ifversion fpt or ghec %} -You can choose whether {% data variables.large_files.product_name_short %} objects are included in [source code archives](/repositories/working-with-files/using-files/downloading-source-code-archives), such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository)." +You can choose whether {% data variables.large_files.product_name_short %} objects are included in [source code archives](/repositories/working-with-files/using-files/downloading-source-code-archives), such as ZIP files and tarballs, that {% data variables.product.product_name %} creates for your repository. For more information, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository). {% endif %} diff --git a/data/reusables/large_files/resolving-upload-failures.md b/data/reusables/large_files/resolving-upload-failures.md index c64dda0e9228..af7e6a563f9e 100644 --- a/data/reusables/large_files/resolving-upload-failures.md +++ b/data/reusables/large_files/resolving-upload-failures.md @@ -1 +1 @@ -If there are referenced {% data variables.large_files.product_name_short %} files that did not upload successfully, you will receive an error message. For more information, see "[AUTOTITLE](/repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures)." +If there are referenced {% data variables.large_files.product_name_short %} files that did not upload successfully, you will receive an error message. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-large-files/resolving-git-large-file-storage-upload-failures). diff --git a/data/reusables/marketplace/free-trials.md b/data/reusables/marketplace/free-trials.md index f3c0e809576c..569f7217dfb0 100644 --- a/data/reusables/marketplace/free-trials.md +++ b/data/reusables/marketplace/free-trials.md @@ -1 +1 @@ -If you choose a paid plan with a free trial, you can cancel at any time during your trial period without being charged, but you will automatically lose access to the app. Your paid subscription will start at the end of the 14-day trial. For more information, see "[AUTOTITLE](/billing/managing-billing-for-github-marketplace-apps/about-billing-for-github-marketplace)." +If you choose a paid plan with a free trial, you can cancel at any time during your trial period without being charged, but you will automatically lose access to the app. Your paid subscription will start at the end of the 14-day trial. For more information, see [AUTOTITLE](/billing/managing-billing-for-github-marketplace-apps/about-billing-for-github-marketplace). diff --git a/data/reusables/marketplace/marketplace-apps-not-actions.md b/data/reusables/marketplace/marketplace-apps-not-actions.md index 930f59c0f7bf..0afa4cd1aa88 100644 --- a/data/reusables/marketplace/marketplace-apps-not-actions.md +++ b/data/reusables/marketplace/marketplace-apps-not-actions.md @@ -1,2 +1,2 @@ > [!NOTE] -> This article applies to publishing apps in {% data variables.product.prodname_marketplace %} only. For more information about publishing {% data variables.product.prodname_actions %} in {% data variables.product.prodname_marketplace %}, see "[AUTOTITLE](/actions/creating-actions/publishing-actions-in-github-marketplace)." +> This article applies to publishing apps in {% data variables.product.prodname_marketplace %} only. For more information about publishing {% data variables.product.prodname_actions %} in {% data variables.product.prodname_marketplace %}, see [AUTOTITLE](/actions/creating-actions/publishing-actions-in-github-marketplace). diff --git a/data/reusables/marketplace/marketplace-apps-only.md b/data/reusables/marketplace/marketplace-apps-only.md index 4b4227f9e9c3..4a898b1a7998 100644 --- a/data/reusables/marketplace/marketplace-apps-only.md +++ b/data/reusables/marketplace/marketplace-apps-only.md @@ -1,2 +1,2 @@ > [!NOTE] -> This article applies to installing and purchasing apps from {% data variables.product.prodname_marketplace %} only. For more information on apps purchased from integrators, see "[AUTOTITLE](/get-started/exploring-integrations/about-integrations)." +> This article applies to installing and purchasing apps from {% data variables.product.prodname_marketplace %} only. For more information on apps purchased from integrators, see [AUTOTITLE](/get-started/exploring-integrations/about-integrations). diff --git a/data/reusables/marketplace/marketplace-enterprise-account.md b/data/reusables/marketplace/marketplace-enterprise-account.md index 2ec86eb80eec..126cf0e968a0 100644 --- a/data/reusables/marketplace/marketplace-enterprise-account.md +++ b/data/reusables/marketplace/marketplace-enterprise-account.md @@ -1,4 +1,4 @@ > [!NOTE] -> To use a {% data variables.product.prodname_marketplace %} app, you must install the app on an organization account within your enterprise. For more information, see "[AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations)." +> To use a {% data variables.product.prodname_marketplace %} app, you must install the app on an organization account within your enterprise. For more information, see [AUTOTITLE](/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations). > > You cannot purchase or manage paid {% data variables.product.prodname_marketplace %} apps if your enterprise account is invoiced. Organizations belonging to an enterprise can view and use {% data variables.product.prodname_marketplace %} apps from their billing settings, but you can only purchase or manage apps through your enterprise account. Only enterprise owners who are also organization owners can purchase {% data variables.product.prodname_marketplace %} apps. diff --git a/data/reusables/migrations/create-empty-repo.md b/data/reusables/migrations/create-empty-repo.md index b72f68cd2e32..30debc9bb812 100644 --- a/data/reusables/migrations/create-empty-repo.md +++ b/data/reusables/migrations/create-empty-repo.md @@ -1 +1 @@ -1. Create a new repository on {% data variables.product.github %}. To avoid errors, do not initialize the new repository with README, license, or gitignore files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. For more information, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/creating-a-new-repository)." +1. Create a new repository on {% data variables.product.github %}. To avoid errors, do not initialize the new repository with README, license, or gitignore files. You can add these files after your project has been pushed to {% data variables.product.product_name %}. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/creating-a-new-repository). diff --git a/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghecom.md b/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghecom.md index 7e4f7a94ec25..d587606da80c 100644 --- a/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghecom.md +++ b/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghecom.md @@ -1 +1 @@ -If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see "[Migrations from any Git repository to {% data variables.enterprise.data_residency_site %}](#any-git-repository-to-ghecom)." +If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see [Migrations from any Git repository to {% data variables.enterprise.data_residency_site %}](#any-git-repository-to-ghecom). diff --git a/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghes.md b/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghes.md index ab2b163d8324..43b321447ad3 100644 --- a/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghes.md +++ b/data/reusables/migrations/migration-instructions-for-any-git-repository-to-ghes.md @@ -1 +1 @@ -If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see "[Any Git repository to {% data variables.product.prodname_ghe_server %}](#any-git-repository-to-github-enterprise-server)." +If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see [Any Git repository to {% data variables.product.prodname_ghe_server %}](#any-git-repository-to-github-enterprise-server). diff --git a/data/reusables/migrations/migration-instructions-for-any-git-repository-to-githubcom.md b/data/reusables/migrations/migration-instructions-for-any-git-repository-to-githubcom.md index 96a95a81e57e..ef134c62f572 100644 --- a/data/reusables/migrations/migration-instructions-for-any-git-repository-to-githubcom.md +++ b/data/reusables/migrations/migration-instructions-for-any-git-repository-to-githubcom.md @@ -1 +1 @@ -If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see "[Migrations from any Git repository to {% data variables.product.prodname_dotcom_the_website %}](#any-git-repository-to-githubcom)." +If an expert-led migration isn't right for you, you can perform a "source and history" migration of the affected repositories instead. For more information, see [Migrations from any Git repository to {% data variables.product.prodname_dotcom_the_website %}](#any-git-repository-to-githubcom). diff --git a/data/reusables/notifications-v2/notifications-inbox-required-setting.md b/data/reusables/notifications-v2/notifications-inbox-required-setting.md index 113375a40d72..18f2aeb711a9 100644 --- a/data/reusables/notifications-v2/notifications-inbox-required-setting.md +++ b/data/reusables/notifications-v2/notifications-inbox-required-setting.md @@ -1 +1 @@ -To use the notifications inbox on {% data variables.product.prodname_dotcom %} and {% data variables.product.prodname_mobile %}, you must enable web and mobile notifications in your notification settings. +To use the notifications inbox on {% data variables.product.prodname_dotcom %} and {% data variables.product.prodname_mobile %}, you must enable notifications for both **Email** and **On {% data variables.product.github %}** in your notification settings. diff --git a/data/reusables/notifications/email-restrictions-verification.md b/data/reusables/notifications/email-restrictions-verification.md index 7f7827fb92fb..7990b158f53e 100644 --- a/data/reusables/notifications/email-restrictions-verification.md +++ b/data/reusables/notifications/email-restrictions-verification.md @@ -1 +1 @@ -{% ifversion fpt or ghec %}To continue receiving email notifications after you enable restrictions, members must verify any email addresses within domains that you verify or approve. For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address)."{% endif %} +{% ifversion fpt or ghec %}To continue receiving email notifications after you enable restrictions, members must verify any email addresses within domains that you verify or approve. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/verifying-your-email-address).{% endif %} diff --git a/data/reusables/notifications/shared_state.md b/data/reusables/notifications/shared_state.md index 0af38705ab1a..2ab30afab949 100644 --- a/data/reusables/notifications/shared_state.md +++ b/data/reusables/notifications/shared_state.md @@ -1,2 +1,2 @@ > [!TIP] -> If you receive both web and email notifications, you can automatically sync the read or unread status of the notification so that web notifications are automatically marked as read once you've read the corresponding email notification. To enable this sync, your email client must be able to view images from {% ifversion fpt or ghec %}`notifications@github.com`{% else %}the `no-reply` email address {% ifversion ghes %}for {% data variables.location.product_location %}, which your site administrator configures{% endif %}{% endif %}. +> If you receive notifications both via email and on {% data variables.product.github %}, you can automatically sync the read or unread status of the notification so that notifications on {% data variables.product.github %} are automatically marked as read once you've read the corresponding email notification. To enable this sync, your email client must be able to view images from {% ifversion fpt or ghec %}`notifications@github.com`{% else %}the `no-reply` email address {% ifversion ghes %}for {% data variables.location.product_location %}, which your site administrator configures{% endif %}{% endif %}. diff --git a/data/reusables/notifications/vulnerable-dependency-notification-enable.md b/data/reusables/notifications/vulnerable-dependency-notification-enable.md index 719a974e015f..08d8a2cdcde1 100644 --- a/data/reusables/notifications/vulnerable-dependency-notification-enable.md +++ b/data/reusables/notifications/vulnerable-dependency-notification-enable.md @@ -1 +1 @@ -To receive notifications about {% data variables.product.prodname_dependabot_alerts %} on repositories, you need to watch these repositories, and subscribe to receive "All Activity" notifications or configure custom settings to include "Security alerts." For more information, see "[AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)." +To receive notifications about {% data variables.product.prodname_dependabot_alerts %} on repositories, you need to watch these repositories, and subscribe to receive "All Activity" notifications or configure custom settings to include "Security alerts." For more information, see [AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository). diff --git a/data/reusables/notifications/vulnerable-dependency-notification-options.md b/data/reusables/notifications/vulnerable-dependency-notification-options.md index c0bbb958275b..b70c6fdb95c5 100644 --- a/data/reusables/notifications/vulnerable-dependency-notification-options.md +++ b/data/reusables/notifications/vulnerable-dependency-notification-options.md @@ -3,7 +3,7 @@ * In your inbox, as web notifications. A web notification is sent when {% data variables.product.prodname_dependabot %} is enabled for a repository, when a new manifest file is committed to the repository, and when a new vulnerability with a critical or high severity is found (**On {% data variables.product.prodname_dotcom %}** option). * By email. An email is sent when {% data variables.product.prodname_dependabot %} is enabled for a repository, when a new manifest file is committed to the repository, and when a new vulnerability with a critical or high severity is found (**Email** option). * On the command line. Warnings are displayed as callbacks when you push to repositories with any insecure dependencies (**CLI** option). -* On {% data variables.product.prodname_mobile %}, as web notifications. For more information, see "[AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#enabling-push-notifications-with-github-mobile)." +* On {% data variables.product.prodname_mobile %}, as web notifications. For more information, see [AUTOTITLE](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#enabling-push-notifications-with-github-mobile). > [!NOTE] > The email and web/{% data variables.product.prodname_mobile %} notifications are: diff --git a/data/reusables/notifications/watch-settings.md b/data/reusables/notifications/watch-settings.md index cbfecfb313e8..a55b7e825609 100644 --- a/data/reusables/notifications/watch-settings.md +++ b/data/reusables/notifications/watch-settings.md @@ -1 +1 @@ -For more information about setting up notification preferences, see "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)" and "[Configuring your watch settings for an individual repository](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository)." +For more information about setting up notification preferences, see [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts) and [Configuring your watch settings for an individual repository](/account-and-profile/managing-subscriptions-and-notifications-on-github/setting-up-notifications/configuring-notifications#configuring-your-watch-settings-for-an-individual-repository). diff --git a/data/reusables/organizations/add-extension-to-cert.md b/data/reusables/organizations/add-extension-to-cert.md index 5a7a7d3d9f7e..0ce28b8abae5 100644 --- a/data/reusables/organizations/add-extension-to-cert.md +++ b/data/reusables/organizations/add-extension-to-cert.md @@ -1 +1 @@ -When you issue each client certificate, you must include an extension that specifies which {% data variables.product.product_name %} user the certificate is for. For more information, see "[AUTOTITLE](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities)." +When you issue each client certificate, you must include an extension that specifies which {% data variables.product.product_name %} user the certificate is for. For more information, see [AUTOTITLE](/organizations/managing-git-access-to-your-organizations-repositories/about-ssh-certificate-authorities). diff --git a/data/reusables/organizations/additional-permissions.md b/data/reusables/organizations/additional-permissions.md index 998fe0a25ef6..676f3ec3f394 100644 --- a/data/reusables/organizations/additional-permissions.md +++ b/data/reusables/organizations/additional-permissions.md @@ -9,7 +9,7 @@ * Hide or unhide discussion comments * Convert issues to discussions -For more information, see "[AUTOTITLE](/discussions)." +For more information, see [AUTOTITLE](/discussions). {% endif %} ### Issue and Pull Requests @@ -36,7 +36,7 @@ For more information, see "[AUTOTITLE](/discussions)." * Manage wiki settings * Manage project settings * Manage pull request merging settings -* Manage {% data variables.product.prodname_pages %} settings (see "[AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)") +* Manage {% data variables.product.prodname_pages %} settings (see [AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)) * Manage webhooks * Manage deploy keys * Edit repository metadata diff --git a/data/reusables/organizations/api-insights-learn-about.md b/data/reusables/organizations/api-insights-learn-about.md index 50f1d086c1db..11de335d599a 100644 --- a/data/reusables/organizations/api-insights-learn-about.md +++ b/data/reusables/organizations/api-insights-learn-about.md @@ -1 +1 @@ -{% ifversion api-insights %}To learn about viewing an organization's API activity, including which requests exceeded primary rate limits, see "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/viewing-api-insights-in-your-organization)."{% endif %} +{% ifversion api-insights %}To learn about viewing an organization's API activity, including which requests exceeded primary rate limits, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/viewing-api-insights-in-your-organization).{% endif %} diff --git a/data/reusables/organizations/blocking-a-user.md b/data/reusables/organizations/blocking-a-user.md index 8a698a354f40..81287ce08ccb 100644 --- a/data/reusables/organizations/blocking-a-user.md +++ b/data/reusables/organizations/blocking-a-user.md @@ -1 +1 @@ -When you block a user, you can choose to block them indefinitely or for a specific amount of time. If you block someone for a specific amount of time, they are automatically unblocked after the chosen time expires. If you block someone indefinitely, you can unblock them manually at any time. For more information, see "[AUTOTITLE](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization)." +When you block a user, you can choose to block them indefinitely or for a specific amount of time. If you block someone for a specific amount of time, they are automatically unblocked after the chosen time expires. If you block someone indefinitely, you can unblock them manually at any time. For more information, see [AUTOTITLE](/communities/maintaining-your-safety-on-github/unblocking-a-user-from-your-organization). diff --git a/data/reusables/organizations/child-team-inherits-permissions.md b/data/reusables/organizations/child-team-inherits-permissions.md index 5e926fa94eb6..96dae7a42400 100644 --- a/data/reusables/organizations/child-team-inherits-permissions.md +++ b/data/reusables/organizations/child-team-inherits-permissions.md @@ -1 +1 @@ -Child teams inherit the access permissions of the parent team. For more information on team hierarchies, see "[AUTOTITLE](/organizations/organizing-members-into-teams/about-teams#nested-teams)." +Child teams inherit the access permissions of the parent team. For more information on team hierarchies, see [AUTOTITLE](/organizations/organizing-members-into-teams/about-teams#nested-teams). diff --git a/data/reusables/organizations/create-team-choose-parent.md b/data/reusables/organizations/create-team-choose-parent.md index 35867678d5ef..3c0fd8aa9c71 100644 --- a/data/reusables/organizations/create-team-choose-parent.md +++ b/data/reusables/organizations/create-team-choose-parent.md @@ -1 +1 @@ -1. Optionally, if you're creating a child team, under "Parent team", select the **Select a parent team** dropdown menu and click a parent team. For more information about child teams, see "[AUTOTITLE](/organizations/organizing-members-into-teams/about-teams#nested-teams)." +1. Optionally, if you're creating a child team, under "Parent team", select the **Select a parent team** dropdown menu and click a parent team. For more information about child teams, see [AUTOTITLE](/organizations/organizing-members-into-teams/about-teams#nested-teams). diff --git a/data/reusables/organizations/custom-org-roles-create-new-step.md b/data/reusables/organizations/custom-org-roles-create-new-step.md index c1bb0b5d9ba6..89de2a03bb03 100644 --- a/data/reusables/organizations/custom-org-roles-create-new-step.md +++ b/data/reusables/organizations/custom-org-roles-create-new-step.md @@ -3,12 +3,12 @@ 1. Under "Add permissions", click the **Organization** or **Repository** tab to select the type of permissions you want to add to the custom role. * To add permissions for the organization, click the **Organization** tab, then select the dropdown menu and click the permissions you want your custom role to include. - * To choose a base repository role to inherit, click the **Repository** tab, then select the dropdown menu and click the base role you want to include in the custom role. For more information about the available base repository roles, see "[Base roles for repository access](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#base-roles-for-repository-access)." + * To choose a base repository role to inherit, click the **Repository** tab, then select the dropdown menu and click the base role you want to include in the custom role. For more information about the available base repository roles, see [Base roles for repository access](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#base-roles-for-repository-access). - Once you've selected a base repository role, you can add additional permissions to the custom role. For more information about the available permissions, see "[Additional permissions for repository access](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#additional-permissions-for-repository-access)." + Once you've selected a base repository role, you can add additional permissions to the custom role. For more information about the available permissions, see [Additional permissions for repository access](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#additional-permissions-for-repository-access). >[!NOTE] Adding a repository role and permissions to a custom organization role is currently in {% data variables.release-phases.public_preview %} and subject to change. {% else %} -1. Under "Add permissions", click the text field, then select the permissions you want to add to the custom role. For more information about the available permissions, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#additional-permissions-for-custom-roles)."{% endif %} +1. Under "Add permissions", click the text field, then select the permissions you want to add to the custom role. For more information about the available permissions, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles#additional-permissions-for-custom-roles).{% endif %} 1. Click **Create role**. diff --git a/data/reusables/organizations/data_saved_for_reinstating_a_former_org_member.md b/data/reusables/organizations/data_saved_for_reinstating_a_former_org_member.md index 97e74e215c40..090bffd7957b 100644 --- a/data/reusables/organizations/data_saved_for_reinstating_a_former_org_member.md +++ b/data/reusables/organizations/data_saved_for_reinstating_a_former_org_member.md @@ -1,2 +1,2 @@ > [!NOTE] -> When you remove a user from your organization, their membership data is saved for three months. You can restore their data, or any private forks they owned of your organization's repositories, if you invite the user to rejoin the organization within that time frame. For more information, see "[AUTOTITLE](/organizations/managing-membership-in-your-organization/reinstating-a-former-member-of-your-organization)." +> When you remove a user from your organization, their membership data is saved for three months. You can restore their data, or any private forks they owned of your organization's repositories, if you invite the user to rejoin the organization within that time frame. For more information, see [AUTOTITLE](/organizations/managing-membership-in-your-organization/reinstating-a-former-member-of-your-organization). diff --git a/data/reusables/organizations/new-org-permissions-more-info.md b/data/reusables/organizations/new-org-permissions-more-info.md index b9c98a362b99..6cca95d2045b 100644 --- a/data/reusables/organizations/new-org-permissions-more-info.md +++ b/data/reusables/organizations/new-org-permissions-more-info.md @@ -1 +1 @@ -For more information, see "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization)." +For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization). diff --git a/data/reusables/organizations/new-repo-permissions-more-info.md b/data/reusables/organizations/new-repo-permissions-more-info.md index 7575310e7d57..e1a0b7657d61 100644 --- a/data/reusables/organizations/new-repo-permissions-more-info.md +++ b/data/reusables/organizations/new-repo-permissions-more-info.md @@ -1 +1 @@ -For more information, see "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)." +For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization). diff --git a/data/reusables/organizations/organization-rulesets-targeting-repositories-step.md b/data/reusables/organizations/organization-rulesets-targeting-repositories-step.md index 17e02f00ecfd..d80dd5345902 100644 --- a/data/reusables/organizations/organization-rulesets-targeting-repositories-step.md +++ b/data/reusables/organizations/organization-rulesets-targeting-repositories-step.md @@ -2,11 +2,11 @@ With your ruleset, you can choose to target all repositories in your organizatio {% ifversion repository-properties %} -For more information about custom properties, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization)." +For more information about custom properties, see [AUTOTITLE](/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization). {% endif %} -If a repository is targeted by a ruleset created at the organization level, only owners of the organization can edit the ruleset. However, people with admin access to the repository, or with a custom role including the "edit repository rules" permission, can create additional rulesets at the repository level. The rules in these rulesets will be aggregated with the rules defined at the organization level. The result is that creating a new ruleset can make the rules targeting a branch or tag more restrictive, but never less restrictive. For more information on creating rulesets, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets)." +If a repository is targeted by a ruleset created at the organization level, only owners of the organization can edit the ruleset. However, people with admin access to the repository, or with a custom role including the "edit repository rules" permission, can create additional rulesets at the repository level. The rules in these rulesets will be aggregated with the rules defined at the organization level. The result is that creating a new ruleset can make the rules targeting a branch or tag more restrictive, but never less restrictive. For more information on creating rulesets, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets). #### Targeting all repositories in your organization @@ -16,7 +16,7 @@ To target all repositories in your organization, in the "Target repositories" se 1. To target a dynamic list of repositories in your organization by naming convention, in the "Target repositories" section, select **{% octicon "goal" aria-hidden="true" %} Target: REPOSITORIES**, then click **Dynamic list of repositories**. 1. To begin defining a targeting pattern, in the "Targeting criteria" section, select **Add a target** {% octicon "triangle-down" aria-hidden="true" %}, then click **Include by pattern** or **Exclude by pattern**. -1. In the modal dialog that appears, enter a repository naming pattern using `fnmatch` syntax, then click **Add Inclusion pattern** or **Add Exclusion pattern**. For more information on `fnmatch` syntax, see "[Using `fnmatch` syntax](#using-fnmatch-syntax)." +1. In the modal dialog that appears, enter a repository naming pattern using `fnmatch` syntax, then click **Add Inclusion pattern** or **Add Exclusion pattern**. For more information on `fnmatch` syntax, see [Using `fnmatch` syntax](#using-fnmatch-syntax). > [!NOTE] > You can add multiple targeting criteria to the same ruleset. For example, you could include any repositories matching the pattern `*cat*`, then specifically exclude a repository matching the pattern `not-a-cat`. @@ -27,7 +27,7 @@ To target all repositories in your organization, in the "Target repositories" se #### Targeting repositories by properties in your organization -You can target repositories in your organization by custom properties. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization)." +You can target repositories in your organization by custom properties. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-custom-properties-for-repositories-in-your-organization). 1. To target a dynamic list of repositories in your organization by properties, in the "Target repositories" section, select **{% octicon "goal" aria-hidden="true" %} Target: REPOSITORIES**, then click **Dynamic list by property**. 1. To add a target, in the "Targeting criteria" section, select **Add a target** {% octicon "triangle-down" aria-hidden="true" %}, then click **Include by property** or **Exclude by property**. diff --git a/data/reusables/organizations/precedence-for-different-levels.md b/data/reusables/organizations/precedence-for-different-levels.md index a6047d830830..c611f1473578 100644 --- a/data/reusables/organizations/precedence-for-different-levels.md +++ b/data/reusables/organizations/precedence-for-different-levels.md @@ -3,7 +3,7 @@ Roles and permissions are additive. If a person is given different levels of acc {% data reusables.organizations.mixed-roles-warning %} To resolve conflicting access, you can adjust your organization's base permissions or the team's access, or edit the custom role. For more information, see: -* "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/setting-base-permissions-for-an-organization)" -* "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository)" -* "[Editing a repository role](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-custom-repository-roles-for-an-organization#editing-a-repository-role)"{% ifversion custom-org-roles %} -* "[AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-organization-roles#editing-a-custom-role)"{% endif %} +* [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/setting-base-permissions-for-an-organization) +* [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository) +* [Editing a repository role](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/managing-custom-repository-roles-for-an-organization#editing-a-repository-role){% ifversion custom-org-roles %} +* [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/managing-custom-organization-roles#editing-a-custom-role){% endif %} diff --git a/data/reusables/organizations/repo-creation-constants.md b/data/reusables/organizations/repo-creation-constants.md index 576aca90e93c..e4971d40bf41 100644 --- a/data/reusables/organizations/repo-creation-constants.md +++ b/data/reusables/organizations/repo-creation-constants.md @@ -1 +1 @@ -Organization owners can always create any type of repository, and outside collaborators can never create any type of repository. For more information, see "[AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)." +Organization owners can always create any type of repository, and outside collaborators can never create any type of repository. For more information, see [AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility). diff --git a/data/reusables/organizations/restricted-app-access-requests.md b/data/reusables/organizations/restricted-app-access-requests.md index 9db590b7b48f..2ce7f2513aa5 100644 --- a/data/reusables/organizations/restricted-app-access-requests.md +++ b/data/reusables/organizations/restricted-app-access-requests.md @@ -1 +1 @@ -Organization owners can choose whether to allow outside collaborators to request access for unapproved {% data variables.product.prodname_oauth_apps %} and {% data variables.product.prodname_github_apps %}. For more information, see "[AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests)." +Organization owners can choose whether to allow outside collaborators to request access for unapproved {% data variables.product.prodname_oauth_apps %} and {% data variables.product.prodname_github_apps %}. For more information, see [AUTOTITLE](/organizations/managing-programmatic-access-to-your-organization/limiting-oauth-app-and-github-app-access-requests). diff --git a/data/reusables/organizations/security-overview-feature-specific-page.md b/data/reusables/organizations/security-overview-feature-specific-page.md index 14cab09ebd65..9eefe104f540 100644 --- a/data/reusables/organizations/security-overview-feature-specific-page.md +++ b/data/reusables/organizations/security-overview-feature-specific-page.md @@ -1 +1 @@ -1. Optionally, use the sidebar on the left to explore alerts for a specific security feature in greater detail. On each page, you can use filters that are specific to that feature to refine your search. For more information about the available qualifiers, see "[AUTOTITLE](/code-security/security-overview/filtering-alerts-in-security-overview)." +1. Optionally, use the sidebar on the left to explore alerts for a specific security feature in greater detail. On each page, you can use filters that are specific to that feature to refine your search. For more information about the available qualifiers, see [AUTOTITLE](/code-security/security-overview/filtering-alerts-in-security-overview). diff --git a/data/reusables/organizations/team-api.md b/data/reusables/organizations/team-api.md index 0b9b41e9ae87..ab5a6a858418 100644 --- a/data/reusables/organizations/team-api.md +++ b/data/reusables/organizations/team-api.md @@ -1,3 +1,3 @@ These endpoints are only available to authenticated members of the team's [organization](/rest/orgs). OAuth access tokens require the `read:org` [scope](/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps). {% data variables.product.prodname_dotcom %} generates the team's `slug` from the team `name`. -Where `pull` and `push` permissions are accepted, these will map to the **Read** and **Write** roles for an organization repository. For more information about repository roles, see "[AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization)." +Where `pull` and `push` permissions are accepted, these will map to the **Read** and **Write** roles for an organization repository. For more information about repository roles, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization). diff --git a/data/reusables/organizations/team-discussions-deprecation.md b/data/reusables/organizations/team-discussions-deprecation.md index 2219cfec17f1..7d37c3c733d3 100644 --- a/data/reusables/organizations/team-discussions-deprecation.md +++ b/data/reusables/organizations/team-discussions-deprecation.md @@ -3,13 +3,13 @@ > [!NOTE] > Team Discussions are {% data variables.release-phases.retired %}. You can read more about this on the [GitHub Blog](https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/). > -> You can use {% data variables.product.prodname_discussions %} to create organization-level discussions. For more information about {% data variables.product.prodname_discussions %}, see "[AUTOTITLE](/discussions)." +> You can use {% data variables.product.prodname_discussions %} to create organization-level discussions. For more information about {% data variables.product.prodname_discussions %}, see [AUTOTITLE](/discussions). {% elsif ghes %} > [!NOTE] > Team Discussions are now {% data variables.release-phases.retired %}. You can read more about this on the [GitHub Blog](https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/). > -> You can use {% data variables.product.prodname_discussions %} to create organization-level discussions. For more information about{% data variables.product.prodname_discussions %}, see "[AUTOTITLE](/discussions)." +> You can use {% data variables.product.prodname_discussions %} to create organization-level discussions. For more information about{% data variables.product.prodname_discussions %}, see [AUTOTITLE](/discussions). {% endif %} diff --git a/data/reusables/organizations/team-discussions-migration.md b/data/reusables/organizations/team-discussions-migration.md index dc4ccd90647a..6af6bb7a1627 100644 --- a/data/reusables/organizations/team-discussions-migration.md +++ b/data/reusables/organizations/team-discussions-migration.md @@ -2,4 +2,4 @@ > [!NOTE] > Team discussions are {% data variables.release-phases.closing_down %} in {% data variables.product.prodname_ghe_server %} 3.13 in favor of {% data variables.product.prodname_discussions %}. You can transfer your existing team discussions to a repository's discussions by using a migration tool that allows team admins to migrate both public and private team discussions. Click the "Transfer" button in the banner at the top of your team discussions page, then choose the repository in your organization that you want to migrate the discussions to. > -> For more information about {% data variables.product.prodname_discussions %}, see "[AUTOTITLE](/discussions)." +> For more information about {% data variables.product.prodname_discussions %}, see [AUTOTITLE](/discussions). diff --git a/data/reusables/package_registry/about-packaging-and-actions.md b/data/reusables/package_registry/about-packaging-and-actions.md index bdcd36ed22e4..866ab0372302 100644 --- a/data/reusables/package_registry/about-packaging-and-actions.md +++ b/data/reusables/package_registry/about-packaging-and-actions.md @@ -16,12 +16,12 @@ This will let you run the code in the pull request on your machine, which can he In addition to uploading packaging artifacts for testing in a continuous integration workflow, you can create workflows that build your project and publish packages to a package registry. -* **Publish packages to {% data variables.product.prodname_registry %}:** - {% data variables.product.prodname_registry %} can act as a package hosting service for many types of packages. You can choose to share your packages with all of {% data variables.product.prodname_dotcom %}, or private packages to share with collaborators or an organization. For more information, see "[AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages)." +* **Publish packages to {% data variables.product.prodname_registry %}** + {% data variables.product.prodname_registry %} can act as a package hosting service for many types of packages. You can choose to share your packages with all of {% data variables.product.prodname_dotcom %}, or private packages to share with collaborators or an organization. For more information, see [AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages). You may want to publish packages to {% data variables.product.prodname_registry %} on every push into the default branch. This will allow developers on your project to always be able to run and test the latest build from the default branch easily, by installing it from {% data variables.product.prodname_registry %}. * **Publish packages to a package registry:** For many projects, publishing to a package registry is performed whenever a new version of a project is released. For example, a project that produces a JAR file may upload new releases to the Maven Central repository. Or, a .NET project may produce a nuget package and upload it to the NuGet Gallery. - You can automate this by creating a workflow that publishes packages to a package registry on every release creation. For more information, see "[AUTOTITLE](/repositories/releasing-projects-on-github/managing-releases-in-a-repository)." + You can automate this by creating a workflow that publishes packages to a package registry on every release creation. For more information, see [AUTOTITLE](/repositories/releasing-projects-on-github/managing-releases-in-a-repository). diff --git a/data/reusables/package_registry/actions-configuration.md b/data/reusables/package_registry/actions-configuration.md index f9352a018791..e20bb52f83fc 100644 --- a/data/reusables/package_registry/actions-configuration.md +++ b/data/reusables/package_registry/actions-configuration.md @@ -1 +1 @@ -Configuration steps vary by package client. For general information about configuring a workflow for {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/actions/using-workflows)." +Configuration steps vary by package client. For general information about configuring a workflow for {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions/using-workflows). diff --git a/data/reusables/package_registry/add-npmrc-to-repo-step.md b/data/reusables/package_registry/add-npmrc-to-repo-step.md index 1c03025bd665..7ce88b216645 100644 --- a/data/reusables/package_registry/add-npmrc-to-repo-step.md +++ b/data/reusables/package_registry/add-npmrc-to-repo-step.md @@ -1 +1 @@ -1. Add the _.npmrc_ file to the repository where {% data variables.product.prodname_registry %} can find your project. For more information, see "[AUTOTITLE](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository)." +1. Add the _.npmrc_ file to the repository where {% data variables.product.prodname_registry %} can find your project. For more information, see [AUTOTITLE](/repositories/working-with-files/managing-files/adding-a-file-to-a-repository). diff --git a/data/reusables/package_registry/admins-can-configure-package-types.md b/data/reusables/package_registry/admins-can-configure-package-types.md index 3921c20a035c..17ffa5f584a3 100644 --- a/data/reusables/package_registry/admins-can-configure-package-types.md +++ b/data/reusables/package_registry/admins-can-configure-package-types.md @@ -1,6 +1,6 @@ {% ifversion ghes %} > [!NOTE] -> This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see "[AUTOTITLE](/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)." +> This package type may not be available for your instance, because site administrators can enable or disable each supported package type. For more information, see [AUTOTITLE](/admin/packages/configuring-package-ecosystem-support-for-your-enterprise). {% endif %} diff --git a/data/reusables/package_registry/authenticate-packages-github-token.md b/data/reusables/package_registry/authenticate-packages-github-token.md index b8731067105c..6bbdc1712fa5 100644 --- a/data/reusables/package_registry/authenticate-packages-github-token.md +++ b/data/reusables/package_registry/authenticate-packages-github-token.md @@ -1 +1 @@ -For more information about `GITHUB_TOKEN` used in {% data variables.product.prodname_actions %} workflows, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication#using-the-github_token-in-a-workflow)." +For more information about `GITHUB_TOKEN` used in {% data variables.product.prodname_actions %} workflows, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication#using-the-github_token-in-a-workflow). diff --git a/data/reusables/package_registry/authenticate-packages.md b/data/reusables/package_registry/authenticate-packages.md index fc5f87ddcbc2..1450842775c8 100644 --- a/data/reusables/package_registry/authenticate-packages.md +++ b/data/reusables/package_registry/authenticate-packages.md @@ -2,7 +2,7 @@ You need an access token to publish, install, and delete private, internal, and public packages. -You can use a {% data variables.product.pat_v1 %} to authenticate to {% data variables.product.prodname_registry %} or the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API. When you create a {% data variables.product.pat_v1 %}, you can assign the token different scopes depending on your needs. For more information about packages-related scopes for a {% data variables.product.pat_v1 %}, see "[AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries)." +You can use a {% data variables.product.pat_v1 %} to authenticate to {% data variables.product.prodname_registry %} or the {% ifversion fpt or ghec %}{% data variables.product.prodname_dotcom %}{% else %}{% data variables.product.product_name %}{% endif %} API. When you create a {% data variables.product.pat_v1 %}, you can assign the token different scopes depending on your needs. For more information about packages-related scopes for a {% data variables.product.pat_v1 %}, see [AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries). To authenticate to a {% data variables.product.prodname_registry %} registry within a {% data variables.product.prodname_actions %} workflow, you can use: * `GITHUB_TOKEN` to publish packages associated with the workflow repository. diff --git a/data/reusables/package_registry/authenticate-step.md b/data/reusables/package_registry/authenticate-step.md index 72c86ff875bc..6a26474201b7 100644 --- a/data/reusables/package_registry/authenticate-step.md +++ b/data/reusables/package_registry/authenticate-step.md @@ -1 +1 @@ -1. Authenticate to {% data variables.product.prodname_registry %}. For more information, see "[Authenticating to {% data variables.product.prodname_registry %}](#authenticating-to-github-packages)." +1. Authenticate to {% data variables.product.prodname_registry %}. For more information, see [Authenticating to {% data variables.product.prodname_registry %}](#authenticating-to-github-packages). diff --git a/data/reusables/package_registry/authenticate-to-container-registry-steps.md b/data/reusables/package_registry/authenticate-to-container-registry-steps.md index 63dfa8547049..c1be30d52a4c 100644 --- a/data/reusables/package_registry/authenticate-to-container-registry-steps.md +++ b/data/reusables/package_registry/authenticate-to-container-registry-steps.md @@ -3,13 +3,13 @@ 1. Create a new {% data variables.product.pat_v1 %} with the appropriate scopes for the tasks you want to accomplish. If your organization requires SSO, you must enable SSO for your new token. > [!NOTE] - > By default, when you select the `write:packages` scope for your {% data variables.product.pat_v1 %} in the user interface, the `repo` scope will also be selected. The `repo` scope offers unnecessary and broad access, which we recommend you avoid using for {% data variables.product.prodname_actions %} workflows in particular. For more information, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#considering-cross-repository-access)." As a workaround, you can select just the `write:packages` scope for your {% data variables.product.pat_v1 %} in the user interface with this url: `https://{% ifversion fpt or ghec %}github.com{% else %}HOSTNAME{% endif %}/settings/tokens/new?scopes=write:packages`. + > By default, when you select the `write:packages` scope for your {% data variables.product.pat_v1 %} in the user interface, the `repo` scope will also be selected. The `repo` scope offers unnecessary and broad access, which we recommend you avoid using for {% data variables.product.prodname_actions %} workflows in particular. For more information, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#considering-cross-repository-access). As a workaround, you can select just the `write:packages` scope for your {% data variables.product.pat_v1 %} in the user interface with this url: `https://{% ifversion fpt or ghec %}github.com{% else %}HOSTNAME{% endif %}/settings/tokens/new?scopes=write:packages`. * Select the `read:packages` scope to download container images and read their metadata. * Select the `write:packages` scope to download and upload container images and read and write their metadata. * Select the `delete:packages` scope to delete container images. - For more information, see "[AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token)." + For more information, see [AUTOTITLE](/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token). 1. Save your {% data variables.product.pat_v1 %}. We recommend saving your token as an environment variable. diff --git a/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md b/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md index 536fc72468c8..36b87593a946 100644 --- a/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md +++ b/data/reusables/package_registry/authenticate_with_pat_for_v2_registry.md @@ -1,7 +1,7 @@ -For registries that support granular permissions, if your {% data variables.product.prodname_actions %} workflow is using a {% data variables.product.pat_generic %} to authenticate to a registry, we highly recommend you update your workflow to use the `GITHUB_TOKEN`. For guidance on updating your workflows that authenticate to a registry with a {% data variables.product.pat_generic %}, see "[AUTOTITLE](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions#upgrading-a-workflow-that-accesses-a-registry-using-a-personal-access-token)." +For registries that support granular permissions, if your {% data variables.product.prodname_actions %} workflow is using a {% data variables.product.pat_generic %} to authenticate to a registry, we highly recommend you update your workflow to use the `GITHUB_TOKEN`. For guidance on updating your workflows that authenticate to a registry with a {% data variables.product.pat_generic %}, see [AUTOTITLE](/packages/managing-github-packages-using-github-actions-workflows/publishing-and-installing-a-package-with-github-actions#upgrading-a-workflow-that-accesses-a-registry-using-a-personal-access-token). {% data reusables.package_registry.delete-with-github-token-using-api-beta %} You can use a `GITHUB_TOKEN` in a {% data variables.product.prodname_actions %} workflow to delete or restore a package using the REST API, if the token has `admin` permission to the package. Repositories that publish packages using a workflow, and repositories that you have explicitly connected to packages, are automatically granted `admin` permission to packages in the repository. -For more information about the `GITHUB_TOKEN`, see "[AUTOTITLE](/actions/security-guides/automatic-token-authentication#using-the-github_token-in-a-workflow)." For more information about the best practices when using a registry in actions, see "[AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#considering-cross-repository-access)." +For more information about the `GITHUB_TOKEN`, see [AUTOTITLE](/actions/security-guides/automatic-token-authentication#using-the-github_token-in-a-workflow). For more information about the best practices when using a registry in actions, see [AUTOTITLE](/actions/security-guides/security-hardening-for-github-actions#considering-cross-repository-access). diff --git a/data/reusables/package_registry/auto-inherit-permissions-note.md b/data/reusables/package_registry/auto-inherit-permissions-note.md index 0765c33c07e1..8e587d7978aa 100644 --- a/data/reusables/package_registry/auto-inherit-permissions-note.md +++ b/data/reusables/package_registry/auto-inherit-permissions-note.md @@ -1,6 +1,6 @@ {% ifversion packages-inherit-permissions %} > [!NOTE] -> If you publish a package that is linked to a repository, the package automatically inherits the access permissions of the linked repository, and {% data variables.product.prodname_actions %} workflows in the linked repository automatically get access to the package, unless your organization has disabled automatic inheritance of access permissions. For more information, see "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#about-inheritance-of-access-permissions)." +> If you publish a package that is linked to a repository, the package automatically inherits the access permissions of the linked repository, and {% data variables.product.prodname_actions %} workflows in the linked repository automatically get access to the package, unless your organization has disabled automatic inheritance of access permissions. For more information, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#about-inheritance-of-access-permissions). {% endif %} diff --git a/data/reusables/package_registry/container-registry-ghes-beta.md b/data/reusables/package_registry/container-registry-ghes-beta.md index 345816a3d523..15676af31215 100644 --- a/data/reusables/package_registry/container-registry-ghes-beta.md +++ b/data/reusables/package_registry/container-registry-ghes-beta.md @@ -2,6 +2,6 @@ >[!NOTE] {% data variables.product.prodname_container_registry %} is currently in {% data variables.release-phases.public_preview %} for {% data variables.product.product_name %} and subject to change. -Both {% data variables.product.prodname_registry %} and subdomain isolation must be enabled to use {% data variables.product.prodname_container_registry %}. For more information, see "[AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-container-registry)." +Both {% data variables.product.prodname_registry %} and subdomain isolation must be enabled to use {% data variables.product.prodname_container_registry %}. For more information, see [AUTOTITLE](/packages/working-with-a-github-packages-registry/working-with-the-container-registry). {% endif %} diff --git a/data/reusables/package_registry/docker_registry_deprecation_status.md b/data/reusables/package_registry/docker_registry_deprecation_status.md index 068ee874ac1d..45283a75b6d1 100644 --- a/data/reusables/package_registry/docker_registry_deprecation_status.md +++ b/data/reusables/package_registry/docker_registry_deprecation_status.md @@ -1,2 +1,2 @@ > [!NOTE] -> The {% data variables.product.prodname_registry %} Docker registry {% ifversion ghes %} will be superseded in a future {% data variables.product.product_name %} release with the {% data variables.product.prodname_container_registry %}, which offers improved container support.{% elsif fpt %} is superseded by the {% data variables.product.prodname_container_registry %}, which offers improved container support. {% endif %} {% ifversion fpt or ghec %} For more information, see "[AUTOTITLE](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry)." {% endif %} +> The {% data variables.product.prodname_registry %} Docker registry {% ifversion ghes %} will be superseded in a future {% data variables.product.product_name %} release with the {% data variables.product.prodname_container_registry %}, which offers improved container support.{% elsif fpt %} is superseded by the {% data variables.product.prodname_container_registry %}, which offers improved container support. {% endif %} {% ifversion fpt or ghec %} For more information, see [AUTOTITLE](/packages/working-with-a-github-packages-registry/migrating-to-the-container-registry-from-the-docker-registry). {% endif %} diff --git a/data/reusables/package_registry/next-steps-for-packages-enterprise-setup.md b/data/reusables/package_registry/next-steps-for-packages-enterprise-setup.md index 8eb30602fff0..36765932ea52 100644 --- a/data/reusables/package_registry/next-steps-for-packages-enterprise-setup.md +++ b/data/reusables/package_registry/next-steps-for-packages-enterprise-setup.md @@ -1,3 +1,3 @@ -As a next step, you can customize which package ecosystems you would like to make available to end users on {% data variables.product.github %}. For more information, see "[AUTOTITLE](/admin/packages/configuring-package-ecosystem-support-for-your-enterprise)." +As a next step, you can customize which package ecosystems you would like to make available to end users on {% data variables.product.github %}. For more information, see [AUTOTITLE](/admin/packages/configuring-package-ecosystem-support-for-your-enterprise). -For an overview of getting started with {% data variables.product.prodname_registry %} on {% data variables.product.prodname_dotcom %}, see "[AUTOTITLE](/admin/packages/getting-started-with-github-packages-for-your-enterprise)." +For an overview of getting started with {% data variables.product.prodname_registry %} on {% data variables.product.prodname_dotcom %}, see [AUTOTITLE](/admin/packages/getting-started-with-github-packages-for-your-enterprise). diff --git a/data/reusables/package_registry/no-graphql-to-delete-packages.md b/data/reusables/package_registry/no-graphql-to-delete-packages.md index d6e5ebf45226..ca9c3d8d8cfd 100644 --- a/data/reusables/package_registry/no-graphql-to-delete-packages.md +++ b/data/reusables/package_registry/no-graphql-to-delete-packages.md @@ -1,3 +1,3 @@ {% ifversion packages-registries-v2 %} -You cannot use the {% data variables.product.prodname_registry %} GraphQL API with registries that support granular permissions. For the registries that **only** support repository-scoped permissions, and can be used with the GraphQL API, see "[AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)." +You cannot use the {% data variables.product.prodname_registry %} GraphQL API with registries that support granular permissions. For the registries that **only** support repository-scoped permissions, and can be used with the GraphQL API, see [AUTOTITLE](/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages). {% endif %} diff --git a/data/reusables/package_registry/publishing-user-scoped-packages.md b/data/reusables/package_registry/publishing-user-scoped-packages.md index 28827004ff01..4fba127e0e2e 100644 --- a/data/reusables/package_registry/publishing-user-scoped-packages.md +++ b/data/reusables/package_registry/publishing-user-scoped-packages.md @@ -1 +1 @@ -When you first publish a package, the default visibility is private. To change the visibility or set access permissions, see "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)." +When you first publish a package, the default visibility is private. To change the visibility or set access permissions, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility). diff --git a/data/reusables/package_registry/required-scopes.md b/data/reusables/package_registry/required-scopes.md index 7b79ea967717..551f9ae8bbcf 100644 --- a/data/reusables/package_registry/required-scopes.md +++ b/data/reusables/package_registry/required-scopes.md @@ -1 +1 @@ -You must use a {% data variables.product.pat_v1 %} with the appropriate scopes to publish and install packages in {% data variables.product.prodname_registry %}. For more information, see "[AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages)." +You must use a {% data variables.product.pat_v1 %} with the appropriate scopes to publish and install packages in {% data variables.product.prodname_registry %}. For more information, see [AUTOTITLE](/packages/learn-github-packages/introduction-to-github-packages#authenticating-to-github-packages). diff --git a/data/reusables/package_registry/v2-actions-codespaces.md b/data/reusables/package_registry/v2-actions-codespaces.md index 34c28d911da6..51652d2546e0 100644 --- a/data/reusables/package_registry/v2-actions-codespaces.md +++ b/data/reusables/package_registry/v2-actions-codespaces.md @@ -1 +1 @@ -You can also choose to give access permissions to packages independently for{% ifversion fpt or ghec %} {% data variables.product.prodname_github_codespaces %} and{% endif %} {% data variables.product.prodname_actions %}. For more information, see "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package)" and "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)." +You can also choose to give access permissions to packages independently for{% ifversion fpt or ghec %} {% data variables.product.prodname_github_codespaces %} and{% endif %} {% data variables.product.prodname_actions %}. For more information, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-codespaces-access-to-your-package) and [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package). diff --git a/data/reusables/package_registry/verify_repository_field.md b/data/reusables/package_registry/verify_repository_field.md index 462e08bc54ea..58ba6af4b6c0 100644 --- a/data/reusables/package_registry/verify_repository_field.md +++ b/data/reusables/package_registry/verify_repository_field.md @@ -1 +1 @@ -1. Verify the `repository` field in your project's _package.json_. The `repository` field must match the URL for your {% data variables.product.prodname_dotcom %} repository. For example, if your repository URL is `github.com/my-org/test` then the repository field should be `https://github.com/my-org/test.git`. +1. Verify the `repository` field in your project's `package.json`. The `repository` field must match the URL for your {% data variables.product.prodname_dotcom %} repository. For example, if your repository URL is `github.com/my-org/test` then the repository field should be `https://github.com/my-org/test.git`. diff --git a/data/reusables/package_registry/viewing-packages.md b/data/reusables/package_registry/viewing-packages.md index 3c8d076ae2b9..0a91b43ffebd 100644 --- a/data/reusables/package_registry/viewing-packages.md +++ b/data/reusables/package_registry/viewing-packages.md @@ -1 +1 @@ -After you publish a package, you can view the package on {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/packages/learn-github-packages/viewing-packages)." +After you publish a package, you can view the package on {% data variables.product.prodname_dotcom %}. For more information, see [AUTOTITLE](/packages/learn-github-packages/viewing-packages). diff --git a/data/reusables/package_registry/visibility-and-access-permissions.md b/data/reusables/package_registry/visibility-and-access-permissions.md index c9621ccf36d2..129581ae99a0 100644 --- a/data/reusables/package_registry/visibility-and-access-permissions.md +++ b/data/reusables/package_registry/visibility-and-access-permissions.md @@ -1,11 +1,11 @@ -If a package belongs to a registry that supports granular permissions, anyone with admin permissions to the package can set the package to private or public, and can grant access permissions for the package that are separate from the permissions set at the organization and repository levels. 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)." +If a package belongs to a registry that supports granular permissions, anyone with admin permissions to the package can set the package to private or public, and can grant access permissions for the package that are separate from the permissions set at the organization and repository levels. 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). In most registries, to pull a package, you must authenticate with a {% data variables.product.pat_generic %} or `GITHUB_TOKEN`, regardless of whether the package is public or private. However, in the {% data variables.product.prodname_container_registry %}, public packages allow anonymous access and can be pulled without authentication or signing in via the CLI. {% ifversion packages-inherit-permissions %} > [!NOTE] -> If you publish a package that is linked to a repository, the package inherits its permissions from the linked repository by default. To access the package's granular permissions settings, you must remove the package's inherited permissions. If you're the owner of an organization, you can disable the automatic inheritance of permissions for all new packages scoped to your organization. For more information, see "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#selecting-whether-a-package-inherits-permissions-from-a-repository)" and "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#disabling-automatic-inheritance-of-access-permissions-in-an-organization)." +> If you publish a package that is linked to a repository, the package inherits its permissions from the linked repository by default. To access the package's granular permissions settings, you must remove the package's inherited permissions. If you're the owner of an organization, you can disable the automatic inheritance of permissions for all new packages scoped to your organization. For more information, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#selecting-whether-a-package-inherits-permissions-from-a-repository) and [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#disabling-automatic-inheritance-of-access-permissions-in-an-organization). {% endif %} @@ -13,7 +13,7 @@ When you publish a package, you automatically get admin permissions to the packa For packages scoped to a personal account, you can give any person an access role. For packages scoped to an organization, you can give any person or team in the organization an access role. -If you are using a {% data variables.product.prodname_actions %} workflow to manage your packages, you can grant an access role to the repository the workflow is stored in {% data variables.package_registry.package-settings-actions-access-menu %}. For more information, see "[AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package)." +If you are using a {% data variables.product.prodname_actions %} workflow to manage your packages, you can grant an access role to the repository the workflow is stored in {% data variables.package_registry.package-settings-actions-access-menu %}. For more information, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package). | Permission | Access description | |------------|--------------------| diff --git a/data/reusables/pages/about-front-matter.md b/data/reusables/pages/about-front-matter.md index 86ced932d97e..1c7882ac2346 100644 --- a/data/reusables/pages/about-front-matter.md +++ b/data/reusables/pages/about-front-matter.md @@ -1 +1 @@ -To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see "[Front Matter](https://jekyllrb.com/docs/front-matter/)" in the Jekyll documentation. +To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see [Front Matter](https://jekyllrb.com/docs/front-matter/) in the Jekyll documentation. diff --git a/data/reusables/pages/best-with-supported-themes.md b/data/reusables/pages/best-with-supported-themes.md index 1c207b80b9c1..d37f42711aa8 100644 --- a/data/reusables/pages/best-with-supported-themes.md +++ b/data/reusables/pages/best-with-supported-themes.md @@ -1,3 +1,3 @@ {% ifversion fpt or ghec %} -These instructions work best with themes that are officially supported by {% data variables.product.prodname_pages %}. For a complete list of supported themes, see "[Supported themes](https://pages.github.com/themes/)" on the {% data variables.product.prodname_pages %} site. +These instructions work best with themes that are officially supported by {% data variables.product.prodname_pages %}. For a complete list of supported themes, see [Supported themes](https://pages.github.com/themes/) on the {% data variables.product.prodname_pages %} site. {% endif %} diff --git a/data/reusables/pages/build-locally-download-cname.md b/data/reusables/pages/build-locally-download-cname.md index 2ae722bff90a..126b60faa52e 100644 --- a/data/reusables/pages/build-locally-download-cname.md +++ b/data/reusables/pages/build-locally-download-cname.md @@ -1 +1 @@ -1. If you use a static site generator to build your site locally and push the generated files to {% data variables.product.product_name %}, pull the commit that added the CNAME file to your local repository. For more information, see "[AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages#cname-errors)." +1. If you use a static site generator to build your site locally and push the generated files to {% data variables.product.product_name %}, pull the commit that added the CNAME file to your local repository. For more information, see [AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages#cname-errors). diff --git a/data/reusables/pages/check-workflow-run.md b/data/reusables/pages/check-workflow-run.md index 038c5e281062..5d2318a30ff7 100644 --- a/data/reusables/pages/check-workflow-run.md +++ b/data/reusables/pages/check-workflow-run.md @@ -1,7 +1,7 @@ {% ifversion build-pages-with-actions %} -1. Your {% data variables.product.prodname_pages %} site is built and deployed with a {% data variables.product.prodname_actions %} workflow. For more information, see "[AUTOTITLE](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history)". +1. Your {% data variables.product.prodname_pages %} site is built and deployed with a {% data variables.product.prodname_actions %} workflow. For more information, see [AUTOTITLE](/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history). > [!NOTE] - > {% data variables.product.prodname_actions %} is free for public repositories. Usage charges apply for private and internal repositories that go beyond the monthly allotment of free minutes. For more information, see "[AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration)". + > {% data variables.product.prodname_actions %} is free for public repositories. Usage charges apply for private and internal repositories that go beyond the monthly allotment of free minutes. For more information, see [AUTOTITLE](/actions/learn-github-actions/usage-limits-billing-and-administration). {% endif %} diff --git a/data/reusables/pages/configure-publishing-source.md b/data/reusables/pages/configure-publishing-source.md index f2efa9c7a47d..d3a2b7a63d2c 100644 --- a/data/reusables/pages/configure-publishing-source.md +++ b/data/reusables/pages/configure-publishing-source.md @@ -1 +1 @@ -1. Configure your publishing source. For more information, see "[AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." +1. Configure your publishing source. For more information, see [AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). diff --git a/data/reusables/pages/create-repo-name.md b/data/reusables/pages/create-repo-name.md index 8225e7e5a754..bab1d2e5a6b6 100644 --- a/data/reusables/pages/create-repo-name.md +++ b/data/reusables/pages/create-repo-name.md @@ -1,3 +1,3 @@ 1. Type a name for your repository and an optional description. If you're creating a user or organization site, your repository must be named `.github.io` or `.github.io`. If your user or organization name contains uppercase letters, you must lowercase the letters. -For more information, see "[AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites)." +For more information, see [AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites). ![Screenshot of {% data variables.product.prodname_pages %} settings in a repository. The repository name field contains the text "octocat.github.io" and is outlined in dark orange.](/assets/images/help/pages/create-repository-name-pages.png) diff --git a/data/reusables/pages/custom-domain-warning.md b/data/reusables/pages/custom-domain-warning.md index 80c22b7d3ee1..7ae9a4f550a4 100644 --- a/data/reusables/pages/custom-domain-warning.md +++ b/data/reusables/pages/custom-domain-warning.md @@ -1,2 +1,2 @@ > [!TIP] -> We recommend verifying your custom domain prior to adding it to your repository, in order to improve security and avoid takeover attacks. For more information, see "[AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages)." +> We recommend verifying your custom domain prior to adding it to your repository, in order to improve security and avoid takeover attacks. For more information, see [AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages). diff --git a/data/reusables/pages/decide-publishing-source.md b/data/reusables/pages/decide-publishing-source.md index 9bbf96249e4f..25ed607fd1bc 100644 --- a/data/reusables/pages/decide-publishing-source.md +++ b/data/reusables/pages/decide-publishing-source.md @@ -1 +1 @@ -1. Decide which publishing source you want to use. For more information, see "[AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." +1. Decide which publishing source you want to use. For more information, see [AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). diff --git a/data/reusables/pages/default-domain-information.md b/data/reusables/pages/default-domain-information.md index 4334df44d232..49ce6980ccc0 100644 --- a/data/reusables/pages/default-domain-information.md +++ b/data/reusables/pages/default-domain-information.md @@ -1 +1 @@ -For more information about the default domain for your site, see "[AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites)." +For more information about the default domain for your site, see [AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites). diff --git a/data/reusables/pages/emu-org-only.md b/data/reusables/pages/emu-org-only.md index d5139dd2b071..66be8fbabc73 100644 --- a/data/reusables/pages/emu-org-only.md +++ b/data/reusables/pages/emu-org-only.md @@ -1,6 +1,6 @@ {% ifversion ghec %} > [!NOTE] -> If you're a {% data variables.enterprise.prodname_managed_user %}, you can only publish {% data variables.product.prodname_pages %} sites from repositories owned by organizations. For more information, see "[AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users)." +> If you're a {% data variables.enterprise.prodname_managed_user %}, you can only publish {% data variables.product.prodname_pages %} sites from repositories owned by organizations. For more information, see [AUTOTITLE](/pages/getting-started-with-github-pages/about-github-pages#limitations-for-enterprise-managed-users). {% endif %} diff --git a/data/reusables/pages/enforce-https-custom-domain.md b/data/reusables/pages/enforce-https-custom-domain.md index e2c22c4bc538..f14c781476e6 100644 --- a/data/reusables/pages/enforce-https-custom-domain.md +++ b/data/reusables/pages/enforce-https-custom-domain.md @@ -1 +1 @@ -1. Optionally, to enforce HTTPS encryption for your site, select **Enforce HTTPS**. It can take up to 24 hours before this option is available. For more information, see "[AUTOTITLE](/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https)." +1. Optionally, to enforce HTTPS encryption for your site, select **Enforce HTTPS**. It can take up to 24 hours before this option is available. For more information, see [AUTOTITLE](/pages/getting-started-with-github-pages/securing-your-github-pages-site-with-https). diff --git a/data/reusables/pages/ip-allow-list-pages.md b/data/reusables/pages/ip-allow-list-pages.md index c2a4399a3fcf..439077a043d3 100644 --- a/data/reusables/pages/ip-allow-list-pages.md +++ b/data/reusables/pages/ip-allow-list-pages.md @@ -1,3 +1,3 @@ If you use a custom {% data variables.product.prodname_actions %} workflow as a publishing source for your {% data variables.product.prodname_pages %} site, to permit the runner to connect and build the site, you must configure a rule for your IP allow list. -If you don't use a custom workflow, the build runner will have access to the repository for the {% data variables.product.prodname_pages %} site by default. For more information about publishing sources, see "[Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." +If you don't use a custom workflow, the build runner will have access to the repository for the {% data variables.product.prodname_pages %} site by default. For more information about publishing sources, see [Configuring a publishing source for your GitHub Pages site](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). diff --git a/data/reusables/pages/jekyll-install-troubleshooting.md b/data/reusables/pages/jekyll-install-troubleshooting.md index 8214364c261b..799d9ffe2a66 100644 --- a/data/reusables/pages/jekyll-install-troubleshooting.md +++ b/data/reusables/pages/jekyll-install-troubleshooting.md @@ -1,6 +1,6 @@ {% mac %} > [!TIP] -> If you see a Ruby error when you try to install Jekyll using Bundler, you may need to use a package manager, such as [RVM](https://rvm.io/) or [Homebrew](https://brew.sh/), to manage your Ruby installation. For more information, see "[Troubleshooting](https://jekyllrb.com/docs/troubleshooting/#jekyll--macos)" in the Jekyll documentation. +> If you see a Ruby error when you try to install Jekyll using Bundler, you may need to use a package manager, such as [RVM](https://rvm.io/) or [Homebrew](https://brew.sh/), to manage your Ruby installation. For more information, see [Troubleshooting](https://jekyllrb.com/docs/troubleshooting/#jekyll--macos) in the Jekyll documentation. {% endmac %} diff --git a/data/reusables/pages/must-have-repo-first.md b/data/reusables/pages/must-have-repo-first.md index 9ff4bc2b2d77..86deee1a4771 100644 --- a/data/reusables/pages/must-have-repo-first.md +++ b/data/reusables/pages/must-have-repo-first.md @@ -1 +1 @@ -Before you can create your site, you must have a repository for your site on {% data variables.product.product_name %}. If you're not creating your site in an existing repository, see "[Creating a repository for your site](#creating-a-repository-for-your-site)." +Before you can create your site, you must have a repository for your site on {% data variables.product.product_name %}. If you're not creating your site in an existing repository, see [Creating a repository for your site](#creating-a-repository-for-your-site). diff --git a/data/reusables/pages/navigate-publishing-source.md b/data/reusables/pages/navigate-publishing-source.md index d7603028fcf5..ab4c4264b7d2 100644 --- a/data/reusables/pages/navigate-publishing-source.md +++ b/data/reusables/pages/navigate-publishing-source.md @@ -1 +1 @@ -1. Navigate to the publishing source for your site. For more information, see "[AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)." +1. Navigate to the publishing source for your site. For more information, see [AUTOTITLE](/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site). diff --git a/data/reusables/pages/new-or-existing-repo.md b/data/reusables/pages/new-or-existing-repo.md index afe17b4dffc8..6c8efe1be81a 100644 --- a/data/reusables/pages/new-or-existing-repo.md +++ b/data/reusables/pages/new-or-existing-repo.md @@ -4,4 +4,4 @@ If you want to create a {% data variables.product.prodname_pages %} site for a r {% ifversion fpt or ghec %}If the account that owns the repository uses {% data variables.product.prodname_free_user %} or {% data variables.product.prodname_free_team %} for organizations, the repository must be public.{% endif %} - If you want to create a site in an existing repository, skip to the "[Creating your site](#creating-your-site)" section. + If you want to create a site in an existing repository, skip to the [Creating your site](#creating-your-site) section. diff --git a/data/reusables/pages/org-owners-can-restrict-pages-creation.md b/data/reusables/pages/org-owners-can-restrict-pages-creation.md index 5bb1b8caf8e3..23c46500430a 100644 --- a/data/reusables/pages/org-owners-can-restrict-pages-creation.md +++ b/data/reusables/pages/org-owners-can-restrict-pages-creation.md @@ -1,2 +1,2 @@ > [!NOTE] -> Organization owners can restrict the publication of {% data variables.product.prodname_pages %} sites from repositories owned by the organization. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization)." +> Organization owners can restrict the publication of {% data variables.product.prodname_pages %} sites from repositories owned by the organization. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-the-publication-of-github-pages-sites-for-your-organization). diff --git a/data/reusables/pages/recommend-bundler.md b/data/reusables/pages/recommend-bundler.md index bf380a20a825..d4df6f2ff3c8 100644 --- a/data/reusables/pages/recommend-bundler.md +++ b/data/reusables/pages/recommend-bundler.md @@ -1,4 +1,4 @@ We recommend using [Bundler](https://bundler.io/) to install and run Jekyll. Bundler manages Ruby gem dependencies, reduces Jekyll build errors, and prevents environment-related bugs. To install Bundler: - 1. Install Ruby. For more information, see "[Installing Ruby](https://www.ruby-lang.org/en/documentation/installation/)" in the Ruby documentation. - 1. Install Bundler. For more information, see "[Bundler](https://bundler.io/)." + 1. Install Ruby. For more information, see [Installing Ruby](https://www.ruby-lang.org/en/documentation/installation/) in the Ruby documentation. + 1. Install Bundler. For more information, see [Bundler](https://bundler.io/). diff --git a/data/reusables/pages/symlink-removal.md b/data/reusables/pages/symlink-removal.md index c19b53ad0459..131b386ba0ad 100644 --- a/data/reusables/pages/symlink-removal.md +++ b/data/reusables/pages/symlink-removal.md @@ -1,2 +1,2 @@ > [!NOTE] -> If your repository contains symbolic links, you will need to publish your site using a {% data variables.product.prodname_actions %} workflow. For more information about {% data variables.product.prodname_actions %}, see "[AUTOTITLE](/actions)." +> If your repository contains symbolic links, you will need to publish your site using a {% data variables.product.prodname_actions %} workflow. For more information about {% data variables.product.prodname_actions %}, see [AUTOTITLE](/actions). diff --git a/data/reusables/pages/test-locally.md b/data/reusables/pages/test-locally.md index 3fc17b5f5ff7..f1134911ab5a 100644 --- a/data/reusables/pages/test-locally.md +++ b/data/reusables/pages/test-locally.md @@ -1 +1 @@ -{% ifversion pages-custom-workflow %}If you are publishing from a branch, changes{% else %}Changes{% endif %} to your site are published automatically when the changes are merged into your site's publishing source. {% ifversion pages-custom-workflow %}If you are publishing from a custom {% data variables.product.prodname_actions %} workflow, changes are published whenever your workflow is triggered (typically by a push to the default branch). {% endif %}If you want to preview your changes first, you can make the changes locally instead of on {% data variables.product.product_name %}. Then, test your site locally. For more information, see "[AUTOTITLE](/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll)." +{% ifversion pages-custom-workflow %}If you are publishing from a branch, changes{% else %}Changes{% endif %} to your site are published automatically when the changes are merged into your site's publishing source. {% ifversion pages-custom-workflow %}If you are publishing from a custom {% data variables.product.prodname_actions %} workflow, changes are published whenever your workflow is triggered (typically by a push to the default branch). {% endif %}If you want to preview your changes first, you can make the changes locally instead of on {% data variables.product.product_name %}. Then, test your site locally. For more information, see [AUTOTITLE](/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll). diff --git a/data/reusables/pages/wildcard-dns-warning.md b/data/reusables/pages/wildcard-dns-warning.md index b1b8c4a2ed08..11d6945a8189 100644 --- a/data/reusables/pages/wildcard-dns-warning.md +++ b/data/reusables/pages/wildcard-dns-warning.md @@ -1,2 +1,2 @@ > [!WARNING] -> We strongly recommend that you do not use wildcard DNS records, such as `*.example.com`. These records put you at an immediate risk of domain takeovers, even if you verify the domain. For example, if you verify `example.com` this prevents someone from using `a.example.com` but they could still take over `b.a.example.com` (which is covered by the wildcard DNS record). For more information, see "[AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages)." +> We strongly recommend that you do not use wildcard DNS records, such as `*.example.com`. These records put you at an immediate risk of domain takeovers, even if you verify the domain. For example, if you verify `example.com` this prevents someone from using `a.example.com` but they could still take over `b.a.example.com` (which is covered by the wildcard DNS record). For more information, see [AUTOTITLE](/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages). diff --git a/data/reusables/passkeys/add-passkey-option.md b/data/reusables/passkeys/add-passkey-option.md index 9046e342f2bf..2f5aff88fc9c 100644 --- a/data/reusables/passkeys/add-passkey-option.md +++ b/data/reusables/passkeys/add-passkey-option.md @@ -1 +1 @@ -Optionally, add a passkey to your account to enable a secure, passwordless login. See "[AUTOTITLE](/authentication/authenticating-with-a-passkey/about-passkeys)." +Optionally, add a passkey to your account to enable a secure, passwordless login. See [AUTOTITLE](/authentication/authenticating-with-a-passkey/about-passkeys). diff --git a/data/reusables/permissions/dependabot-alerts.md b/data/reusables/permissions/dependabot-alerts.md index 2942d2f9bccd..e6327981b941 100644 --- a/data/reusables/permissions/dependabot-alerts.md +++ b/data/reusables/permissions/dependabot-alerts.md @@ -1,2 +1,2 @@ * Repository administrators, organization owners, and people with **write** or **maintain** access -* Users and teams with explicit access. See "[Granting access to security alert](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)." +* Users and teams with explicit access. See [Granting access to security alert](/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts). diff --git a/data/reusables/policies/github-community-guidelines-and-terms.md b/data/reusables/policies/github-community-guidelines-and-terms.md index 81923e5b4e60..ca41bfb1f8a8 100644 --- a/data/reusables/policies/github-community-guidelines-and-terms.md +++ b/data/reusables/policies/github-community-guidelines-and-terms.md @@ -1 +1 @@ -{% data variables.product.company_short %} provides a baseline code of conduct for everyone who uses {% data variables.product.prodname_dotcom %}. For more information, see "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-of-service)" and "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-community-guidelines)." +{% data variables.product.company_short %} provides a baseline code of conduct for everyone who uses {% data variables.product.prodname_dotcom %}. For more information, see [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-of-service) and [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-community-guidelines). diff --git a/data/reusables/pre-release-program/expiring-user-access-tokens.md b/data/reusables/pre-release-program/expiring-user-access-tokens.md index a85fb99b2cb8..a7d528c7f820 100644 --- a/data/reusables/pre-release-program/expiring-user-access-tokens.md +++ b/data/reusables/pre-release-program/expiring-user-access-tokens.md @@ -1 +1 @@ -User access tokens that expire are currently an optional feature and are subject to change. To opt in or out of the token expiration feature, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-github-apps)." For more information, see "[Expiring user-to-server access tokens for GitHub Apps](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)." +User access tokens that expire are currently an optional feature and are subject to change. To opt in or out of the token expiration feature, see [AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-github-apps). For more information, see [Expiring user-to-server access tokens for GitHub Apps](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps). diff --git a/data/reusables/products/which-product-to-use.md b/data/reusables/products/which-product-to-use.md index 93c20c9cc37e..e70260860721 100644 --- a/data/reusables/products/which-product-to-use.md +++ b/data/reusables/products/which-product-to-use.md @@ -1 +1 @@ -If you're not sure whether {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %}, or both are best for your organization, contact {% data variables.contact.contact_enterprise_sales %}. If your organization has 11 or fewer developers, consider {% data variables.product.prodname_team %}; organizations with 12 or more developers typically benefit the most from {% data variables.product.prodname_enterprise %}. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-plans)." +If you're not sure whether {% data variables.product.prodname_ghe_cloud %}, {% data variables.product.prodname_ghe_server %}, or both are best for your organization, contact {% data variables.contact.contact_enterprise_sales %}. If your organization has 11 or fewer developers, consider {% data variables.product.prodname_team %}; organizations with 12 or more developers typically benefit the most from {% data variables.product.prodname_enterprise %}. For more information, see [AUTOTITLE](/get-started/learning-about-github/githubs-plans). diff --git a/data/reusables/profile/profile-readme.md b/data/reusables/profile/profile-readme.md index d431262acff8..5e6d699b71ea 100644 --- a/data/reusables/profile/profile-readme.md +++ b/data/reusables/profile/profile-readme.md @@ -1 +1 @@ -If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with {% data variables.product.company_short %} Flavored Markdown to create a personalized section on your profile. For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme)." +If you add a README file to the root of a public repository with the same name as your username, that README will automatically appear on your profile page. You can edit your profile README with {% data variables.product.company_short %} Flavored Markdown to create a personalized section on your profile. For more information, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme). diff --git a/data/reusables/project-management/copy-project-boards.md b/data/reusables/project-management/copy-project-boards.md index ad2a973e6b1a..ff7e55419907 100644 --- a/data/reusables/project-management/copy-project-boards.md +++ b/data/reusables/project-management/copy-project-boards.md @@ -1,3 +1,3 @@ {% ifversion fpt or ghec %} -You can also copy a {% data variables.projects.projects_v1_board %} to reuse its customizations for similar projects. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/copying-a-project-board)." +You can also copy a {% data variables.projects.projects_v1_board %} to reuse its customizations for similar projects. For more information, see [AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/copying-a-project-board). {% endif %} diff --git a/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md b/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md index 94659914641f..d72a411bb07a 100644 --- a/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md +++ b/data/reusables/project-management/for-more-info-project-keyboard-shortcuts.md @@ -1 +1 @@ -For more information about keyboard shortcuts, see "{% data variables.projects.projects_v1_boards_caps %}" in "[AUTOTITLE](/get-started/accessibility/keyboard-shortcuts#project-boards)." +For more information about keyboard shortcuts, see "{% data variables.projects.projects_v1_boards_caps %}" in [AUTOTITLE](/get-started/accessibility/keyboard-shortcuts#project-boards). diff --git a/data/reusables/project-management/project-board-import-with-api.md b/data/reusables/project-management/project-board-import-with-api.md index f711eabde211..0c325f55a250 100644 --- a/data/reusables/project-management/project-board-import-with-api.md +++ b/data/reusables/project-management/project-board-import-with-api.md @@ -1 +1 @@ -You can use {% data variables.product.prodname_dotcom %}'s API to import a {% data variables.projects.projects_v1_board %}. For more information, see "[AUTOTITLE](/graphql/reference/mutations#importproject/)." +You can use {% data variables.product.prodname_dotcom %}'s API to import a {% data variables.projects.projects_v1_board %}. For more information, see [AUTOTITLE](/graphql/reference/mutations#importproject/). diff --git a/data/reusables/project-management/project-board-permissions.md b/data/reusables/project-management/project-board-permissions.md index 1152a00bcf47..0a50a9680d45 100644 --- a/data/reusables/project-management/project-board-permissions.md +++ b/data/reusables/project-management/project-board-permissions.md @@ -1,3 +1,3 @@ * **Read**, which gives people permission to view a {% data variables.projects.projects_v1_board %}. -* **Write**, which gives people permission to view a {% data variables.projects.projects_v1_board %}, link repositories to a {% data variables.projects.projects_v1_board %}, and interact with a {% data variables.projects.projects_v1_board %}. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/linking-a-repository-to-a-project-board)." +* **Write**, which gives people permission to view a {% data variables.projects.projects_v1_board %}, link repositories to a {% data variables.projects.projects_v1_board %}, and interact with a {% data variables.projects.projects_v1_board %}. For more information, see [AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/linking-a-repository-to-a-project-board). * **Admin**, which gives people permission to view a {% data variables.projects.projects_v1_board %}, interact with a {% data variables.projects.projects_v1_board %}, manage {% data variables.projects.projects_v1_board %} settings, and manage other people's access to the {% data variables.projects.projects_v1_board %}. diff --git a/data/reusables/project-management/resync-automation.md b/data/reusables/project-management/resync-automation.md index 4a71a02642ad..47285da8ff26 100644 --- a/data/reusables/project-management/resync-automation.md +++ b/data/reusables/project-management/resync-automation.md @@ -1 +1 @@ -When you close a {% data variables.projects.projects_v1_board %}, any workflow automation configured for the {% data variables.projects.projects_v1_board %} will pause. If you reopen a {% data variables.projects.projects_v1_board %}, you have the option to sync automation, which updates the position of the cards on the board according to the automation settings configured for the project. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/reopening-a-closed-project-board)" or "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/closing-a-project-board)." +When you close a {% data variables.projects.projects_v1_board %}, any workflow automation configured for the {% data variables.projects.projects_v1_board %} will pause. If you reopen a {% data variables.projects.projects_v1_board %}, you have the option to sync automation, which updates the position of the cards on the board according to the automation settings configured for the project. For more information, see [AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/reopening-a-closed-project-board) or [AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/closing-a-project-board). diff --git a/data/reusables/project-management/use-automated-template.md b/data/reusables/project-management/use-automated-template.md index d812bddcacac..83f8d3cc65b7 100644 --- a/data/reusables/project-management/use-automated-template.md +++ b/data/reusables/project-management/use-automated-template.md @@ -1 +1 @@ -You can use a {% data variables.projects.projects_v1_board %} template to create a {% data variables.projects.projects_v1_board %} with automation already configured. For more information, see "[AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards#templates-for-project-boards)." +You can use a {% data variables.projects.projects_v1_board %} template to create a {% data variables.projects.projects_v1_board %} with automation already configured. For more information, see [AUTOTITLE](/issues/organizing-your-work-with-project-boards/managing-project-boards/about-project-boards#templates-for-project-boards). diff --git a/data/reusables/projects/classic-project-creation.md b/data/reusables/projects/classic-project-creation.md index 21b16b8193b5..b972246bc816 100644 --- a/data/reusables/projects/classic-project-creation.md +++ b/data/reusables/projects/classic-project-creation.md @@ -1,6 +1,6 @@ {% ifversion fpt or ghec %} > [!NOTE] -> You can only create a new {% data variables.projects.projects_v1_board %} for an organization, user, or repository that already has at least one {% data variables.projects.projects_v1_board %}. If you're unable to create a {% data variables.projects.projects_v1_board %}, create a {% data variables.projects.project_v2 %} instead. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project)." +> You can only create a new {% data variables.projects.projects_v1_board %} for an organization, user, or repository that already has at least one {% data variables.projects.projects_v1_board %}. If you're unable to create a {% data variables.projects.projects_v1_board %}, create a {% data variables.projects.project_v2 %} instead. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/creating-projects/creating-a-project). {% endif %} diff --git a/data/reusables/projects/enable_enterprise_workflows.md b/data/reusables/projects/enable_enterprise_workflows.md index 05547b09bf63..663ed8ff7a08 100644 --- a/data/reusables/projects/enable_enterprise_workflows.md +++ b/data/reusables/projects/enable_enterprise_workflows.md @@ -1,2 +1,2 @@ > [!NOTE] -> Project workflow automations must be enabled by an enterprise owner in the enterprise settings page for policies for projects. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise)." +> Project workflow automations must be enabled by an enterprise owner in the enterprise settings page for policies for projects. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-projects-in-your-enterprise). diff --git a/data/reusables/projects/index-select.md b/data/reusables/projects/index-select.md index 2d489341d996..196d8b58a3be 100644 --- a/data/reusables/projects/index-select.md +++ b/data/reusables/projects/index-select.md @@ -1,4 +1,4 @@ -1. Optionally, in the text box above the list of projects, enter a filter to choose which projects are displayed. For more information on filter syntax, see "[Syntax for filtering a list of projects](#syntax-for-filtering-a-list-of-projects)" in this article. +1. Optionally, in the text box above the list of projects, enter a filter to choose which projects are displayed. For more information on filter syntax, see [Syntax for filtering a list of projects](#syntax-for-filtering-a-list-of-projects) in this article. ![Screenshot of the main page for a team. In the horizontal navigation bar, the "Projects" tab is outlined in dark orange.](/assets/images/help/projects-v2/index-filter-box.png) diff --git a/data/reusables/projects/migration-permissions-warning.md b/data/reusables/projects/migration-permissions-warning.md index 0c3ae554ad0e..debc709969a5 100644 --- a/data/reusables/projects/migration-permissions-warning.md +++ b/data/reusables/projects/migration-permissions-warning.md @@ -1 +1 @@ -When you migrate a {% data variables.projects.projects_v1_board %} to an organization, the organization's base permission for projects will not be applied. After migrating your project, make sure to confirm the project's permissions. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects)." +When you migrate a {% data variables.projects.projects_v1_board %} to an organization, the organization's base permission for projects will not be applied. After migrating your project, make sure to confirm the project's permissions. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects). diff --git a/data/reusables/projects/org-templates.md b/data/reusables/projects/org-templates.md index 6b1274836262..0874eabfda3a 100644 --- a/data/reusables/projects/org-templates.md +++ b/data/reusables/projects/org-templates.md @@ -1 +1 @@ -You can also set projects in your organization as templates{% ifversion projects-v2-org-templates-GA-updates %}, and curate a list of recommended templates to highlight, {% endif %} that other organization members can then use as the base for the projects they create. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization)." +You can also set projects in your organization as templates{% ifversion projects-v2-org-templates-GA-updates %}, and curate a list of recommended templates to highlight, {% endif %} that other organization members can then use as the base for the projects they create. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/managing-your-project/managing-project-templates-in-your-organization). diff --git a/data/reusables/projects/owners-can-limit-visibility-permissions.md b/data/reusables/projects/owners-can-limit-visibility-permissions.md index 136aad303b71..371959203b00 100644 --- a/data/reusables/projects/owners-can-limit-visibility-permissions.md +++ b/data/reusables/projects/owners-can-limit-visibility-permissions.md @@ -1 +1 @@ -Organization owners can control the ability of organization members to create public {% data variables.projects.projects_v2_and_v1_if_create %}, or change the visibility of existing {% data variables.projects.projects_v2_and_v1 %} to public. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization)." +Organization owners can control the ability of organization members to create public {% data variables.projects.projects_v2_and_v1_if_create %}, or change the visibility of existing {% data variables.projects.projects_v2_and_v1 %} to public. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization). diff --git a/data/reusables/projects/project-description.md b/data/reusables/projects/project-description.md index 9159c05dd29b..8df39231dfe9 100644 --- a/data/reusables/projects/project-description.md +++ b/data/reusables/projects/project-description.md @@ -3,7 +3,7 @@ You can set your project's description and README to share the purpose of your p {% data reusables.projects.project-settings %} 1. To add a short description to your project, under "Add a description", type your description in the text box and click **Save**. 1. To update your project's README, under "README", type your content in the text box. - * You can format your README using Markdown. For more information, see "[AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)." + * You can format your README using Markdown. For more information, see [AUTOTITLE](/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax). * To toggle between the text box and a preview of your changes, click {% octicon "eye" aria-label="The preview icon" %} or {% octicon "pencil" aria-label="The edit icon" %}. 1. To save changes to your README, click **Save**. diff --git a/data/reusables/projects/project_boards_old.md b/data/reusables/projects/project_boards_old.md index 537f2d89ee1b..aa63e63a41dd 100644 --- a/data/reusables/projects/project_boards_old.md +++ b/data/reusables/projects/project_boards_old.md @@ -3,7 +3,7 @@ {% ifversion projects-v2 %} >[!NOTE] ->* {% data variables.product.prodname_projects_v2 %}, the all-new projects experience, is now available. For more information about {% data variables.product.prodname_projects_v2 %}, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)." +>* {% data variables.product.prodname_projects_v2 %}, the all-new projects experience, is now available. For more information about {% data variables.product.prodname_projects_v2 %}, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects). >* You can only create a new {% data variables.projects.projects_v1_board %} for an organization{% ifversion projects-v1-create-repo-project %}, repository, {% endif %} or user that already has at least one {% data variables.projects.projects_v1_board %}. {% ifversion projects-v1-create-repo-project %}{% else %} You cannot create new {% data variables.projects.projects_v1_boards %} for repositories. {% endif %} If you're unable to create a {% data variables.projects.projects_v1_board %}, create a project instead. {% endif %} diff --git a/data/reusables/projects/projects-api.md b/data/reusables/projects/projects-api.md index 25d3fe9c56a7..18dc8ae7ed8e 100644 --- a/data/reusables/projects/projects-api.md +++ b/data/reusables/projects/projects-api.md @@ -3,7 +3,7 @@ {% ifversion fpt or ghec %} > [!NOTE] -> * These endpoints only interact with {% data variables.product.prodname_projects_v1 %}. To manage {% data variables.product.prodname_projects_v2 %}, use the GraphQL API. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)." +> * These endpoints only interact with {% data variables.product.prodname_projects_v1 %}. To manage {% data variables.product.prodname_projects_v2 %}, use the GraphQL API. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects). > * To create a new {% data variables.projects.projects_v1_board %}, the organization, user, or repository must already have at least one {% data variables.projects.projects_v1_board %}. {% endif %} @@ -13,6 +13,6 @@ > [!NOTE] {% data reusables.projects.sunset_notice_content %} > -> These endpoints only interact with {% data variables.product.prodname_projects_v1 %}. To manage {% data variables.product.prodname_projects_v2 %}, use the GraphQL API. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects)." +> These endpoints only interact with {% data variables.product.prodname_projects_v1 %}. To manage {% data variables.product.prodname_projects_v2 %}, use the GraphQL API. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects). {% endif %} diff --git a/data/reusables/projects/sunset_notice_content.md b/data/reusables/projects/sunset_notice_content.md index 9d2c19253de7..4d68d84066a7 100644 --- a/data/reusables/projects/sunset_notice_content.md +++ b/data/reusables/projects/sunset_notice_content.md @@ -1,3 +1,3 @@ >{% data variables.product.prodname_projects_v1_caps %} has been removed. You can read more about this change on [{% data variables.product.prodname_blog %}](https://gh.io/projects-classic-sunset-notice). > ->The new and improved Projects experience is available. For more information, see "[AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects)." +>The new and improved Projects experience is available. For more information, see [AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects). diff --git a/data/reusables/pull_requests/auto-merge-requires-branch-protection.md b/data/reusables/pull_requests/auto-merge-requires-branch-protection.md index eb731406b011..708ed9203e7d 100644 --- a/data/reusables/pull_requests/auto-merge-requires-branch-protection.md +++ b/data/reusables/pull_requests/auto-merge-requires-branch-protection.md @@ -1,2 +1,2 @@ > [!NOTE] -> The option to enable auto-merge is shown only on pull requests that cannot be merged immediately. For example, when a branch protection rule enforces "Require pull request reviews before merging" or "Require status checks to pass before merging" and these conditions are not yet met. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule)." +> The option to enable auto-merge is shown only on pull requests that cannot be merged immediately. For example, when a branch protection rule enforces "Require pull request reviews before merging" or "Require status checks to pass before merging" and these conditions are not yet met. For more information, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/managing-a-branch-protection-rule). diff --git a/data/reusables/pull_requests/automatically-delete-branches.md b/data/reusables/pull_requests/automatically-delete-branches.md index 10e14c7b026d..1bcc053ddf7a 100644 --- a/data/reusables/pull_requests/automatically-delete-branches.md +++ b/data/reusables/pull_requests/automatically-delete-branches.md @@ -1 +1 @@ -You can have head branches automatically deleted after pull requests are merged in your repository. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches)." +You can have head branches automatically deleted after pull requests are merged in your repository. For more information, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-the-automatic-deletion-of-branches). diff --git a/data/reusables/pull_requests/close-issues-using-keywords.md b/data/reusables/pull_requests/close-issues-using-keywords.md index bd649c6ed02c..0703c2a32593 100644 --- a/data/reusables/pull_requests/close-issues-using-keywords.md +++ b/data/reusables/pull_requests/close-issues-using-keywords.md @@ -1 +1 @@ -You can link a pull request to an issue to show that a fix is in progress and to automatically close the issue when someone merges the pull request. For more information, see "[AUTOTITLE](/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)." +You can link a pull request to an issue to show that a fix is in progress and to automatically close the issue when someone merges the pull request. For more information, see [AUTOTITLE](/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue). diff --git a/data/reusables/pull_requests/code-review-limits.md b/data/reusables/pull_requests/code-review-limits.md index 3e69a88f4bdb..9676d53d3723 100644 --- a/data/reusables/pull_requests/code-review-limits.md +++ b/data/reusables/pull_requests/code-review-limits.md @@ -1 +1 @@ -By default, in public repositories, any user can submit reviews that approve or request changes to a pull request. Organization owners and repository admins can limit who is able to give approving pull request reviews or request changes. For more information, see "[AUTOTITLE](/organizations/managing-organization-settings/managing-pull-request-reviews-in-your-organization)" and "[AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository)." +By default, in public repositories, any user can submit reviews that approve or request changes to a pull request. Organization owners and repository admins can limit who is able to give approving pull request reviews or request changes. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-pull-request-reviews-in-your-organization) and [AUTOTITLE](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-pull-request-reviews-in-your-repository). diff --git a/data/reusables/pull_requests/configure_pull_request_merges_intro.md b/data/reusables/pull_requests/configure_pull_request_merges_intro.md index 653022fd8215..bc17ab413f48 100644 --- a/data/reusables/pull_requests/configure_pull_request_merges_intro.md +++ b/data/reusables/pull_requests/configure_pull_request_merges_intro.md @@ -1 +1 @@ -You can configure pull request merge options to meet your workflow needs and preferences for managing Git history. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges)." +You can configure pull request merge options to meet your workflow needs and preferences for managing Git history. For more information, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges). diff --git a/data/reusables/pull_requests/default-commit-message-squash-merge.md b/data/reusables/pull_requests/default-commit-message-squash-merge.md index a41114138018..c568384f930e 100644 --- a/data/reusables/pull_requests/default-commit-message-squash-merge.md +++ b/data/reusables/pull_requests/default-commit-message-squash-merge.md @@ -1 +1 @@ -For information about the default commit messages for squash merges, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges#merge-message-for-a-squash-merge)." +For information about the default commit messages for squash merges, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/about-pull-request-merges#merge-message-for-a-squash-merge). diff --git a/data/reusables/pull_requests/merge-queue-overview.md b/data/reusables/pull_requests/merge-queue-overview.md index 0336fa41aa81..8168b6781762 100644 --- a/data/reusables/pull_requests/merge-queue-overview.md +++ b/data/reusables/pull_requests/merge-queue-overview.md @@ -6,4 +6,4 @@ Using a merge queue is particularly useful on branches that have a relatively hi Once a pull request has passed all required branch protection checks, a user with write access to the repository can add the pull request to the queue. The merge queue will ensure the pull request's changes pass all required status checks when applied to the latest version of the target branch and any pull requests already in the queue. -A merge queue may use {% data variables.product.prodname_actions %} or your own CI provider to run required checks on pull requests in a merge queue. For more information, see "[AUTOTITLE](/actions)." +A merge queue may use {% data variables.product.prodname_actions %} or your own CI provider to run required checks on pull requests in a merge queue. For more information, see [AUTOTITLE](/actions). diff --git a/data/reusables/pull_requests/merge-queue-references.md b/data/reusables/pull_requests/merge-queue-references.md index 0919a9eeddf9..40647aacfc99 100644 --- a/data/reusables/pull_requests/merge-queue-references.md +++ b/data/reusables/pull_requests/merge-queue-references.md @@ -1,2 +1,2 @@ -For more information about merge queues, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue)." +For more information about merge queues, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/configuring-pull-request-merges/managing-a-merge-queue). diff --git a/data/reusables/pull_requests/path-filtering-required-workflows.md b/data/reusables/pull_requests/path-filtering-required-workflows.md index 747ae71c801a..935ecb0048fe 100644 --- a/data/reusables/pull_requests/path-filtering-required-workflows.md +++ b/data/reusables/pull_requests/path-filtering-required-workflows.md @@ -1,11 +1,11 @@ {% ifversion required-workflows-deprecation %} -You should not use path or branch filtering to skip workflow runs if the workflow is required. For more information, see "[AUTOTITLE](/actions/managing-workflow-runs/skipping-workflow-runs){% ifversion required-workflows %}" and "[AUTOTITLE](/actions/using-workflows/required-workflows){% endif %}." +You should not use path or branch filtering to skip workflow runs if the workflow is required. For more information, see [AUTOTITLE](/actions/managing-workflow-runs/skipping-workflow-runs){% ifversion required-workflows %} and [AUTOTITLE](/actions/using-workflows/required-workflows){% endif %}. {% endif %} {% ifversion repo-rules-required-workflows %} -You should not use path or branch filtering to skip workflow runs if the workflow is required to pass before merging. For more information, see "[AUTOTITLE](/actions/managing-workflow-runs/skipping-workflow-runs)" and "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#require-workflows-to-pass-before-merging)." +You should not use path or branch filtering to skip workflow runs if the workflow is required to pass before merging. For more information, see [AUTOTITLE](/actions/managing-workflow-runs/skipping-workflow-runs) and [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/available-rules-for-rulesets#require-workflows-to-pass-before-merging). {% endif %} diff --git a/data/reusables/pull_requests/required-checks-must-pass-to-merge.md b/data/reusables/pull_requests/required-checks-must-pass-to-merge.md index a19b7dcc42b1..894e9a46026f 100644 --- a/data/reusables/pull_requests/required-checks-must-pass-to-merge.md +++ b/data/reusables/pull_requests/required-checks-must-pass-to-merge.md @@ -1 +1 @@ -If status checks are required for a repository, the required status checks must pass before you can merge your branch into the protected branch. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-status-checks-before-merging)." +If status checks are required for a repository, the required status checks must pass before you can merge your branch into the protected branch. 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/pull_requests/resolving-conversations.md b/data/reusables/pull_requests/resolving-conversations.md index d5ab4c114394..83d1c02c6669 100644 --- a/data/reusables/pull_requests/resolving-conversations.md +++ b/data/reusables/pull_requests/resolving-conversations.md @@ -6,7 +6,7 @@ To indicate that a conversation on the **Files changed** tab is complete, click The entire conversation will be collapsed and marked as resolved, making it easier to find conversations that still need to be addressed. -If the suggestion in a comment is out of your pull request's scope, you can open a new issue that tracks the feedback and links back to the original comment. For more information, see "[AUTOTITLE](/issues/tracking-your-work-with-issues/creating-an-issue)." +If the suggestion in a comment is out of your pull request's scope, you can open a new issue that tracks the feedback and links back to the original comment. For more information, see [AUTOTITLE](/issues/tracking-your-work-with-issues/creating-an-issue). #### Discovering and navigating conversations diff --git a/data/reusables/pull_requests/retention-checks-data.md b/data/reusables/pull_requests/retention-checks-data.md index 71f0d6f5e47b..c81ab30adc9a 100644 --- a/data/reusables/pull_requests/retention-checks-data.md +++ b/data/reusables/pull_requests/retention-checks-data.md @@ -4,7 +4,7 @@ {% elsif ghes %} -Site administrators can control the retention policy for checks data on {% data variables.location.product_location %}. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-applications#enabling-retention-policy-for-checks)." +Site administrators can control the retention policy for checks data on {% data variables.location.product_location %}. For more information, see [AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-applications#enabling-retention-policy-for-checks). {% endif %} diff --git a/data/reusables/pull_requests/you-can-auto-merge.md b/data/reusables/pull_requests/you-can-auto-merge.md index 4810523eb6d4..c9ca23269f38 100644 --- a/data/reusables/pull_requests/you-can-auto-merge.md +++ b/data/reusables/pull_requests/you-can-auto-merge.md @@ -1 +1 @@ -You can configure a pull request to merge automatically when all merge requirements are met. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request)." +You can configure a pull request to merge automatically when all merge requirements are met. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/automatically-merging-a-pull-request). diff --git a/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md b/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md index 50ca4606a057..0dda0ad76e85 100644 --- a/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md +++ b/data/reusables/rai/code-scanning/copilot-workspaces-prs-autofix-note.md @@ -1,6 +1,6 @@ {% ifversion copilot-hadron %} > [!NOTE] -> If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.product.prodname_copilot_workspace_pr_short %}, you can click **Open in Workspace** on a {% data variables.product.prodname_copilot_autofix_short %} suggestion to open a {% data variables.product.prodname_copilot_workspace %} directly on {% data variables.product.github %}. {% data variables.product.prodname_copilot_workspace_pr_short %} allows you to view and edit all {% data variables.product.prodname_copilot_autofix_short %} suggestions and other review suggestions for the pull request, run CI tests to confirm they still pass, and then apply multiple changes in one commit. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request)." +> If you are part of the {% data variables.release-phases.public_preview %} of {% data variables.product.prodname_copilot_workspace_pr_short %}, you can click **Open in Workspace** on a {% data variables.product.prodname_copilot_autofix_short %} suggestion to open a {% data variables.product.prodname_copilot_workspace %} directly on {% data variables.product.github %}. {% data variables.product.prodname_copilot_workspace_pr_short %} allows you to view and edit all {% data variables.product.prodname_copilot_autofix_short %} suggestions and other review suggestions for the pull request, run CI tests to confirm they still pass, and then apply multiple changes in one commit. For more information, see [AUTOTITLE](/copilot/using-github-copilot/using-github-copilot-for-pull-requests/using-copilot-to-help-you-work-on-a-pull-request). {% endif %} diff --git a/data/reusables/rai/copilot/about-copilot-chat-ide.md b/data/reusables/rai/copilot/about-copilot-chat-ide.md index adf40ef551e0..8f8be0d31572 100644 --- a/data/reusables/rai/copilot/about-copilot-chat-ide.md +++ b/data/reusables/rai/copilot/about-copilot-chat-ide.md @@ -1,6 +1,6 @@ ## About {% data variables.product.prodname_copilot_chat %} -{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within the {% data variables.product.github %} website and supported IDEs. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. For more information, see "[AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot)." +{% data variables.product.prodname_copilot_chat %} is a chat interface that lets you interact with {% data variables.product.prodname_copilot %}, to ask and receive answers to coding-related questions within the {% data variables.product.github %} website and supported IDEs. The chat interface provides access to coding information and support without requiring you to navigate documentation or search online forums. For more information, see [AUTOTITLE](/copilot/about-github-copilot/what-is-github-copilot). {% data variables.product.prodname_copilot_chat %} can answer a wide range of coding-related questions on topics including syntax, programming concepts, test cases, debugging, and more. {% data variables.product.prodname_copilot_chat %} is not designed to answer non-coding questions or provide general information on topics outside of coding. diff --git a/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md b/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md index c69869471835..288fcf810634 100644 --- a/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md +++ b/data/reusables/rai/copilot/about-copilot-chat-in-mobile.md @@ -14,7 +14,7 @@ The language model generates a response based on its analysis of the input promp The response generated by {% data variables.product.prodname_copilot_chat_short %} is formatted and presented to the user. {% data variables.product.prodname_copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. -{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. For more information on improving the performance of {% data variables.product.prodname_copilot_mobile_short %}, see "[Improving performance for {% data variables.product.prodname_copilot_mobile_short %}](#improving-performance-for-copilot-chat-in-github-mobile)." +{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. For more information on improving the performance of {% data variables.product.prodname_copilot_mobile_short %}, see [Improving performance for {% data variables.product.prodname_copilot_mobile_short %}](#improving-performance-for-copilot-chat-in-github-mobile). ## Differences per {% data variables.product.prodname_copilot %} plan diff --git a/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md b/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md index c3fe82b2d504..f25a17409c1c 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-leveraging-web-search.md @@ -5,6 +5,6 @@ When you use the `@github` chat participant, {% data variables.product.prodname_copilot_chat %} can use a Bing search to help answer your question if this has been enabled by your administrator. -Your {% data variables.product.prodname_enterprise %} administrator can enable Bing for your whole enterprise, or can delegate this decision to the organizational administrator. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise)." +Your {% data variables.product.prodname_enterprise %} administrator can enable Bing for your whole enterprise, or can delegate this decision to the organizational administrator. For more information, see [AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-github-copilot-in-your-enterprise). When leveraging Bing, {% data variables.product.prodname_copilot_short %} will use the content of your prompt, as well as additional available context, to generate a Bing search query on your behalf that is sent to the Bing Search API. {% data variables.product.prodname_copilot_short %} will provide a link to the search results with its response. The search query sent to Bing is governed by [Microsoft's Privacy Statement](https://privacy.microsoft.com/en-us/privacystatement). diff --git a/data/reusables/rai/copilot/copilot-chat-ide-limitations.md b/data/reusables/rai/copilot/copilot-chat-ide-limitations.md index 1e2b29ca5dde..a64f20dac2ba 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-limitations.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-limitations.md @@ -22,7 +22,7 @@ Depending on factors such as your codebase and input data, you may experience di If you have disabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} utilizes filters that prevent it from showing code that matches code found in public repositories on {% data variables.product.prodname_dotcom %}. However, you should always take the same precautions as you would with any code you write that uses material you did not independently originate, including precautions to ensure its suitability. These include rigorous testing, IP scanning, and checking for security vulnerabilities. You should make sure your IDE or editor does not automatically compile or run generated code before you review it. -If you have enabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} displays a message if matching code is found. The message includes a link that allows you to show the details of the matched code, and any license details that were found, in the {% data variables.product.prodname_vscode_shortname %} editor. For more information, see "[AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions)." +If you have enabled suggestions that match public code then {% data variables.product.prodname_copilot_chat_short %} displays a message if matching code is found. The message includes a link that allows you to show the details of the matched code, and any license details that were found, in the {% data variables.product.prodname_vscode_shortname %} editor. For more information, see [AUTOTITLE](/copilot/using-github-copilot/finding-public-code-that-matches-github-copilot-suggestions). {% endvscode %} diff --git a/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md b/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md index 4f8cbcc8c398..c67df6d44097 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-next-steps.md @@ -2,11 +2,11 @@ For details of how to use {% data variables.product.prodname_copilot_chat %}, see: -* "[AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide)" -* "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom)"{% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} +* [AUTOTITLE](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide) +* [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-chat/copilot-chat-in-github/using-github-copilot-chat-in-githubcom){% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% endif %} ## Further reading -* "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" -* "[AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-copilot-pre-release-terms)" +* [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot) +* [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-copilot-pre-release-terms) * [{% data variables.product.prodname_copilot %} Trust Center](https://resources.github.com/copilot-trust-center/) diff --git a/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md b/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md index 139cc57671e2..9c98e2e7ecfe 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-output-formatting.md @@ -2,4 +2,4 @@ The response generated by {% data variables.product.prodname_copilot_chat_short %} is formatted and presented to the user. {% data variables.product.prodname_copilot_chat_short %} may use syntax highlighting, indentation, and other formatting features to add clarity to the generated response. Depending upon the type of question from the user, links to context that the model used when generating a response, such as source code files or documentation, may also be provided. -{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.product.prodname_copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.product.prodname_copilot_chat %}, see "[Improving performance for {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#improving-performance-for-github-copilot-chat)." +{% data variables.product.prodname_copilot_chat %} is intended to provide you with the most relevant answer to your question. However, it may not always provide the answer you are looking for. Users of {% data variables.product.prodname_copilot_chat_short %} are responsible for reviewing and validating responses generated by the system to ensure they are accurate and appropriate. Additionally, as part of our product development process, we undertake red teaming to understand and improve the safety of {% data variables.product.prodname_copilot_chat_short %}. Input prompts and output completions are run through content filters. The content filtering system detects and prevents the output on specific categories of content including harmful, offensive, or off-topic content. For more information on improving the performance of {% data variables.product.prodname_copilot_chat %}, see [Improving performance for {% data variables.product.prodname_copilot_chat %}](/copilot/github-copilot-chat/copilot-chat-in-ides/about-github-copilot-chat-in-your-ide#improving-performance-for-github-copilot-chat). diff --git a/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md b/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md index 7122b6ca0ace..81859ad8426f 100644 --- a/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md +++ b/data/reusables/rai/copilot/copilot-chat-ide-use-cases.md @@ -6,7 +6,7 @@ {% data variables.product.prodname_copilot_chat_short %} can help you write unit test cases by generating code snippets based on the code open in the editor or the code snippet you highlight in the editor. This may help you write test cases without spending as much time on repetitive tasks. For example, if you are writing a test case for a specific function, you can use {% data variables.product.prodname_copilot_chat_short %} to suggest possible input parameters and expected output values based on the function's signature and body. {% data variables.product.prodname_copilot_chat_short %} can also suggest assertions that ensure the function is working correctly, based on the code's context and semantics. -{% data variables.product.prodname_copilot_chat_short %} can also help you write test cases for edge cases and boundary conditions that might be difficult to identify manually. For instance, {% data variables.product.prodname_copilot_chat_short %} can suggest test cases for error handling, null values, or unexpected input types, helping you ensure your code is robust and resilient. However, it is important to note that generated test cases may not cover all possible scenarios, and manual testing and code review are still necessary to ensure the quality of the code. For more information on generating unit test cases, see "[Asking {% data variables.product.prodname_copilot_chat %} questions about your code](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-github-copilot-chat-questions-about-your-code)." +{% data variables.product.prodname_copilot_chat_short %} can also help you write test cases for edge cases and boundary conditions that might be difficult to identify manually. For instance, {% data variables.product.prodname_copilot_chat_short %} can suggest test cases for error handling, null values, or unexpected input types, helping you ensure your code is robust and resilient. However, it is important to note that generated test cases may not cover all possible scenarios, and manual testing and code review are still necessary to ensure the quality of the code. For more information on generating unit test cases, see [Asking {% data variables.product.prodname_copilot_chat %} questions about your code](/copilot/github-copilot-chat/copilot-chat-in-ides/using-github-copilot-chat-in-your-ide#asking-github-copilot-chat-questions-about-your-code). ### Explaining code and suggesting improvements diff --git a/data/reusables/rai/copilot/enterprise-fpt-link.md b/data/reusables/rai/copilot/enterprise-fpt-link.md index c1eed7af89fd..e3f6761133dc 100644 --- a/data/reusables/rai/copilot/enterprise-fpt-link.md +++ b/data/reusables/rai/copilot/enterprise-fpt-link.md @@ -1 +1 @@ -> [!NOTE] You are currently viewing the documentation for Free, Pro, and Team plans. {% data variables.product.prodname_copilot_enterprise %} is only available to customers on the {% data variables.product.prodname_ghe_cloud %} plan. For full documentation of {% data variables.product.prodname_copilot_enterprise_short %}, see "[AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise)." in the {% data variables.product.prodname_ghe_cloud %} documentation. +> [!NOTE] You are currently viewing the documentation for Free, Pro, and Team plans. {% data variables.product.prodname_copilot_enterprise %} is only available to customers on the {% data variables.product.prodname_ghe_cloud %} plan. For full documentation of {% data variables.product.prodname_copilot_enterprise_short %}, see [AUTOTITLE](/enterprise-cloud@latest/copilot/github-copilot-enterprise) in the {% data variables.product.prodname_ghe_cloud %} documentation. diff --git a/data/reusables/release-notes/2023-10-git-push-made-but-not-registered.md b/data/reusables/release-notes/2023-10-git-push-made-but-not-registered.md index 1deff098f8ba..a7f9e39404c1 100644 --- a/data/reusables/release-notes/2023-10-git-push-made-but-not-registered.md +++ b/data/reusables/release-notes/2023-10-git-push-made-but-not-registered.md @@ -5,6 +5,6 @@ CA certificate key too weak ``` To resolve this issue, confirm that your certificate complies -with level 2 of the OpenSSL security specification. For more information, see [SSL_CTX_set_security_level](https://www.openssl.org/docs/man1.1.1/man3/SSL_CTX_set_security_level.html#DEFAULT-CALLBACK-BEHAVIOUR) in the OpenSSL docs. For more information about reviewing your instance's logs, see "[AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs#system-logs-in-the-systemd-journal)." +with level 2 of the OpenSSL security specification. For more information, see [SSL_CTX_set_security_level](https://www.openssl.org/docs/man1.1.1/man3/SSL_CTX_set_security_level.html#DEFAULT-CALLBACK-BEHAVIOUR) in the OpenSSL docs. For more information about reviewing your instance's logs, see [AUTOTITLE](/admin/monitoring-and-managing-your-instance/monitoring-your-instance/about-system-logs#system-logs-in-the-systemd-journal). -If the error appears in `babeld` logs because your TLS certificate does not comply with level 2 of the specification, you must create and upload a new certificate with stronger security before you upgrade to GitHub Enterprise Server 3.10 or later. For more information, see "[AUTOTITLE](/admin/configuration/hardening-security-for-your-enterprise/configuring-tls)." +If the error appears in `babeld` logs because your TLS certificate does not comply with level 2 of the specification, you must create and upload a new certificate with stronger security before you upgrade to GitHub Enterprise Server 3.10 or later. For more information, see [AUTOTITLE](/admin/configuration/hardening-security-for-your-enterprise/configuring-tls). diff --git a/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-io-utilization-increase.md b/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-io-utilization-increase.md index bdd1fc88b176..22b07ac66407 100644 --- a/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-io-utilization-increase.md +++ b/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-io-utilization-increase.md @@ -1,3 +1,3 @@ After an administrator upgrades from {% data variables.product.prodname_ghe_server %} 3.7 or 3.8 to 3.9 or 3.10, I/O utilization will increase, and in some cases the instance's performance will be impacted. Reduced performance is due to the database server being upgraded from MySQL 5.7 to MySQL 8.0. -For more information, see "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance)." +For more information, see [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance). diff --git a/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-mysql-cannot-start-up.md b/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-mysql-cannot-start-up.md index 06e2431df28d..5afe7868cd44 100644 --- a/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-mysql-cannot-start-up.md +++ b/data/reusables/release-notes/upgrade-to-3-9-or-to-3-10-mysql-cannot-start-up.md @@ -1 +1 @@ -After an administrator upgrades from {% data variables.product.prodname_ghe_server %} 3.7 or 3.8, to 3.9 or 3.10, MySQL may not start back up. For more information, see "[AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance#mysql-does-not-start-after-upgrade-to-github-enterprise-server-39-or-310)." +After an administrator upgrades from {% data variables.product.prodname_ghe_server %} 3.7 or 3.8, to 3.9 or 3.10, MySQL may not start back up. For more information, see [AUTOTITLE](/admin/enterprise-management/updating-the-virtual-machine-and-physical-resources/known-issues-with-upgrades-to-your-instance#mysql-does-not-start-after-upgrade-to-github-enterprise-server-39-or-310). diff --git a/data/reusables/releases/finish-release.md b/data/reusables/releases/finish-release.md index f480f3ee90fe..0ebf9b848d25 100644 --- a/data/reusables/releases/finish-release.md +++ b/data/reusables/releases/finish-release.md @@ -11,5 +11,5 @@ 1. If you're ready to publicize your release, click **Publish release**. To work on the release later, click **Save draft**. {%- ifversion fpt or ghec %} - You can then view your published or draft releases in the releases feed for your repository. For more information, see "[AUTOTITLE](/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags)." + You can then view your published or draft releases in the releases feed for your repository. For more information, see [AUTOTITLE](/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags). {%- endif %} diff --git a/data/reusables/reminders/ignore-drafts.md b/data/reusables/reminders/ignore-drafts.md index 0e9d4cb3e78b..731b88b376e7 100644 --- a/data/reusables/reminders/ignore-drafts.md +++ b/data/reusables/reminders/ignore-drafts.md @@ -1 +1 @@ -1. Optionally, to exclude draft pull requests from scheduled reminders, select **Ignore drafts**. For more information, see "[AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests)." +1. Optionally, to exclude draft pull requests from scheduled reminders, select **Ignore drafts**. For more information, see [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests#draft-pull-requests). diff --git a/data/variables/code-scanning.yml b/data/variables/code-scanning.yml index 94747abab32c..581ce2cdbd12 100644 --- a/data/variables/code-scanning.yml +++ b/data/variables/code-scanning.yml @@ -13,7 +13,10 @@ no_build_support: '{% ifversion codeql-no-build-csharp %}C# and{% endif %} Java' compiled_languages: 'C/C++, C#, Go, Java, Kotlin, and Swift' # List of languages where the libraries support expansion using CodeQL model packs at the repository level. -codeql_model_packs_support: '{% ifversion fpt or ghec or ghes > 3.14 %}C#, Java/Kotlin, Python, and Ruby{% elsif ghes > 3.12 %}C#, Java/Kotlin, and Ruby{% elsif ghes > 3.10 %}Java/Kotlin{% endif %}' +codeql_model_packs_support: '{% ifversion fpt or ghec or ghes > 3.14 %} C/C++, C#, Java/Kotlin, Python, and Ruby{% elsif ghes > 3.12 %}C#, Java/Kotlin, and Ruby{% elsif ghes > 3.10 %}Java/Kotlin{% endif %}' + +# List of languages that the model editor in the CodeQL extension for VS Code supports +codeql_model_editor_support: '{% ifversion fpt or ghec or ghes > 3.14 %} C#, Java/Kotlin, Python, and Ruby{% elsif ghes > 3.12 %}C#, Java/Kotlin, and Ruby{% elsif ghes > 3.10 %}Java/Kotlin{% endif %}' # List of that allow threat models to be configurable for code scanning code_scanning_threat_model_support: 'Java/Kotlin{% ifversion fpt or ghec or ghes > 3.12 %} and C#{% endif %}' diff --git a/data/variables/contact.yml b/data/variables/contact.yml index ddb412bfbf88..b14d68771f94 100644 --- a/data/variables/contact.yml +++ b/data/variables/contact.yml @@ -15,6 +15,8 @@ contact_privacy: >- contact_enterprise_sales: "[GitHub's Sales team](https://github.com/enterprise/contact)" +contact_sales_data_residency: "[GitHub's Sales team](https://github.com/enterprise/contact/data-residency)" + contact_feedback_actions: '[GitHub Community discussions for GitHub Actions](https://github.com/orgs/community/discussions/categories/actions-and-packages)' # The team that provides Standard Support diff --git a/data/variables/gists.yml b/data/variables/gists.yml index 304c4a1cfaae..ab7796a143ce 100644 --- a/data/variables/gists.yml +++ b/data/variables/gists.yml @@ -12,3 +12,6 @@ gist_starred: >- gist_user_starred: >- {% ifversion fpt or ghec %}`https://gist.github.com/YOUR_USERNAME/starred`{% else %}`http(s)://[hostname]/gist/YOUR_USERNAME/starred` or `http(s)://gist.[hostname]/YOUR_USERNAME/starred` if subdomains are enabled{% endif %} + +gist_user: >- + {% ifversion fpt or ghec %}`https://gist.github.com/YOUR_USERNAME`{% else %}`http(s)://[hostname]/gist/YOUR_USERNAME` or `http(s)://gist.[hostname]/YOUR_USERNAME` if subdomains are enabled{% endif %} diff --git a/src/archives/middleware/archived-enterprise-versions.ts b/src/archives/middleware/archived-enterprise-versions.ts index 3bc04484758b..5d056b1475f7 100644 --- a/src/archives/middleware/archived-enterprise-versions.ts +++ b/src/archives/middleware/archived-enterprise-versions.ts @@ -227,6 +227,9 @@ export default async function archivedEnterpriseVersions( // old Azure Blob Storage URL. These need to be rewritten to // the new archived enterprise repo URL. if (versionSatisfiesRange(requestedVersion, `>=${firstReleaseStoredInBlobStorage}`)) { + // `x-host` is a custom header set by Fastly. + // GLB automatically deletes the `x-forwarded-host` header. + const host = req.get('x-host') || req.get('x-forwarded-host') || req.get('host') r.body = r.body .replaceAll( `${OLD_AZURE_BLOB_ENTERPRISE_DIR}/${requestedVersion}/assets/cb-`, @@ -234,7 +237,7 @@ export default async function archivedEnterpriseVersions( ) .replaceAll( `${OLD_AZURE_BLOB_ENTERPRISE_DIR}/${requestedVersion}/`, - `${req.protocol}://${req.get('x-forwarded-host') || req.get('host')}/enterprise-server@${requestedVersion}/`, + `${req.protocol}://${host}/enterprise-server@${requestedVersion}/`, ) } diff --git a/src/audit-logs/lib/config.json b/src/audit-logs/lib/config.json index 9a9fdde4059f..76e3be56bf1b 100644 --- a/src/audit-logs/lib/config.json +++ b/src/audit-logs/lib/config.json @@ -3,5 +3,5 @@ "apiOnlyEvents": "This event is not available in the web interface, only via the REST API, audit log streaming, or JSON/CSV exports.", "apiRequestEvent": "This event is only available via audit log streaming." }, - "sha": "20c2272a952ed0bd5281b59da7c6b538ed330b75" + "sha": "55ee473035619a2438d2712ae34bb665a9839436" } \ No newline at end of file diff --git a/src/frame/middleware/index.ts b/src/frame/middleware/index.ts index 42c34fc6dca9..d899c34c549f 100644 --- a/src/frame/middleware/index.ts +++ b/src/frame/middleware/index.ts @@ -31,6 +31,7 @@ import healthz from './healthz' import manifestJson from './manifest-json' import remoteIP from './remote-ip' import buildInfo from './build-info' +import reqHeaders from './req-headers' import archivedEnterpriseVersions from '@/archives/middleware/archived-enterprise-versions' import robots from './robots' import earlyAccessLinks from '@/early-access/middleware/early-access-links' @@ -246,6 +247,7 @@ export default function (app: Express) { app.use('/api', api) app.get('/_ip', remoteIP) app.get('/_build', buildInfo) + app.get('/_req-headers', reqHeaders) app.use(asyncMiddleware(manifestJson)) // Things like `/api` sets their own Fastly surrogate keys. diff --git a/src/frame/middleware/req-headers.ts b/src/frame/middleware/req-headers.ts new file mode 100644 index 000000000000..1beb0acabbc6 --- /dev/null +++ b/src/frame/middleware/req-headers.ts @@ -0,0 +1,10 @@ +import type { Request, Response } from 'express' + +import { noCacheControl } from './cache-control.js' + +export default function reqHeaders(req: Request, res: Response) { + noCacheControl(res) + res.json({ + 'request-headers': req.headers, + }) +} diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json index 02ad6c8b8341..935004d4ed0e 100644 --- a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json +++ b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat-permissions.json @@ -1403,6 +1403,66 @@ } ] }, + "organization_private_registries": { + "title": "Organization private registries", + "displayTitle": "Organization permissions for \"Organization private registries\"", + "permissions": [ + { + "category": "private-registries", + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries", + "additional-permissions": false, + "access": "read" + }, + { + "category": "private-registries", + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries", + "additional-permissions": false, + "access": "write" + }, + { + "category": "private-registries", + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key", + "additional-permissions": false, + "access": "read" + }, + { + "category": "private-registries", + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "additional-permissions": false, + "access": "read" + }, + { + "category": "private-registries", + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "additional-permissions": false, + "access": "write" + }, + { + "category": "private-registries", + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "additional-permissions": false, + "access": "write" + } + ] + }, "organization_personal_access_token_requests": { "title": "Personal access token requests", "displayTitle": "Organization permissions for \"Personal access token requests\"", diff --git a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json index 85cd57f03151..aa2060e730ba 100644 --- a/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json +++ b/src/github-apps/data/fpt-2022-11-28/fine-grained-pat.json @@ -3819,6 +3819,44 @@ "requestPath": "/repos/{owner}/{repo}/pages/health" } ], + "private-registries": [ + { + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key" + }, + { + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + } + ], "projects": [ { "slug": "list-organization-projects", diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json index 7211a26bc2ea..3cc75ac63cd9 100644 --- a/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json +++ b/src/github-apps/data/fpt-2022-11-28/server-to-server-permissions.json @@ -1699,6 +1699,78 @@ } ] }, + "organization_private_registries": { + "title": "Organization private registries", + "displayTitle": "Organization permissions for \"Organization private registries\"", + "permissions": [ + { + "category": "private-registries", + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + } + ] + }, "organization_personal_access_token_requests": { "title": "Personal access token requests", "displayTitle": "Organization permissions for \"Personal access token requests\"", diff --git a/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json index 4084c5e5c665..bab111dbeb74 100644 --- a/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json +++ b/src/github-apps/data/fpt-2022-11-28/server-to-server-rest.json @@ -3351,6 +3351,44 @@ "requestPath": "/repos/{owner}/{repo}/pages/health" } ], + "private-registries": [ + { + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key" + }, + { + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + } + ], "projects": [ { "slug": "list-organization-projects", diff --git a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json index 85cd57f03151..aa2060e730ba 100644 --- a/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json +++ b/src/github-apps/data/fpt-2022-11-28/user-to-server-rest.json @@ -3819,6 +3819,44 @@ "requestPath": "/repos/{owner}/{repo}/pages/health" } ], + "private-registries": [ + { + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key" + }, + { + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + } + ], "projects": [ { "slug": "list-organization-projects", diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json index bb3d84f31b89..885680b630a3 100644 --- a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json +++ b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat-permissions.json @@ -1853,6 +1853,66 @@ } ] }, + "organization_private_registries": { + "title": "Organization private registries", + "displayTitle": "Organization permissions for \"Organization private registries\"", + "permissions": [ + { + "category": "private-registries", + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries", + "additional-permissions": false, + "access": "read" + }, + { + "category": "private-registries", + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries", + "additional-permissions": false, + "access": "write" + }, + { + "category": "private-registries", + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key", + "additional-permissions": false, + "access": "read" + }, + { + "category": "private-registries", + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "additional-permissions": false, + "access": "read" + }, + { + "category": "private-registries", + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "additional-permissions": false, + "access": "write" + }, + { + "category": "private-registries", + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "additional-permissions": false, + "access": "write" + } + ] + }, "organization_personal_access_token_requests": { "title": "Personal access token requests", "displayTitle": "Organization permissions for \"Personal access token requests\"", diff --git a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json index 8642c242cb0a..606265a4a1b3 100644 --- a/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json +++ b/src/github-apps/data/ghec-2022-11-28/fine-grained-pat.json @@ -4153,6 +4153,44 @@ "requestPath": "/repos/{owner}/{repo}/pages/health" } ], + "private-registries": [ + { + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key" + }, + { + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + } + ], "projects": [ { "slug": "list-organization-projects", diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json index 6bb9f379cb5a..cbdff423ff3f 100644 --- a/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json +++ b/src/github-apps/data/ghec-2022-11-28/server-to-server-permissions.json @@ -2245,6 +2245,78 @@ } ] }, + "organization_private_registries": { + "title": "Organization private registries", + "displayTitle": "Organization permissions for \"Organization private registries\"", + "permissions": [ + { + "category": "private-registries", + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "access": "read", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + }, + { + "category": "private-registries", + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "access": "write", + "user-to-server": true, + "server-to-server": true, + "additional-permissions": false + } + ] + }, "organization_personal_access_token_requests": { "title": "Personal access token requests", "displayTitle": "Organization permissions for \"Personal access token requests\"", diff --git a/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json index d0711314b56a..add62e840b71 100644 --- a/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json +++ b/src/github-apps/data/ghec-2022-11-28/server-to-server-rest.json @@ -3685,6 +3685,44 @@ "requestPath": "/repos/{owner}/{repo}/pages/health" } ], + "private-registries": [ + { + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key" + }, + { + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + } + ], "projects": [ { "slug": "list-organization-projects", diff --git a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json index 8642c242cb0a..606265a4a1b3 100644 --- a/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json +++ b/src/github-apps/data/ghec-2022-11-28/user-to-server-rest.json @@ -4153,6 +4153,44 @@ "requestPath": "/repos/{owner}/{repo}/pages/health" } ], + "private-registries": [ + { + "slug": "list-private-registries-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "create-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries" + }, + { + "slug": "get-private-registries-public-key-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key" + }, + { + "slug": "get-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "update-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + }, + { + "slug": "delete-a-private-registry-for-an-organization", + "subcategory": "organization-configurations", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}" + } + ], "projects": [ { "slug": "list-organization-projects", diff --git a/src/github-apps/lib/config.json b/src/github-apps/lib/config.json index 82273c01fde7..f8d4e98e2344 100644 --- a/src/github-apps/lib/config.json +++ b/src/github-apps/lib/config.json @@ -60,5 +60,5 @@ "2022-11-28" ] }, - "sha": "99b100d4af04d83bdb08024aa6af991edd2ea02f" + "sha": "917eb60d24132049c50cea80b1e4e8eb3ea4716e" } \ No newline at end of file diff --git a/src/products/README.md b/src/products/README.md index e69de29bb2d1..129c5bd19973 100644 --- a/src/products/README.md +++ b/src/products/README.md @@ -0,0 +1 @@ +❤︎ diff --git a/src/rest/data/fpt-2022-11-28/schema.json b/src/rest/data/fpt-2022-11-28/schema.json index 57b5fd72aa24..7a9a7ed3fdb7 100644 --- a/src/rest/data/fpt-2022-11-28/schema.json +++ b/src/rest/data/fpt-2022-11-28/schema.json @@ -159122,6 +159122,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -159135,6 +159136,28 @@ ] } }, + "runner_type": { + "description": "Runner type to be used.", + "type": [ + "string", + "null" + ], + "enum": [ + "standard", + "labeled", + null + ] + }, + "runner_label": { + "description": "Runner label to be used if the runner type is labeled.", + "type": [ + "string", + "null" + ], + "examples": [ + "code-scanning" + ] + }, "query_suite": { "description": "CodeQL query suite to be used.", "type": "string", @@ -159259,7 +159282,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -253089,6 +253112,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -253589,6 +253615,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -254212,6 +254239,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -254676,6 +254706,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -255076,6 +255109,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -255669,6 +255705,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -256138,6 +256177,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -256761,6 +256801,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -257225,6 +257268,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -257541,6 +257587,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -258164,6 +258211,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -258628,6 +258678,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -259469,6 +259522,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -259933,6 +259989,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -260786,6 +260845,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -261250,6 +261312,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -262532,6 +262597,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -262996,6 +263064,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -263376,6 +263447,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -264053,6 +264127,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -264676,6 +264751,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -265140,6 +265218,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -265548,6 +265629,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -414947,6 +415031,872 @@ } ] }, + "private-registries": { + "organization-configurations": [ + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries", + "title": "List private registries for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "

The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "

The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "read" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "total_count": 1, + "configurations": [ + { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z", + "visibility": "selected" + } + ] + }, + "schema": { + "type": "object", + "required": [ + "total_count", + "configurations" + ], + "properties": { + "total_count": { + "type": "integer" + }, + "configurations": { + "type": "array", + "items": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": [ + "string", + "null" + ], + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + } + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Lists all private registry configurations available at the organization-level without revealing their encrypted\nvalues.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "400", + "description": "

Bad Request

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries", + "title": "Create a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [ + { + "type": "string", + "name": "registry_type", + "in": "body", + "description": "

The registry type.

", + "isRequired": true, + "enum": [ + "maven_repository" + ] + }, + { + "type": "string or null", + "name": "username", + "in": "body", + "description": "

The username to use when authenticating with the private registry. This field should be omitted if the private registry does not require a username for authentication.

" + }, + { + "type": "string", + "name": "encrypted_value", + "in": "body", + "description": "

The value for your secret, encrypted with LibSodium using the public key retrieved from the Get private registries public key for an organization endpoint.

", + "isRequired": true + }, + { + "type": "string", + "name": "key_id", + "in": "body", + "description": "

The ID of the key you used to encrypt the secret.

", + "isRequired": true + }, + { + "type": "string", + "name": "visibility", + "in": "body", + "description": "

Which type of organization repositories have access to the private registry. selected means only the repositories specified by selected_repository_ids can access the private registry.

", + "isRequired": true, + "enum": [ + "all", + "private", + "selected" + ] + }, + { + "type": "array of integers", + "name": "selected_repository_ids", + "in": "body", + "description": "

An array of repository IDs that can access the organization private registry. You can only provide a list of repository IDs when visibility is set to selected. You can manage the list of selected repositories using the Update a private registry for an organization endpoint. This field should be omitted if visibility is set to all or private.

" + } + ], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "write" + } + ] + }, + "codeExamples": [ + { + "key": "org-private-registry-with-private-visibility", + "request": { + "contentType": "application/json", + "description": "Example of a private registry configuration with private visibility", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "registry_type": "maven_repository", + "username": "monalisa", + "encrypted_value": "c2VjcmV0", + "key_id": "012345678912345678", + "visibility": "private" + }, + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "201", + "contentType": "application/json", + "description": "

The organization private registry configuration

", + "example": { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "visibility": "selected", + "selected_repository_ids": [ + 1296269, + 1296280 + ], + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z" + }, + "schema": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": "string", + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry. `selected` means only the repositories specified by `selected_repository_ids` can access the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "selected_repository_ids": { + "type": "array", + "description": "An array of repository IDs that can access the organization private registry when `visibility` is set to `selected`.", + "items": { + "type": "integer" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + }, + { + "key": "org-private-registry-with-selected-visibility", + "request": { + "contentType": "application/json", + "description": "Example of a private registry configuration with selected visibility", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "registry_type": "maven_repository", + "username": "monalisa", + "encrypted_value": "c2VjcmV0", + "key_id": "012345678912345678", + "visibility": "selected", + "selected_repository_ids": [ + 1296269, + 1296280 + ] + }, + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "201", + "contentType": "application/json", + "description": "

The organization private registry configuration

", + "example": { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "visibility": "private", + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z" + }, + "schema": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": "string", + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry. `selected` means only the repositories specified by `selected_repository_ids` can access the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "selected_repository_ids": { + "type": "array", + "description": "An array of repository IDs that can access the organization private registry when `visibility` is set to `selected`.", + "items": { + "type": "integer" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Creates a private registry configuration with an encrypted value for an organization. Encrypt your secret using LibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "201", + "description": "

The organization private registry configuration

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key", + "title": "Get private registries public key for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "read" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "key_id": "012345678912345678", + "key": "2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234" + }, + "schema": { + "type": "object", + "required": [ + "key_id", + "key" + ], + "properties": { + "key_id": { + "description": "The identifier for the key.", + "type": "string", + "examples": [ + "012345678912345678" + ] + }, + "key": { + "description": "The Base64 encoded public key.", + "type": "string", + "examples": [ + "2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234" + ] + } + } + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets the org public key, which is needed to encrypt private registry secrets. You need to encrypt a secret before you can create or update secrets.

\n

OAuth tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "title": "Get a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "secret_name", + "description": "

The name of the secret.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "read" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG", + "secret_name": "SECRET_NAME" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

The specified private registry configuration for the organization

", + "example": { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "visibility": "private", + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z" + }, + "schema": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": [ + "string", + "null" + ], + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Get the configuration of a single private registry defined for an organization, omitting its encrypted value.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

The specified private registry configuration for the organization

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "title": "Update a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "secret_name", + "description": "

The name of the secret.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [ + { + "type": "string", + "name": "registry_type", + "in": "body", + "description": "

The registry type.

", + "enum": [ + "maven_repository" + ] + }, + { + "type": "string or null", + "name": "username", + "in": "body", + "description": "

The username to use when authenticating with the private registry. This field should be omitted if the private registry does not require a username for authentication.

" + }, + { + "type": "string", + "name": "encrypted_value", + "in": "body", + "description": "

The value for your secret, encrypted with LibSodium using the public key retrieved from the Get private registries public key for an organization endpoint.

" + }, + { + "type": "string", + "name": "key_id", + "in": "body", + "description": "

The ID of the key you used to encrypt the secret.

" + }, + { + "type": "string", + "name": "visibility", + "in": "body", + "description": "

Which type of organization repositories have access to the private registry. selected means only the repositories specified by selected_repository_ids can access the private registry.

", + "enum": [ + "all", + "private", + "selected" + ] + }, + { + "type": "array of integers", + "name": "selected_repository_ids", + "in": "body", + "description": "

An array of repository IDs that can access the organization private registry. You can only provide a list of repository IDs when visibility is set to selected. This field should be omitted if visibility is set to all or private.

" + } + ], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "write" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "username": "monalisa", + "encrypted_value": "c2VjcmV0", + "key_id": "012345678912345678" + }, + "parameters": { + "org": "ORG", + "secret_name": "SECRET_NAME" + } + }, + "response": { + "statusCode": "204", + "description": "

Response

" + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates a private registry configuration with an encrypted value for an organization. Encrypt your secret using LibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "204", + "description": "

No Content

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "title": "Delete a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "secret_name", + "description": "

The name of the secret.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "write" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG", + "secret_name": "SECRET_NAME" + } + }, + "response": { + "statusCode": "204", + "description": "

Response

" + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Delete a private registry configuration at the organization-level.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "204", + "description": "

No Content

" + }, + { + "httpStatusCode": "400", + "description": "

Bad Request

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + } + ] + }, "projects": { "projects": [ { @@ -494603,7 +495553,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -538623,8 +539573,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { @@ -545391,7 +546340,7 @@ } ], "previews": [], - "descriptionHTML": "

Lists the latest incremental and backfill scans by type for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo or security_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public_repo scope instead.

", + "descriptionHTML": "

Lists the latest default incremental and backfill scans by type for a repository. Scans from Copilot Secret Scanning are not included.

\n

OAuth app tokens and personal access tokens (classic) need the repo or security_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public_repo scope instead.

", "statusCodes": [ { "httpStatusCode": "200", diff --git a/src/rest/data/ghec-2022-11-28/schema.json b/src/rest/data/ghec-2022-11-28/schema.json index 57532e0557ca..a8497d064900 100644 --- a/src/rest/data/ghec-2022-11-28/schema.json +++ b/src/rest/data/ghec-2022-11-28/schema.json @@ -167806,6 +167806,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -167819,6 +167820,28 @@ ] } }, + "runner_type": { + "description": "Runner type to be used.", + "type": [ + "string", + "null" + ], + "enum": [ + "standard", + "labeled", + null + ] + }, + "runner_label": { + "description": "Runner label to be used if the runner type is labeled.", + "type": [ + "string", + "null" + ], + "examples": [ + "code-scanning" + ] + }, "query_suite": { "description": "CodeQL query suite to be used.", "type": "string", @@ -167943,7 +167966,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -236390,11 +236413,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "read" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -236978,11 +236997,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "read" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -238734,11 +238749,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "read" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -239026,9 +239037,292 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, + "permissions": [] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "enterprise": "ENTERPRISE", + "team_slug": "TEAM_SLUG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": [ + { + "day": "2023-10-15", + "total_suggestions_count": 1000, + "total_acceptances_count": 800, + "total_lines_suggested": 1800, + "total_lines_accepted": 1200, + "total_active_users": 10, + "total_chat_acceptances": 32, + "total_chat_turns": 200, + "total_active_chat_users": 4, + "breakdown": [ + { + "language": "python", + "editor": "vscode", + "suggestions_count": 300, + "acceptances_count": 250, + "lines_suggested": 900, + "lines_accepted": 700, + "active_users": 5 + }, + { + "language": "python", + "editor": "jetbrains", + "suggestions_count": 300, + "acceptances_count": 200, + "lines_suggested": 400, + "lines_accepted": 300, + "active_users": 2 + }, + { + "language": "ruby", + "editor": "vscode", + "suggestions_count": 400, + "acceptances_count": 350, + "lines_suggested": 500, + "lines_accepted": 200, + "active_users": 3 + } + ] + }, + { + "day": "2023-10-16", + "total_suggestions_count": 800, + "total_acceptances_count": 600, + "total_lines_suggested": 1100, + "total_lines_accepted": 700, + "total_active_users": 12, + "total_chat_acceptances": 57, + "total_chat_turns": 426, + "total_active_chat_users": 8, + "breakdown": [ + { + "language": "python", + "editor": "vscode", + "suggestions_count": 300, + "acceptances_count": 200, + "lines_suggested": 600, + "lines_accepted": 300, + "active_users": 2 + }, + { + "language": "python", + "editor": "jetbrains", + "suggestions_count": 300, + "acceptances_count": 150, + "lines_suggested": 300, + "lines_accepted": 250, + "active_users": 6 + }, + { + "language": "ruby", + "editor": "vscode", + "suggestions_count": 200, + "acceptances_count": 150, + "lines_suggested": 200, + "lines_accepted": 150, + "active_users": 3 + } + ] + } + ], + "schema": { + "type": "array", + "items": { + "title": "Copilot Usage Metrics", + "description": "Summary of Copilot usage.", + "type": "object", + "properties": { + "day": { + "type": "string", + "format": "date", + "description": "The date for which the usage metrics are reported, in `YYYY-MM-DD` format." + }, + "total_suggestions_count": { + "type": "integer", + "description": "The total number of Copilot code completion suggestions shown to users." + }, + "total_acceptances_count": { + "type": "integer", + "description": "The total number of Copilot code completion suggestions accepted by users." + }, + "total_lines_suggested": { + "type": "integer", + "description": "The total number of lines of code completions suggested by Copilot." + }, + "total_lines_accepted": { + "type": "integer", + "description": "The total number of lines of code completions accepted by users." + }, + "total_active_users": { + "type": "integer", + "description": "The total number of users who were shown Copilot code completion suggestions during the day specified." + }, + "total_chat_acceptances": { + "type": "integer", + "description": "The total instances of users who accepted code suggested by Copilot Chat in the IDE (panel and inline)." + }, + "total_chat_turns": { + "type": "integer", + "description": "The total number of chat turns (prompt and response pairs) sent between users and Copilot Chat in the IDE." + }, + "total_active_chat_users": { + "type": "integer", + "description": "The total number of users who interacted with Copilot Chat in the IDE during the day specified." + }, + "breakdown": { + "type": [ + "array", + "null" + ], + "description": "Breakdown of Copilot code completions usage by language and editor", + "items": { + "type": "object", + "description": "Breakdown of Copilot usage by editor for this language", + "additionalProperties": true, + "properties": { + "language": { + "type": "string", + "description": "The language in which Copilot suggestions were shown to users in the specified editor." + }, + "editor": { + "type": "string", + "description": "The editor in which Copilot suggestions were shown to users for the specified language." + }, + "suggestions_count": { + "type": "integer", + "description": "The number of Copilot suggestions shown to users in the editor specified during the day specified." + }, + "acceptances_count": { + "type": "integer", + "description": "The number of Copilot suggestions accepted by users in the editor specified during the day specified." + }, + "lines_suggested": { + "type": "integer", + "description": "The number of lines of code suggested by Copilot in the editor specified during the day specified." + }, + "lines_accepted": { + "type": "integer", + "description": "The number of lines of code accepted by users in the editor specified during the day specified." + }, + "active_users": { + "type": "integer", + "description": "The number of users who were shown Copilot completion suggestions in the editor specified during the day specified." + } + } + } + } + }, + "required": [ + "day", + "breakdown" + ], + "additionalProperties": false + } + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change. This endpoint is only applicable to dedicated enterprise accounts for Copilot Business. See \"About enterprise accounts for Copilot Business.\"

\n
\n

You can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nfor users within an enterprise team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.

\n

The response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.

\n

Note

\n

\nThis endpoint will only return results for a given day if the enterprise team had five or more members with active Copilot licenses, as evaluated at the end of that day.

\n
\n

Owners and billing managers for the enterprise that contains the enterprise team can view Copilot usage metrics for the enterprise team.

\n

OAuth app tokens and personal access tokens (classic) need either the manage_billing:copilot or read:enterprise scopes to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "401", + "description": "

Requires authentication

" + }, + { + "httpStatusCode": "403", + "description": "

Forbidden

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "500", + "description": "

Internal Error

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/copilot/usage", + "title": "Get a summary of Copilot usage for organization members", + "category": "copilot", + "subcategory": "copilot-usage", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "since", + "description": "

Show usage metrics since this date. This is a timestamp in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Maximum value is 28 days ago.

", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "until", + "description": "

Show usage metrics until this date. This is a timestamp in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ) and should not preceed the since date if it is passed.

", + "in": "query", + "required": false, + "schema": { + "type": "string" + } + }, + { + "name": "page", + "description": "

The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + }, + { + "name": "per_page", + "description": "

The number of days of metrics to display per page (max 28). For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 28 + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, "permissions": [ { - "\"Enterprise administration\" business permissions": "read" + "\"GitHub Copilot Business\" organization permissions": "read" + }, + { + "\"Administration\" organization permissions": "read" } ] }, @@ -239039,294 +239333,7 @@ "description": "Example", "acceptHeader": "application/vnd.github.v3+json", "parameters": { - "enterprise": "ENTERPRISE", - "team_slug": "TEAM_SLUG" - } - }, - "response": { - "statusCode": "200", - "contentType": "application/json", - "description": "

Response

", - "example": [ - { - "day": "2023-10-15", - "total_suggestions_count": 1000, - "total_acceptances_count": 800, - "total_lines_suggested": 1800, - "total_lines_accepted": 1200, - "total_active_users": 10, - "total_chat_acceptances": 32, - "total_chat_turns": 200, - "total_active_chat_users": 4, - "breakdown": [ - { - "language": "python", - "editor": "vscode", - "suggestions_count": 300, - "acceptances_count": 250, - "lines_suggested": 900, - "lines_accepted": 700, - "active_users": 5 - }, - { - "language": "python", - "editor": "jetbrains", - "suggestions_count": 300, - "acceptances_count": 200, - "lines_suggested": 400, - "lines_accepted": 300, - "active_users": 2 - }, - { - "language": "ruby", - "editor": "vscode", - "suggestions_count": 400, - "acceptances_count": 350, - "lines_suggested": 500, - "lines_accepted": 200, - "active_users": 3 - } - ] - }, - { - "day": "2023-10-16", - "total_suggestions_count": 800, - "total_acceptances_count": 600, - "total_lines_suggested": 1100, - "total_lines_accepted": 700, - "total_active_users": 12, - "total_chat_acceptances": 57, - "total_chat_turns": 426, - "total_active_chat_users": 8, - "breakdown": [ - { - "language": "python", - "editor": "vscode", - "suggestions_count": 300, - "acceptances_count": 200, - "lines_suggested": 600, - "lines_accepted": 300, - "active_users": 2 - }, - { - "language": "python", - "editor": "jetbrains", - "suggestions_count": 300, - "acceptances_count": 150, - "lines_suggested": 300, - "lines_accepted": 250, - "active_users": 6 - }, - { - "language": "ruby", - "editor": "vscode", - "suggestions_count": 200, - "acceptances_count": 150, - "lines_suggested": 200, - "lines_accepted": 150, - "active_users": 3 - } - ] - } - ], - "schema": { - "type": "array", - "items": { - "title": "Copilot Usage Metrics", - "description": "Summary of Copilot usage.", - "type": "object", - "properties": { - "day": { - "type": "string", - "format": "date", - "description": "The date for which the usage metrics are reported, in `YYYY-MM-DD` format." - }, - "total_suggestions_count": { - "type": "integer", - "description": "The total number of Copilot code completion suggestions shown to users." - }, - "total_acceptances_count": { - "type": "integer", - "description": "The total number of Copilot code completion suggestions accepted by users." - }, - "total_lines_suggested": { - "type": "integer", - "description": "The total number of lines of code completions suggested by Copilot." - }, - "total_lines_accepted": { - "type": "integer", - "description": "The total number of lines of code completions accepted by users." - }, - "total_active_users": { - "type": "integer", - "description": "The total number of users who were shown Copilot code completion suggestions during the day specified." - }, - "total_chat_acceptances": { - "type": "integer", - "description": "The total instances of users who accepted code suggested by Copilot Chat in the IDE (panel and inline)." - }, - "total_chat_turns": { - "type": "integer", - "description": "The total number of chat turns (prompt and response pairs) sent between users and Copilot Chat in the IDE." - }, - "total_active_chat_users": { - "type": "integer", - "description": "The total number of users who interacted with Copilot Chat in the IDE during the day specified." - }, - "breakdown": { - "type": [ - "array", - "null" - ], - "description": "Breakdown of Copilot code completions usage by language and editor", - "items": { - "type": "object", - "description": "Breakdown of Copilot usage by editor for this language", - "additionalProperties": true, - "properties": { - "language": { - "type": "string", - "description": "The language in which Copilot suggestions were shown to users in the specified editor." - }, - "editor": { - "type": "string", - "description": "The editor in which Copilot suggestions were shown to users for the specified language." - }, - "suggestions_count": { - "type": "integer", - "description": "The number of Copilot suggestions shown to users in the editor specified during the day specified." - }, - "acceptances_count": { - "type": "integer", - "description": "The number of Copilot suggestions accepted by users in the editor specified during the day specified." - }, - "lines_suggested": { - "type": "integer", - "description": "The number of lines of code suggested by Copilot in the editor specified during the day specified." - }, - "lines_accepted": { - "type": "integer", - "description": "The number of lines of code accepted by users in the editor specified during the day specified." - }, - "active_users": { - "type": "integer", - "description": "The number of users who were shown Copilot completion suggestions in the editor specified during the day specified." - } - } - } - } - }, - "required": [ - "day", - "breakdown" - ], - "additionalProperties": false - } - } - } - } - ], - "previews": [], - "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change. This endpoint is only applicable to dedicated enterprise accounts for Copilot Business. See \"About enterprise accounts for Copilot Business.\"

\n
\n

You can use this endpoint to see a daily breakdown of aggregated usage metrics for Copilot completions and Copilot Chat in the IDE\nfor users within an enterprise team, with a further breakdown of suggestions, acceptances, and number of active users by editor and language for each day.\nSee the response schema tab for detailed metrics definitions.

\n

The response contains metrics for up to 28 days prior. Usage metrics are processed once per day for the previous day,\nand the response will only include data up until yesterday. In order for an end user to be counted towards these metrics,\nthey must have telemetry enabled in their IDE.

\n

Note

\n

\nThis endpoint will only return results for a given day if the enterprise team had five or more members with active Copilot licenses, as evaluated at the end of that day.

\n
\n

Owners and billing managers for the enterprise that contains the enterprise team can view Copilot usage metrics for the enterprise team.

\n

OAuth app tokens and personal access tokens (classic) need either the manage_billing:copilot or read:enterprise scopes to use this endpoint.

", - "statusCodes": [ - { - "httpStatusCode": "200", - "description": "

OK

" - }, - { - "httpStatusCode": "401", - "description": "

Requires authentication

" - }, - { - "httpStatusCode": "403", - "description": "

Forbidden

" - }, - { - "httpStatusCode": "404", - "description": "

Resource not found

" - }, - { - "httpStatusCode": "500", - "description": "

Internal Error

" - } - ] - }, - { - "serverUrl": "https://api.github.com", - "verb": "get", - "requestPath": "/orgs/{org}/copilot/usage", - "title": "Get a summary of Copilot usage for organization members", - "category": "copilot", - "subcategory": "copilot-usage", - "parameters": [ - { - "name": "org", - "description": "

The organization name. The name is not case sensitive.

", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "since", - "description": "

Show usage metrics since this date. This is a timestamp in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ). Maximum value is 28 days ago.

", - "in": "query", - "required": false, - "schema": { - "type": "string" - } - }, - { - "name": "until", - "description": "

Show usage metrics until this date. This is a timestamp in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ) and should not preceed the since date if it is passed.

", - "in": "query", - "required": false, - "schema": { - "type": "string" - } - }, - { - "name": "page", - "description": "

The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"

", - "in": "query", - "schema": { - "type": "integer", - "default": 1 - } - }, - { - "name": "per_page", - "description": "

The number of days of metrics to display per page (max 28). For more information, see \"Using pagination in the REST API.\"

", - "in": "query", - "schema": { - "type": "integer", - "default": 28 - } - } - ], - "bodyParameters": [], - "progAccess": { - "userToServerRest": true, - "serverToServer": true, - "fineGrainedPat": true, - "permissions": [ - { - "\"GitHub Copilot Business\" organization permissions": "read" - }, - { - "\"Administration\" organization permissions": "read" - } - ] - }, - "codeExamples": [ - { - "key": "default", - "request": { - "description": "Example", - "acceptHeader": "application/vnd.github.v3+json", - "parameters": { - "org": "ORG" + "org": "ORG" } }, "response": { @@ -239876,11 +239883,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "read" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -266756,11 +266759,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "write" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -266904,11 +266903,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "write" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -267014,11 +267009,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "write" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -267312,11 +267303,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [ - { - "\"Enterprise administration\" business permissions": "write" - } - ] + "permissions": [] }, "codeExamples": [ { @@ -281605,6 +281592,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -282105,6 +282095,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -282728,6 +282719,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -283192,6 +283186,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -283592,6 +283589,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -284185,6 +284185,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -284654,6 +284657,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -285277,6 +285281,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -285741,6 +285748,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -286057,6 +286067,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -286680,6 +286691,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -287144,6 +287158,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -287985,6 +288002,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -288449,6 +288469,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -289302,6 +289325,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -289766,6 +289792,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -291048,6 +291077,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -291512,6 +291544,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -291892,6 +291927,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -292569,6 +292607,7 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, + "comments_enabled": true, "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { @@ -293192,6 +293231,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -293656,6 +293698,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "type": [ "string", @@ -294064,6 +294109,9 @@ "comments": { "type": "integer" }, + "comments_enabled": { + "type": "boolean" + }, "user": { "anyOf": [ { @@ -448718,6 +448766,872 @@ } ] }, + "private-registries": { + "organization-configurations": [ + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries", + "title": "List private registries for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "per_page", + "description": "

The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 30 + } + }, + { + "name": "page", + "description": "

The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"

", + "in": "query", + "schema": { + "type": "integer", + "default": 1 + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "read" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "total_count": 1, + "configurations": [ + { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z", + "visibility": "selected" + } + ] + }, + "schema": { + "type": "object", + "required": [ + "total_count", + "configurations" + ], + "properties": { + "total_count": { + "type": "integer" + }, + "configurations": { + "type": "array", + "items": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": [ + "string", + "null" + ], + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + } + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Lists all private registry configurations available at the organization-level without revealing their encrypted\nvalues.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "400", + "description": "

Bad Request

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "post", + "requestPath": "/orgs/{org}/private-registries", + "title": "Create a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [ + { + "type": "string", + "name": "registry_type", + "in": "body", + "description": "

The registry type.

", + "isRequired": true, + "enum": [ + "maven_repository" + ] + }, + { + "type": "string or null", + "name": "username", + "in": "body", + "description": "

The username to use when authenticating with the private registry. This field should be omitted if the private registry does not require a username for authentication.

" + }, + { + "type": "string", + "name": "encrypted_value", + "in": "body", + "description": "

The value for your secret, encrypted with LibSodium using the public key retrieved from the Get private registries public key for an organization endpoint.

", + "isRequired": true + }, + { + "type": "string", + "name": "key_id", + "in": "body", + "description": "

The ID of the key you used to encrypt the secret.

", + "isRequired": true + }, + { + "type": "string", + "name": "visibility", + "in": "body", + "description": "

Which type of organization repositories have access to the private registry. selected means only the repositories specified by selected_repository_ids can access the private registry.

", + "isRequired": true, + "enum": [ + "all", + "private", + "selected" + ] + }, + { + "type": "array of integers", + "name": "selected_repository_ids", + "in": "body", + "description": "

An array of repository IDs that can access the organization private registry. You can only provide a list of repository IDs when visibility is set to selected. You can manage the list of selected repositories using the Update a private registry for an organization endpoint. This field should be omitted if visibility is set to all or private.

" + } + ], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "write" + } + ] + }, + "codeExamples": [ + { + "key": "org-private-registry-with-private-visibility", + "request": { + "contentType": "application/json", + "description": "Example of a private registry configuration with private visibility", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "registry_type": "maven_repository", + "username": "monalisa", + "encrypted_value": "c2VjcmV0", + "key_id": "012345678912345678", + "visibility": "private" + }, + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "201", + "contentType": "application/json", + "description": "

The organization private registry configuration

", + "example": { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "visibility": "selected", + "selected_repository_ids": [ + 1296269, + 1296280 + ], + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z" + }, + "schema": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": "string", + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry. `selected` means only the repositories specified by `selected_repository_ids` can access the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "selected_repository_ids": { + "type": "array", + "description": "An array of repository IDs that can access the organization private registry when `visibility` is set to `selected`.", + "items": { + "type": "integer" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + }, + { + "key": "org-private-registry-with-selected-visibility", + "request": { + "contentType": "application/json", + "description": "Example of a private registry configuration with selected visibility", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "registry_type": "maven_repository", + "username": "monalisa", + "encrypted_value": "c2VjcmV0", + "key_id": "012345678912345678", + "visibility": "selected", + "selected_repository_ids": [ + 1296269, + 1296280 + ] + }, + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "201", + "contentType": "application/json", + "description": "

The organization private registry configuration

", + "example": { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "visibility": "private", + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z" + }, + "schema": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": "string", + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry. `selected` means only the repositories specified by `selected_repository_ids` can access the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "selected_repository_ids": { + "type": "array", + "description": "An array of repository IDs that can access the organization private registry when `visibility` is set to `selected`.", + "items": { + "type": "integer" + } + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Creates a private registry configuration with an encrypted value for an organization. Encrypt your secret using LibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "201", + "description": "

The organization private registry configuration

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/public-key", + "title": "Get private registries public key for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "read" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

Response

", + "example": { + "key_id": "012345678912345678", + "key": "2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234" + }, + "schema": { + "type": "object", + "required": [ + "key_id", + "key" + ], + "properties": { + "key_id": { + "description": "The identifier for the key.", + "type": "string", + "examples": [ + "012345678912345678" + ] + }, + "key": { + "description": "The Base64 encoded public key.", + "type": "string", + "examples": [ + "2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234" + ] + } + } + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Gets the org public key, which is needed to encrypt private registry secrets. You need to encrypt a secret before you can create or update secrets.

\n

OAuth tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

OK

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "get", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "title": "Get a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "secret_name", + "description": "

The name of the secret.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "read" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG", + "secret_name": "SECRET_NAME" + } + }, + "response": { + "statusCode": "200", + "contentType": "application/json", + "description": "

The specified private registry configuration for the organization

", + "example": { + "name": "MAVEN_REPOSITORY_SECRET", + "registry_type": "maven_repository", + "username": "monalisa", + "visibility": "private", + "created_at": "2019-08-10T14:59:22Z", + "updated_at": "2020-01-10T14:59:22Z" + }, + "schema": { + "title": "Organization private registry", + "description": "Private registry configuration for an organization", + "type": "object", + "properties": { + "name": { + "description": "The name of the private registry configuration.", + "type": "string", + "examples": [ + "MAVEN_REPOSITORY_SECRET" + ] + }, + "registry_type": { + "description": "The registry type.", + "enum": [ + "maven_repository" + ], + "type": "string" + }, + "username": { + "description": "The username to use when authenticating with the private registry.", + "type": [ + "string", + "null" + ], + "examples": [ + "monalisa" + ] + }, + "visibility": { + "description": "Which type of organization repositories have access to the private registry.", + "enum": [ + "all", + "private", + "selected" + ], + "type": "string" + }, + "created_at": { + "type": "string", + "format": "date-time" + }, + "updated_at": { + "type": "string", + "format": "date-time" + } + }, + "required": [ + "name", + "registry_type", + "visibility", + "created_at", + "updated_at" + ] + } + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Get the configuration of a single private registry defined for an organization, omitting its encrypted value.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "200", + "description": "

The specified private registry configuration for the organization

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "patch", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "title": "Update a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "secret_name", + "description": "

The name of the secret.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [ + { + "type": "string", + "name": "registry_type", + "in": "body", + "description": "

The registry type.

", + "enum": [ + "maven_repository" + ] + }, + { + "type": "string or null", + "name": "username", + "in": "body", + "description": "

The username to use when authenticating with the private registry. This field should be omitted if the private registry does not require a username for authentication.

" + }, + { + "type": "string", + "name": "encrypted_value", + "in": "body", + "description": "

The value for your secret, encrypted with LibSodium using the public key retrieved from the Get private registries public key for an organization endpoint.

" + }, + { + "type": "string", + "name": "key_id", + "in": "body", + "description": "

The ID of the key you used to encrypt the secret.

" + }, + { + "type": "string", + "name": "visibility", + "in": "body", + "description": "

Which type of organization repositories have access to the private registry. selected means only the repositories specified by selected_repository_ids can access the private registry.

", + "enum": [ + "all", + "private", + "selected" + ] + }, + { + "type": "array of integers", + "name": "selected_repository_ids", + "in": "body", + "description": "

An array of repository IDs that can access the organization private registry. You can only provide a list of repository IDs when visibility is set to selected. This field should be omitted if visibility is set to all or private.

" + } + ], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "write" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "contentType": "application/json", + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "bodyParameters": { + "username": "monalisa", + "encrypted_value": "c2VjcmV0", + "key_id": "012345678912345678" + }, + "parameters": { + "org": "ORG", + "secret_name": "SECRET_NAME" + } + }, + "response": { + "statusCode": "204", + "description": "

Response

" + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Updates a private registry configuration with an encrypted value for an organization. Encrypt your secret using LibSodium. For more information, see \"Encrypting secrets for the REST API.\"

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "204", + "description": "

No Content

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + }, + { + "httpStatusCode": "422", + "description": "

Validation failed, or the endpoint has been spammed.

" + } + ] + }, + { + "serverUrl": "https://api.github.com", + "verb": "delete", + "requestPath": "/orgs/{org}/private-registries/{secret_name}", + "title": "Delete a private registry for an organization", + "category": "private-registries", + "subcategory": "organization-configurations", + "parameters": [ + { + "name": "org", + "description": "

The organization name. The name is not case sensitive.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "secret_name", + "description": "

The name of the secret.

", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "bodyParameters": [], + "progAccess": { + "userToServerRest": true, + "serverToServer": true, + "fineGrainedPat": true, + "permissions": [ + { + "\"Organization private registries\" organization permissions": "write" + } + ] + }, + "codeExamples": [ + { + "key": "default", + "request": { + "description": "Example", + "acceptHeader": "application/vnd.github.v3+json", + "parameters": { + "org": "ORG", + "secret_name": "SECRET_NAME" + } + }, + "response": { + "statusCode": "204", + "description": "

Response

" + } + } + ], + "previews": [], + "descriptionHTML": "

Note

\n

\nThis endpoint is in public preview and is subject to change.

\n
\n

Delete a private registry configuration at the organization-level.

\n

OAuth app tokens and personal access tokens (classic) need the admin:org scope to use this endpoint.

", + "statusCodes": [ + { + "httpStatusCode": "204", + "description": "

No Content

" + }, + { + "httpStatusCode": "400", + "description": "

Bad Request

" + }, + { + "httpStatusCode": "404", + "description": "

Resource not found

" + } + ] + } + ] + }, "projects": { "projects": [ { @@ -528440,7 +529354,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -575993,8 +576907,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { @@ -582761,7 +583674,7 @@ } ], "previews": [], - "descriptionHTML": "

Lists the latest incremental and backfill scans by type for a repository.

\n

OAuth app tokens and personal access tokens (classic) need the repo or security_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public_repo scope instead.

", + "descriptionHTML": "

Lists the latest default incremental and backfill scans by type for a repository. Scans from Copilot Secret Scanning are not included.

\n

OAuth app tokens and personal access tokens (classic) need the repo or security_events scope to use this endpoint. If this endpoint is only used with public repositories, the token can use the public_repo scope instead.

", "statusCodes": [ { "httpStatusCode": "200", diff --git a/src/rest/data/ghes-3.10-2022-11-28/schema.json b/src/rest/data/ghes-3.10-2022-11-28/schema.json index eff9e6192e08..464a8a4f696b 100644 --- a/src/rest/data/ghes-3.10-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.10-2022-11-28/schema.json @@ -152696,6 +152696,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -212224,7 +212225,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -214773,7 +214773,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -216176,7 +216175,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -222688,7 +222686,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -428957,7 +428954,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -463232,8 +463229,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { diff --git a/src/rest/data/ghes-3.11-2022-11-28/schema.json b/src/rest/data/ghes-3.11-2022-11-28/schema.json index fd42bc789e7a..f806183aa302 100644 --- a/src/rest/data/ghes-3.11-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.11-2022-11-28/schema.json @@ -152721,6 +152721,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -152843,7 +152844,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -212467,7 +212468,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -215016,7 +215016,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -216419,7 +216418,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -222931,7 +222929,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -435329,7 +435326,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -476182,8 +476179,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { diff --git a/src/rest/data/ghes-3.12-2022-11-28/schema.json b/src/rest/data/ghes-3.12-2022-11-28/schema.json index fc11368c9f55..06d216837d36 100644 --- a/src/rest/data/ghes-3.12-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.12-2022-11-28/schema.json @@ -153042,6 +153042,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -153163,7 +153164,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -214704,7 +214705,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -217253,7 +217253,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -218656,7 +218655,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -225168,7 +225166,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -438215,7 +438212,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -479585,8 +479582,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { diff --git a/src/rest/data/ghes-3.13-2022-11-28/schema.json b/src/rest/data/ghes-3.13-2022-11-28/schema.json index a66359286f80..57734584529b 100644 --- a/src/rest/data/ghes-3.13-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.13-2022-11-28/schema.json @@ -153186,6 +153186,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -153307,7 +153308,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -214904,7 +214905,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -217453,7 +217453,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -218856,7 +218855,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -225368,7 +225366,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -440646,7 +440643,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -482728,8 +482725,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { diff --git a/src/rest/data/ghes-3.14-2022-11-28/schema.json b/src/rest/data/ghes-3.14-2022-11-28/schema.json index 2b64dd1def74..0fbac793e0ff 100644 --- a/src/rest/data/ghes-3.14-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.14-2022-11-28/schema.json @@ -153186,6 +153186,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -153307,7 +153308,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -214904,7 +214905,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -217453,7 +217453,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -218856,7 +218855,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -225368,7 +225366,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -443895,7 +443892,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -486464,8 +486461,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { diff --git a/src/rest/data/ghes-3.15-2022-11-28/schema.json b/src/rest/data/ghes-3.15-2022-11-28/schema.json index 2ec158dacb4c..7cf5ed371926 100644 --- a/src/rest/data/ghes-3.15-2022-11-28/schema.json +++ b/src/rest/data/ghes-3.15-2022-11-28/schema.json @@ -153878,6 +153878,7 @@ "items": { "type": "string", "enum": [ + "actions", "c-cpp", "csharp", "go", @@ -153999,7 +154000,7 @@ "type": "array of strings", "name": "languages", "in": "body", - "description": "

CodeQL languages to be analyzed.\nSupported values are: c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" + "description": "

CodeQL languages to be analyzed.\nSupported values are: actions, c-cpp, csharp, go, java-kotlin, javascript-typescript, python, ruby, swift

" } ], "progAccess": { @@ -217825,7 +217826,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -220374,7 +220374,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -221777,7 +221776,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -228289,7 +228287,6 @@ "updated_at": "2022-09-21T10:28:06Z", "description": "An updated gist description.", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/2decf6c462d9b4418f2/comments", "owner": { "login": "monalisa", @@ -447917,7 +447914,7 @@ "type": "array of strings", "name": "names", "in": "body", - "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names cannot contain uppercase letters.

", + "description": "

An array of topics to add to the repository. Pass one or more topics to replace the set of existing topics. Send an empty array ([]) to clear all topics from the repository. Note: Topic names will be saved as lowercase.

", "isRequired": true } ], @@ -491168,8 +491165,7 @@ "userToServerRest": false, "serverToServer": false, "fineGrainedPat": false, - "permissions": [], - "allowPermissionlessAccess": true + "permissions": [] }, "codeExamples": [ { diff --git a/src/rest/lib/config.json b/src/rest/lib/config.json index f1dc9bdc309e..7d2c5b559a81 100644 --- a/src/rest/lib/config.json +++ b/src/rest/lib/config.json @@ -50,5 +50,5 @@ ] } }, - "sha": "99b100d4af04d83bdb08024aa6af991edd2ea02f" + "sha": "917eb60d24132049c50cea80b1e4e8eb3ea4716e" } \ No newline at end of file diff --git a/src/webhooks/lib/config.json b/src/webhooks/lib/config.json index 7327892fa0f2..6491ccdf4f94 100644 --- a/src/webhooks/lib/config.json +++ b/src/webhooks/lib/config.json @@ -1,3 +1,3 @@ { - "sha": "99b100d4af04d83bdb08024aa6af991edd2ea02f" + "sha": "917eb60d24132049c50cea80b1e4e8eb3ea4716e" } \ No newline at end of file