diff --git a/assets/images/help/repository/repo-actions-settings.png b/assets/images/help/repository/repo-actions-settings.png index 8970b388a1..9e7590c9f4 100644 Binary files a/assets/images/help/repository/repo-actions-settings.png and b/assets/images/help/repository/repo-actions-settings.png differ diff --git a/content/admin/configuration/configuring-network-settings/configuring-dns-nameservers.md b/content/admin/configuration/configuring-network-settings/configuring-dns-nameservers.md index 3f32767170..7cc26a40e1 100644 --- a/content/admin/configuration/configuring-network-settings/configuring-dns-nameservers.md +++ b/content/admin/configuration/configuring-network-settings/configuring-dns-nameservers.md @@ -30,16 +30,12 @@ The nameservers you specify must resolve {% data variables.product.product_locat {% data reusables.enterprise_installation.ssh-into-instance %} -2. To edit your nameservers, enter: +2. To edit your nameservers, use the `ghe-setup-network` command in visual mode. For more information, see "[Command-line utilities](/admin/configuration/configuring-your-enterprise/command-line-utilities#ghe-setup-network)." ```shell - sudo vim /etc/resolvconf/resolv.conf.d/head + ghe-setup-network -v ``` -{% data reusables.enterprise_installation.preventing-nameservers-change %} - -3. Append any `nameserver` entries, then save the file. -4. After verifying your changes, save the file. 5. To add your new nameserver entries to {% data variables.product.product_location %}, run the following: ```shell diff --git a/content/admin/configuration/configuring-your-enterprise/command-line-utilities.md b/content/admin/configuration/configuring-your-enterprise/command-line-utilities.md index 71543e2a68..3afde5fc5c 100644 --- a/content/admin/configuration/configuring-your-enterprise/command-line-utilities.md +++ b/content/admin/configuration/configuring-your-enterprise/command-line-utilities.md @@ -343,6 +343,18 @@ With `ghe-set-password`, you can set a new password to authenticate into the [{% ghe-set-password ``` +### ghe-setup-network + +This utility allows you to configure the primary network interface. + +To enter visual mode, which will guide you through configuration of network settings: + +```shell +$ ghe-setup-network -v +``` + +Use the -h flag for additional options. + ### ghe-ssh-check-host-keys This utility checks the existing SSH host keys against the list of known leaked SSH host keys. diff --git a/content/developers/apps/building-oauth-apps/scopes-for-oauth-apps.md b/content/developers/apps/building-oauth-apps/scopes-for-oauth-apps.md index a3d1695958..32e1cda6ea 100644 --- a/content/developers/apps/building-oauth-apps/scopes-for-oauth-apps.md +++ b/content/developers/apps/building-oauth-apps/scopes-for-oauth-apps.md @@ -42,7 +42,7 @@ Name | Description -----|-----------|{% ifversion not ghae %} **`(no scope)`** | Grants read-only access to public information (including user profile info, repository info, and gists){% endif %}{% ifversion ghes or ghae %} **`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/rest/reference/enterprise-admin).{% endif %} -**`repo`** | Grants full access to repositories, including private repositories. That includes read/write access to code, commit statuses, repository and organization projects, invitations, collaborators, adding team memberships, deployment statuses, and repository webhooks for repositories and organizations. Also grants ability to manage user projects. +**`repo`** | Grants full access to public{% ifversion ghec or ghes or ghae %}, internal,{% endif %} and private repositories including read and write access to code, commit statuses, repository invitations, collaborators, deployment statuses, and repository webhooks. **Note**: In addition to repository related resources, the `repo` scope also grants access to manage organization-owned resources including projects, invitations, team memberships and webhooks. This scope also grants the ability to manage projects owned by users.  `repo:status`| Grants read/write access to commit statuses in {% ifversion fpt %}public and private{% elsif ghec or ghes %}public, private, and internal{% elsif ghae %}private and internal{% endif %} repositories. This scope is only necessary to grant other users or services access to private repository commit statuses *without* granting access to the code.  `repo_deployment`| Grants access to [deployment statuses](/rest/reference/repos#deployments) for {% ifversion not ghae %}public{% else %}internal{% endif %} and private repositories. This scope is only necessary to grant other users or services access to deployment statuses, *without* granting access to the code.{% ifversion not ghae %}  `public_repo`| Limits access to public repositories. That includes read/write access to code, commit statuses, repository projects, collaborators, and deployment statuses for public repositories and organizations. Also required for starring public repositories.{% endif %} diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md b/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md index e269e27e29..ad972bcb42 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/attaching-files.md @@ -16,11 +16,7 @@ topics: - Pull requests --- -{% warning %} - -**Warning:** If you attach a file to a pull request or issue comment, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. To keep sensitive media files private, serve them from a private network or server that requires authentication. {% ifversion fpt or ghec %}For more information on anonymized URLs see "[About anonymized URLs](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} - -{% endwarning %} +{% data reusables.repositories.anyone-can-view-anonymized-url %} To attach a file to an issue or pull request conversation, drag and drop it into the comment box. Alternatively, you can click the bar at the bottom of the comment box to browse, select, and add a file from your computer. diff --git a/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md b/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md index 6a28e0fdb7..658fa51f1c 100644 --- a/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md +++ b/content/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls.md @@ -44,6 +44,15 @@ Within conversations on {% data variables.product.product_name %}, references to If you reference an issue, pull request, or discussion in a list, the reference will unfurl to show the title and state instead. For more information about task lists, see "[About task lists](/issues/tracking-your-work-with-issues/creating-issues/about-task-lists)." {% endif %} +## Labels +When referencing the URL of a label in Markdown, the label is automatically rendered. Only labels of the same repository are rendered, URLs pointing to a label from a different repository are rendered as any [URL](/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#urls). + +The URL of a label can be found by navigating to the labels page and clicking on a label. For example, the URL of the label "enhancement" in our public [docs repository](https://github.com/github/docs/) is + +```md +https://github.com/github/docs/labels/enhancement +``` + ## Commit SHAs References to a commit's SHA hash are automatically converted into shortened links to the commit on {% data variables.product.product_name %}. diff --git a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md index 219fb4280e..d5cee8b617 100644 --- a/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md +++ b/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md @@ -52,6 +52,7 @@ To search for specific events, use the `action` qualifier in your query. Actions | [`discussion_post_reply`](#discussion_post_reply-category-actions) | Contains all activities related to replies to discussions posted to a team page.{% ifversion fpt or ghes or ghec %} | [`enterprise`](#enterprise-category-actions) | Contains activities related to enterprise settings. | {% endif %} | [`hook`](#hook-category-actions) | Contains all activities related to webhooks. +| [`integration_installation`](#integration_installation-category-actions) | Contains activities related to integrations installed in an account. | | [`integration_installation_request`](#integration_installation_request-category-actions) | Contains all activities related to organization member requests for owners to approve integrations for use in the organization. |{% ifversion ghec or ghae %} | [`ip_allow_list`](#ip_allow_list-category-actions) | Contains activities related to enabling or disabling the IP allow list for an organization. | [`ip_allow_list_entry`](#ip_allow_list_entry-category-actions) | Contains activities related to the creation, deletion, and editing of an IP allow list entry for an organization.{% endif %} @@ -361,6 +362,21 @@ An overview of some of the most common actions that are recorded as events in th | `destroy` | Triggered when an existing hook was removed from a repository. | `events_changed` | Triggered when the events on a hook have been altered. +### `integration_installation` category actions + +| Action | Description +|--------|------------- +| `contact_email_changed` | A contact email for an integration was changed. +| `create` | An integration was installed. +| `destroy` | An integration was uninstalled. +| `repositories_added` | Repositories were added to an integration. +| `repositories_removed` | Repositories were removed from an integration. +{%- ifversion fpt or ghec %} +| `suspend` | An integration was suspended. +| `unsuspend` | An integration was unsuspended. +{%- endif %} +| `version_updated` | Permissions for an integration were updated. + ### `integration_installation_request` category actions | Action | Description diff --git a/data/reusables/copilot/dotcom-settings.md b/data/reusables/copilot/dotcom-settings.md index 49c4afdfd7..1ec55e6348 100644 --- a/data/reusables/copilot/dotcom-settings.md +++ b/data/reusables/copilot/dotcom-settings.md @@ -2,7 +2,9 @@ Once you have an active {% data variables.product.prodname_copilot %} trial or subscription, you can adjust {% data variables.product.prodname_copilot %} settings for your personal account on {% data variables.product.prodname_dotcom %} in the [{% data variables.product.prodname_copilot %} settings](https://github.com/settings/copilot). The settings apply anywhere that you use {% data variables.product.prodname_copilot %}. You can configure the suggestions that {% data variables.product.prodname_copilot %} offers and how {% data variables.product.company_short %} uses your telemetry data. -### Enabling or disabling duplication detection +## Enabling or disabling duplication detection + +{% data variables.product.prodname_copilot %} includes a filter which detects code suggestions matching public code on {% data variables.product.prodname_dotcom %}. You can choose to enable or disable the filter. When the filter is enabled, {% data variables.product.prodname_copilot %} checks code suggestions with their surrounding code of about 150 characters against public code on {% data variables.product.prodname_dotcom %}. If there is a match or near match, the suggestion will not be shown to you. {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} @@ -10,12 +12,16 @@ Once you have an active {% data variables.product.prodname_copilot %} trial or s ![Screenshot of duplication detection option](/assets/images/help/copilot/duplication-detection.png) {% data reusables.copilot.save-settings %} -### Enabling or disabling telemetry +## Enabling or disabling telemetry -You can configure how {% data variables.product.prodname_copilot %} uses your data. For more information about data that {% data variables.product.prodname_copilot %} may collect depending on your telemetry settings, see "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)." +You can choose whether your code snippets are collected and retained by GitHub and further processed and shared with Microsoft and OpenAI by adjusting your user settings. For more information about data that {% data variables.product.prodname_copilot %} may collect depending on your telemetry settings, see "[{% data variables.product.company_short %} Terms for Additional Products and Features](/free-pro-team@latest/site-policy/github-terms/github-terms-for-additional-products-and-features#github-copilot)" and the [{% data variables.product.prodname_copilot %} privacy FAQ](https://github.com/features/copilot/#faq-privacy). {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.copilot-settings %} 1. To allow or prevent {% data variables.product.prodname_dotcom %} using your telemetry data, select or deselect **Allow {% data variables.product.prodname_dotcom %} to use my code snippets for product improvements**. ![Screenshot of telemetry option](/assets/images/help/copilot/telemetry-option.png) {% data reusables.copilot.save-settings %} + +## Further reading + +- [{% data variables.product.prodname_copilot %} FAQ](https://github.com/features/copilot/#faq) \ No newline at end of file diff --git a/data/reusables/gated-features/code-scanning.md b/data/reusables/gated-features/code-scanning.md index a42ea0458d..247c6f564a 100644 --- a/data/reusables/gated-features/code-scanning.md +++ b/data/reusables/gated-features/code-scanning.md @@ -1,7 +1,13 @@ -{% ifversion fpt %} {% data variables.product.prodname_code_scanning_capc %} is available for all public repositories. {% data variables.product.prodname_code_scanning_capc %} is also available in private repositories owned by organizations that use {% data variables.product.prodname_ghe_cloud %} and have a license for {% data variables.product.prodname_GH_advanced_security %}. -{%- elsif ghec %} {% data variables.product.prodname_code_scanning_capc %} is available for all public repositories, and for private repositories owned by organizations where {% data variables.product.prodname_GH_advanced_security %} is enabled. -{%- elsif ghes %}{% data variables.product.prodname_code_scanning_capc %} is available for organization-owned repositories where {% data variables.product.prodname_GH_advanced_security %} is enabled. +{%- ifversion fpt %} +{% data variables.product.prodname_code_scanning_capc %} is available for all public repositories on {% data variables.product.prodname_dotcom_the_website %}. {% data variables.product.prodname_code_scanning_capc %} is also available for private repositories owned by organizations that use {% data variables.product.prodname_ghe_cloud %} and have a license for {% data variables.product.prodname_GH_advanced_security %}. + +{%- elsif ghec %} +{% data variables.product.prodname_code_scanning_capc %} is available for all public repositories on {% data variables.product.prodname_dotcom_the_website %}. To use {% data variables.product.prodname_code_scanning %} in a private repository owned by an organization, you must have a license for {% data variables.product.prodname_GH_advanced_security %}. + +{%- elsif ghes %} +{% data variables.product.prodname_code_scanning_capc %} is available for organization-owned repositories in {% data variables.product.product_name %}. This feature requires a license for {% data variables.product.prodname_GH_advanced_security %}. + {%- elsif ghae %} -{% data variables.product.prodname_code_scanning_capc %} is available as part of {% data variables.product.prodname_GH_advanced_security %}, which is free during the beta release. -{%- else %} -{% data variables.product.prodname_code_scanning_capc %} is available if you have a license for {% data variables.product.prodname_GH_advanced_security %}.{% endif %} {% data reusables.advanced-security.more-info-ghas %} +{% data variables.product.prodname_code_scanning_capc %} is available for organization-owned repositories in {% data variables.product.product_name %}. This is a {% data variables.product.prodname_GH_advanced_security %} feature (free during the beta release). + +{%- endif %} For more information, see "[GitHub's products](/articles/githubs-products)." \ No newline at end of file diff --git a/data/reusables/gated-features/copilot.md b/data/reusables/gated-features/copilot.md index 012cabe648..4acb15a9e0 100644 --- a/data/reusables/gated-features/copilot.md +++ b/data/reusables/gated-features/copilot.md @@ -1 +1 @@ -{% data variables.product.prodname_copilot %} is available to {% data variables.product.company_short %} customers with a personal account on {% data variables.product.prodname_dotcom_the_website %}. {% data variables.product.prodname_copilot %} is free to use for verified students and open source maintainers. If you are not a student or open source maintainer, you can try {% data variables.product.prodname_copilot %} for free with a one-time 60 day trial. After the free trial, you will need a paid subscription for continued use. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)." +{% data variables.product.prodname_copilot %} is available to {% data variables.product.company_short %} customers with a personal account on {% data variables.product.prodname_dotcom_the_website %}. {% data variables.product.prodname_copilot %} is free to use for verified students and maintainers of popular open source projects. If you are not a student or maintainer of a popular open source project, you can try {% data variables.product.prodname_copilot %} for free with a one-time 60 day trial. After the free trial, you will need a paid subscription for continued use. For more information, see "[About billing for {% data variables.product.prodname_copilot %}](/billing/managing-billing-for-github-copilot/about-billing-for-github-copilot)." diff --git a/data/reusables/repositories/anyone-can-view-anonymized-url.md b/data/reusables/repositories/anyone-can-view-anonymized-url.md new file mode 100644 index 0000000000..df6bf85408 --- /dev/null +++ b/data/reusables/repositories/anyone-can-view-anonymized-url.md @@ -0,0 +1,5 @@ +{% warning %} + +**Warning:** If you attach a file to a pull request, issue comment, or ticket in the {% data variables.contact.support_portal %}, anyone can view the anonymized URL without authentication, even if the pull request is in a private repository{% ifversion ghes %}, or if private mode is enabled{% endif %}. To keep sensitive media files private, serve them from a private network or server that requires authentication. {% ifversion fpt or ghec %}For more information on anonymized URLs see "[About anonymized URLs](/github/authenticating-to-github/about-anonymized-urls)".{% endif %} + +{% endwarning %} diff --git a/data/reusables/support/submit-a-ticket.md b/data/reusables/support/submit-a-ticket.md index 996722fd36..6418a84693 100644 --- a/data/reusables/support/submit-a-ticket.md +++ b/data/reusables/support/submit-a-ticket.md @@ -36,6 +36,8 @@ - Steps to reproduce the issue - Any special circumstances surrounding the discovery of the issue (for example, the first occurrence or occurrence after a specific event, frequency of occurrence, business impact of the problem, and suggested urgency) - Exact wording of error messages +{% indented_data_reference reusables.repositories.anyone-can-view-anonymized-url spaces=3 %} + {%- ifversion ghes %} 1. Optionally, attach diagnostics files and other files by dragging and dropping, uploading, or pasting from the clipboard. {%- endif %}