Skip to content

Repo sync #38704

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 7 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ You can also contribute by creating a local environment or opening a Codespace.

<img alt="Contribution call-to-action" src="./contributing/images/contribution_cta.png" width="400">

For more complex contributions, please open an issue using the most appropriate [issue template](https://github.com/github/docs/issues/new/choose) to describe the changes you'd like to see.
For more complex contributions, please [open an issue in the docs-content repo](https://github.com/github/docs-content/issues/new/choose) describing the changes you'd like to see.

If you're looking for a way to contribute, you can scan through our [help wanted board](https://github.com/github/docs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22) to find open issues already approved for work.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,16 @@ Before starting this section, ensure you have followed steps **1 to 4** in [AUTO
1. Click **Configure API integration**.
1. In the "API Token" field, enter the {% data variables.product.pat_v1 %} belonging to the setup user.

{% data reusables.scim.import-groups-unsupported %}
{% data reusables.scim.import-groups-unsupported %}

{% ifversion ghec %}

> [!IMPORTANT]
> For an enterprise on {% data variables.enterprise.data_residency %} (GHE.com), please enter the following URL in the **Base URL** field: {% raw %}`https://api.{subdomain}.ghe.com/scim/v2/enterprises/{subdomain}`{% endraw %} (ensuring to replace {% raw %}`{subdomain}`{% endraw %} with your enterprise's subdomain).
>
> **For example**: if your enterprise's subdomain is {% raw %}`acme`{% endraw %}, the base URL would be {% raw %}`https://api.acme.ghe.com/scim/v2/enterprises/acme`{% endraw %}.

{% endif %}

1. Click **Test API Credentials**. If the test is successful, a verification message will appear at the top of the screen.
1. To save the token, click **Save**.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,10 @@ Using an **incognito or private browsing window**:
1. Enable two-factor authentication (2FA), and save the recovery codes. See [AUTOTITLE](/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication).

> [!WARNING]
> All subsequent login attempts for the setup user account will require a successful 2FA challenge response or the use of an enterprise recovery code to complete authentication. To avoid being locked out of your account, after enabling single sign-on, save your enterprise recovery codes. See [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes#downloading-codes-for-an-enterprise-with-enterprise-managed-users).
> All subsequent login attempts for the setup user account will require a successful 2FA challenge response.

> [!IMPORTANT]
> If the enterprise account has enabled single sign-on and the setup user hasn’t enabled 2FA, they must use an enterprise recovery code to authenticate. To avoid being locked out of your account, after enabling single sign-on, save your enterprise recovery codes. For more information, see [AUTOTITLE](/admin/managing-iam/managing-recovery-codes-for-your-enterprise/downloading-your-enterprise-accounts-single-sign-on-recovery-codes#downloading-codes-for-an-enterprise-with-enterprise-managed-users) and the related [changelog in our {% data variables.product.prodname_blog %}](https://github.blog/changelog/2025-01-17-setup-user-for-emu-enterprises-requires-2fa-or-use-of-a-recovery-code/).

{% data reusables.enterprise-accounts.emu-password-reset-session %}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ Check if you need to upgrade the following applications:
> [!NOTE]
> Hotpatches require a configuration run, which can cause a brief period of errors or unresponsiveness for some or all services on {% data variables.location.product_location %}. You are not required to enable maintenance mode during installation of a hotpatch, but doing so will guarantee that users see a maintenance page instead of errors or timeouts. See [AUTOTITLE](/admin/configuration/configuring-your-enterprise/enabling-and-scheduling-maintenance-mode).
* Patch releases using an upgrade package typically require less than five minutes of downtime.
* Upgrading to a new feature release that include data migrations may cause a few hours of downtime, depending on storage performance and the amount of data that is migrated. During this time none of your users will be able to use the enterprise.
* Upgrading to a new feature release that includes data migrations may cause a few hours of downtime, depending on storage performance and the amount of data that is migrated. During this time none of your users will be able to use the enterprise.{% ifversion ghes > 3.16 %} You may notice that upgrades to a new feature release take less time. This is because selective database transitions will now run concurrently, with the number of concurrent workers defaulting to the number of CPU cores, up to a maximum of 16.{% endif %}

## Communicating your upgrade

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -94,8 +94,6 @@ Generally, the outside collaborator and repository collaborator roles are equiva
* Repository collaborators cannot bypass single sign-on (SSO) requirements, because SSO is managed at the enterprise level in an {% data variables.enterprise.prodname_emu_enterprise %}. However, like outside collaborators, they do not need to provide SSO authorization of credentials for organizations where they are a collaborator.
* Repository collaborators are subject to your enterprise IP allow list policy and your identity provider's conditional access policy. However, they are not subject to the organization's IP allow list policy.

{% data reusables.repositories.repository-collaborators-release-phase %}

{% endif %}

#### Managing outside collaborators{% ifversion repository-collaborators %} or repository collaborators{% endif %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ permissions: People with admin access to a repository can add an outside collabo
{% ifversion fpt %}
Organizations that use {% data variables.product.prodname_ghe_cloud %} can restrict the ability to invite collaborators. For more information, see [AUTOTITLE](/enterprise-cloud@latest/organizations/managing-organization-settings/setting-permissions-for-adding-outside-collaborators) in the {% data variables.product.prodname_ghe_cloud %} documentation.
{% else %}
An organization owner can restrict the ability to invite collaborators. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/setting-permissions-for-adding-outside-collaborators).
Organization and enterprise owners can restrict the ability to invite collaborators. For more information, see [AUTOTITLE](/organizations/managing-organization-settings/setting-permissions-for-adding-outside-collaborators) and [AUTOTITLE](/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-inviting-outside-collaborators-to-repositories).
{% endif %}

{% ifversion ghes %}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,6 @@ This overview can help you audit access to your repository, onboard or off-board

If you're a member of an {% data variables.enterprise.prodname_emu_enterprise %}, you can invite a member of your enterprise to collaborate in a repository that either a user or organization owns. The invited user will only have access to the repository, even if the repository belongs to an organization. The user must be provisioned by your company's identity provider (IdP). For more information, see [AUTOTITLE](/organizations/managing-peoples-access-to-your-organization-with-roles/roles-in-an-organization#outside-collaborators-or-repository-collaborators).

{% data reusables.repositories.repository-collaborators-release-phase %}

{% endif %}

For more information about repository roles, see [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/permission-levels-for-a-personal-account-repository) and [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization).
Expand Down

This file was deleted.

This file was deleted.

6 changes: 4 additions & 2 deletions data/ui.yml
Original file line number Diff line number Diff line change
Expand Up @@ -66,8 +66,10 @@ search:
ai_title: There was an error loading Copilot.
description: You can still use this field to search our docs.
cta:
heading: New! Copilot for Docs
description: Ask your question in the search bar and get help in seconds.
heading: Get quick answers!
description: Ask Copilot your question.
dismiss: Dismiss
ask_copilot: Ask Copilot
old_search:
description: Enter a search term to find it in the GitHub Docs.
placeholder: Search GitHub Docs
Expand Down
15 changes: 15 additions & 0 deletions src/audit-logs/data/ghes-3.14/organization.json
Original file line number Diff line number Diff line change
Expand Up @@ -389,6 +389,21 @@
"description": "Triggered when a team discussion post is edited.",
"docs_reference_links": "/communities/moderating-comments-and-conversations/managing-disruptive-comments#editing-a-comment"
},
{
"action": "enterprise_announcement.create",
"description": "A global announcement banner was created for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner"
},
{
"action": "enterprise_announcement.destroy",
"description": "A global announcement banner was removed from the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_announcement.update",
"description": "A global announcement banner was updated for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_installation.create",
"description": "The GitHub App associated with a GitHub Connect connection was created.",
Expand Down
15 changes: 15 additions & 0 deletions src/audit-logs/data/ghes-3.15/organization.json
Original file line number Diff line number Diff line change
Expand Up @@ -389,6 +389,21 @@
"description": "Triggered when a team discussion post is edited.",
"docs_reference_links": "/communities/moderating-comments-and-conversations/managing-disruptive-comments#editing-a-comment"
},
{
"action": "enterprise_announcement.create",
"description": "A global announcement banner was created for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner"
},
{
"action": "enterprise_announcement.destroy",
"description": "A global announcement banner was removed from the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_announcement.update",
"description": "A global announcement banner was updated for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_installation.create",
"description": "The GitHub App associated with a GitHub Connect connection was created.",
Expand Down
15 changes: 15 additions & 0 deletions src/audit-logs/data/ghes-3.16/organization.json
Original file line number Diff line number Diff line change
Expand Up @@ -419,6 +419,21 @@
"description": "Triggered when a team discussion post is edited.",
"docs_reference_links": "/communities/moderating-comments-and-conversations/managing-disruptive-comments#editing-a-comment"
},
{
"action": "enterprise_announcement.create",
"description": "A global announcement banner was created for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner"
},
{
"action": "enterprise_announcement.destroy",
"description": "A global announcement banner was removed from the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_announcement.update",
"description": "A global announcement banner was updated for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_installation.create",
"description": "The GitHub App associated with a GitHub Connect connection was created.",
Expand Down
15 changes: 15 additions & 0 deletions src/audit-logs/data/ghes-3.17/organization.json
Original file line number Diff line number Diff line change
Expand Up @@ -454,6 +454,21 @@
"description": "Triggered when a team discussion post is edited.",
"docs_reference_links": "/communities/moderating-comments-and-conversations/managing-disruptive-comments#editing-a-comment"
},
{
"action": "enterprise_announcement.create",
"description": "A global announcement banner was created for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner"
},
{
"action": "enterprise_announcement.destroy",
"description": "A global announcement banner was removed from the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_announcement.update",
"description": "A global announcement banner was updated for the enterprise.",
"docs_reference_links": "/admin/managing-accounts-and-repositories/communicating-information-to-users-in-your-enterprise/customizing-user-messages-for-your-enterprise"
},
{
"action": "enterprise_installation.create",
"description": "The GitHub App associated with a GitHub Connect connection was created.",
Expand Down
2 changes: 1 addition & 1 deletion src/audit-logs/lib/config.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": "ec298358d957110bcdd9b7921afd7d4ab23107dd"
"sha": "e14b4ba692f0019ca81fd2843ae8445239cf480e"
}
4 changes: 3 additions & 1 deletion src/automated-pipelines/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,15 @@ Automated pages allow for manually created content to be prepended to the automa
## How does it work

We currently have two patterns that we used to create automated pipelines:

- REST, Webhooks, GitHub Apps, and GraphQL pipelines consume external structured data and transform that data into a JSON file that is used to create content for a page on docs.github.com. Typically, data files are a 1:1 mapping to a specific page on docs.github.com.
- The CodeQL CLI pipeline takes an unstructured ReStructuredText file and transforms it directly into a Markdown file with frontmatter, that uses the same authoring format as the rest of the docs.

## Creating a new pipeline

Each pipeline should be evaluated individually to determine the best architecture for simplicity, maintainability, and requirements.
Each pipeline should be evaluated individually to determine the best architecture for simplicity, maintainability, and requirements.
For example:

- Is the content being displayed basic Markdown content? For example, does the content avoid using complex tables and interactive elements? If so, then writing the Markdown content directly and avoiding the need to create a structured data file that requires a React component may be the best approach. This was the case for the CodeQL CLI pipeline. One caveat to think about before writing Markdown directly is whether the content will need liquid versioning. The current pipeline that writes Markdown directly does not need to use liquid versioning. Liquid versioning which would increase the complexity quite a bit. All of the Markdown content in each article that is generated from the CodeQL CLI pipeline applies to all versions listed in the `versions` frontmatter property, simplifying the Markdown generation process.
- Is the page interactive like the REST and Webhooks pages? If so, then the data will likely need to be structured data. In that case, a new React component may be needed to display the data.

Expand Down
2 changes: 1 addition & 1 deletion src/automated-pipelines/lib/config.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,4 +6,4 @@
"rest",
"webhooks"
]
}
}
Loading
Loading