Skip to content

Commit 25f2fac

Browse files
Sync from inner source [auto] (#80)
Sync from github/github-well-architected-internal (main) Source Repository: github/github-well-architected-internal Source Branch: main Source SHA: 678864228abe1a73718f4fd1604f1d9577a13445 Co-authored-by: well-architected-sync-bot[bot] <235114805+well-architected-sync-bot[bot]@users.noreply.github.com>
1 parent 6531b37 commit 25f2fac

6 files changed

Lines changed: 1016 additions & 106 deletions

File tree

content/library/governance/recommendations/governance-administration-essentials/index.md

Lines changed: 914 additions & 0 deletions
Large diffs are not rendered by default.

content/library/governance/recommendations/governance-policies-best-practices/index.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,14 @@ github:
6565

6666
Adopting GitHub's general platform best practices is crucial for effectively managing software development projects. These practices provide a structured framework that ensures projects are secure, maintainable, and scalable. By fostering a collaborative and efficient environment, these guidelines help organizations avoid common pitfalls, maintain high-quality codebases, and streamline project workflows. Ultimately, adhering to these best practices leads to successful and sustainable software projects.
6767

68+
For enterprise governance architecture decisions — including structural components, user access models, organization strategies, enterprise policies, billing, repository governance, teams and roles, programmatic access, and audit logs — use the companion guide [Essentials of governance and administration with GitHub Enterprise]({{< relref "../governance-administration-essentials/index.md" >}}).
69+
This article remains focused on high-impact policy guardrails.
70+
71+
For additional topic-specific guidance, see also:
72+
73+
- [Repository rulesets best practices]({{< relref "../managing-repositories-at-scale/rulesets-best-practices.md" >}})
74+
- [Custom properties best practices]({{< relref "../managing-repositories-at-scale/custom-properties-best-practices.md" >}})
75+
6876
## Key design strategies and checklist
6977

7078
Use these key strategies as a baseline to implement GitHub's best practices for governance:
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
<!-- markdownlint-disable MD041 -->
2+
3+
## 2026 Q2
4+
5+
- **New Content: [Governing agents in GitHub Enterprise](/library/governance/recommendations/governing-agents/)** - Published governance and policy guidance for managing GitHub Copilot agents across the enterprise, covering policy configuration, security boundaries, MCP server governance, and audit pipelines
6+
- **New Content: [Essentials of governance and administration with GitHub Enterprise](/library/governance/recommendations/governance-administration-essentials/)** - Published a comprehensive guide for enterprise governance and administration fundamentals, covering structural components, user access models, organization architecture strategies, policy baselines, and operational topics such as billing, repository governance, and audit logging

docs/contributors-montage.png

50.2 KB
Loading

docs/contributors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,6 @@ Thank you to all the amazing people who have contributed to the GitHub Well-Arch
55
<!--- CONTRIBUTORS:START --->
66
![Contributors Montage](contributors-montage.png)
77

8-
@KittyChiu @colossus9 @CallMeGreg @collinmcneese @PickHub @btessiau @sdehm @garnertb @kenmuse @joshjohanning @igwejk @jennysharps @jackie-mak @igorcosta @arilivigni @steffen @pwideman @dhruvg20 @antgrutta @kbridgford @brntbeer @data-douser @ssulei7 @felicitymay @lineville @Jeffrey-Luszcz @Steve-Glass @abhi-dutta @Zenulous @solvaholic @petercort @jc-avella @robandpdx @gitstua @parkerbxyz @andrewakim @thomasphorton @victorp13 @robertpd
8+
@KittyChiu @colossus9 @CallMeGreg @collinmcneese @PickHub @btessiau @sdehm @garnertb @joshjohanning @kenmuse @igwejk @jennysharps @jackie-mak @igorcosta @arilivigni @steffen @pwideman @dhruvg20 @antgrutta @kbridgford @brntbeer @data-douser @ssulei7 @dkalmin @felicitymay @lineville @Jeffrey-Luszcz @Steve-Glass @abhi-dutta @Zenulous @solvaholic @petercort @jc-avella @robandpdx @stephanmiehe @gitstua @parkerbxyz @andrewakim @thomasphorton @victorp13 @robertpd
99

1010
<!--- CONTRIBUTORS:END --->

0 commit comments

Comments
 (0)