Skip to content

Commit c198673

Browse files
authored
Consolidate “Protecting branches in your enterprise with rulesets” (#62634)
1 parent 719be3d commit c198673

4 files changed

Lines changed: 14 additions & 54 deletions

File tree

content/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,14 @@ versions:
66
feature: enterprise-code-rulesets
77
permissions: Enterprise owners
88
shortTitle: Create rulesets
9+
redirect_from:
10+
- /enterprise-onboarding/govern-people-and-repositories/protect-branches
11+
- /enterprise-onboarding/feature-enhancements/about-rulesets
912
contentType: how-tos
1013
category:
1114
- Secure and govern your enterprise
15+
docsTeamMetrics:
16+
- enterprise-onboarding
1217
---
1318

1419
## Introduction
@@ -17,12 +22,14 @@ category:
1722

1823
To learn more, see [AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets).
1924

25+
As you onboard your enterprise, rulesets are how you apply consistent protections across many repositories at once, rather than configuring each repository individually.
26+
27+
If you have used **branch protection rules** on individual repositories, rulesets serve a similar goal at enterprise scale. Unlike a branch protection rule, which applies to a single repository, a ruleset can target many organizations, repositories, and branches at the same time, and you can set it to an evaluate status to preview its impact before you enforce it.
28+
2029
## Importing rulesets
2130

2231
To import a prebuilt ruleset created by {% data variables.product.company_short %}, see [`github/ruleset-recipes`](https://github.com/github/ruleset-recipes).
2332

24-
{% data reusables.repositories.import-a-ruleset-conceptual %} For more information, see [AUTOTITLE](/organizations/managing-organization-settings/managing-rulesets-for-repositories-in-your-organization#using-ruleset-history).
25-
2633
## How will I define where my ruleset applies?
2734

2835
Rulesets allow you to flexibly target the organizations, repositories, and branches where you want rules to apply.
@@ -62,9 +69,7 @@ The following are eligible for bypass access:
6269
* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#limitations-in-copilot-cloud-agents-compatibility-with-other-features).
6370
{%- endif %}
6471

65-
1. To grant bypass permissions for the ruleset, in the "Bypass list" section, click **Add bypass**.
66-
67-
1. In the "Add bypass" modal dialog that appears, search for the role, team, or app you would like to grant bypass permissions, then select the role, team, or app from the "Suggestions" section and click Add Selected.
72+
1. In the "Bypass list" section, click **Add bypass**, then search for and select the role, team, or app you want to grant bypass permissions, and click **Add Selected**.
6873

6974
{% data reusables.repositories.rulesets-branch-tag-bypass-optional-step %}
7075

@@ -125,8 +130,7 @@ You can grant certain roles, teams, or apps bypass permissions as well as the ab
125130
* {% data variables.copilot.copilot_cloud_agent %}. For more information about {% data variables.copilot.copilot_cloud_agent %}, see [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-cloud-agent#limitations-in-copilot-cloud-agents-compatibility-with-other-features).
126131
{%- endif %}
127132

128-
1. To grant bypass permissions for the ruleset, in the "Bypass list" section, click **Add bypass**.
129-
1. In the "Add bypass" modal dialog that appears, search for the role, team, or app you would like to grant bypass permissions, then select the role, team, or app from the "Suggestions" section and click Add Selected.
133+
1. In the "Bypass list" section, click **Add bypass**, then search for and select the role, team, or app you want to grant bypass permissions, and click **Add Selected**.
130134

131135
### Choosing which organizations to target in your enterprise
132136

content/enterprise-onboarding/govern-people-and-repositories/index.md

Lines changed: 0 additions & 12 deletions
This file was deleted.

content/enterprise-onboarding/govern-people-and-repositories/protect-branches.md

Lines changed: 0 additions & 32 deletions
This file was deleted.

content/enterprise-onboarding/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ journeyTracks:
3232
- href: '/admin/concepts/security-and-compliance/enterprise-policies'
3333
- href: '/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/managing-custom-properties-for-repositories-in-your-enterprise'
3434
- href: '/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/governing-how-people-use-repositories-in-your-enterprise'
35-
- href: '/enterprise-onboarding/govern-people-and-repositories/protect-branches'
35+
- href: '/admin/enforcing-policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-governance'
3636
- href: '/admin/concepts/security-and-compliance/audit-log-for-an-enterprise'
3737
- id: 'github_apps'
3838
title: 'Automating processes with GitHub Apps'
@@ -43,11 +43,11 @@ journeyTracks:
4343
- href: '/apps/using-github-apps/installing-a-github-app-on-your-enterprise'
4444
versions:
4545
ghec: '*'
46-
children:
47-
- /govern-people-and-repositories
46+
children: []
4847
redirect_from:
4948
- /enterprise-onboarding/feature-enhancements
5049
- /enterprise-onboarding/getting-started-with-your-enterprise
50+
- /enterprise-onboarding/govern-people-and-repositories
5151
docsTeamMetrics:
5252
- enterprise-onboarding
5353
---

0 commit comments

Comments
 (0)