From ac2ca658802ab1fd893f2be758e039e9321b7548 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 30 Apr 2026 14:22:03 +0000 Subject: [PATCH 1/2] docs: move organization practices under guides Agent-Logs-Url: https://github.com/github/gh-aw/sessions/05e5c5c1-e886-4909-8fe0-a8fb77694e51 Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com> --- docs/astro.config.mjs | 21 ++++++++++++------- .../guides/organization-practices/index.mdx | 19 +++++++++++++++++ .../organization-practices/safe-rollout.md | 0 .../sharing-workflows.md | 0 .../docs/organization-practices/index.mdx | 19 ----------------- 5 files changed, 32 insertions(+), 27 deletions(-) create mode 100644 docs/src/content/docs/guides/organization-practices/index.mdx rename docs/src/content/docs/{ => guides}/organization-practices/safe-rollout.md (100%) rename docs/src/content/docs/{ => guides}/organization-practices/sharing-workflows.md (100%) delete mode 100644 docs/src/content/docs/organization-practices/index.mdx diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs index 9c2901f88fc..67ff08e1611 100644 --- a/docs/astro.config.mjs +++ b/docs/astro.config.mjs @@ -95,6 +95,11 @@ export default defineConfig({ '/reference/custom-agents/': '/gh-aw/reference/copilot-custom-agents/', '/reference/custom-agent/': '/gh-aw/reference/custom-agent-for-aw/', + // Organization Practices moved under Guides + '/organization-practices/': '/gh-aw/guides/organization-practices/', + '/organization-practices/safe-rollout/': '/gh-aw/guides/organization-practices/safe-rollout/', + '/organization-practices/sharing-workflows/': '/gh-aw/guides/organization-practices/sharing-workflows/', + // Guides → Patterns renames '/guides/chatops/': '/gh-aw/patterns/chat-ops/', '/guides/issueops/': '/gh-aw/patterns/issue-ops/', @@ -269,6 +274,14 @@ export default defineConfig({ { label: 'GitHub Actions Primer', link: '/guides/github-actions-primer/' }, { label: 'Maintaining Repositories', link: '/guides/maintaining-repos/' }, { label: 'Network Configuration', link: '/guides/network-configuration/' }, + { + label: 'Organization Practices', + items: [ + { label: 'Overview', link: '/guides/organization-practices/' }, + { label: 'Safe Rollout', link: '/guides/organization-practices/safe-rollout/' }, + { label: 'Sharing Workflows', link: '/guides/organization-practices/sharing-workflows/' }, + ], + }, { label: 'Reusing Workflows', link: '/guides/packaging-imports/' }, { label: 'Serena', link: '/guides/serena/' }, { label: 'Using Custom MCPs', link: '/guides/mcps/' }, @@ -279,14 +292,6 @@ export default defineConfig({ { label: 'Audit Reports', link: '/guides/audit-with-agents/' }, ], }, - { - label: 'Organization Practices', - items: [ - { label: 'Overview', link: '/organization-practices/' }, - { label: 'Safe Rollout', link: '/organization-practices/safe-rollout/' }, - { label: 'Sharing Workflows', link: '/organization-practices/sharing-workflows/' }, - ], - }, { label: 'Design Patterns', items: [ diff --git a/docs/src/content/docs/guides/organization-practices/index.mdx b/docs/src/content/docs/guides/organization-practices/index.mdx new file mode 100644 index 00000000000..ab629cedb41 --- /dev/null +++ b/docs/src/content/docs/guides/organization-practices/index.mdx @@ -0,0 +1,19 @@ +--- +title: Organization Practices +description: Guidance for adopting, sharing, and governing GitHub Agentic Workflows across teams and repositories. +--- + +Organization Practices collects guidance that matters at team and enterprise scale such as: + +- Safe rollout strategies before production writes are enabled +- Workflow sharing across repositories and organizations +- Centralized ownership models for workflow infrastructure +- Platform conventions for versioning, review, and promotion + +### Safe Rollout + +[Safe Rollout](/gh-aw/guides/organization-practices/safe-rollout/) describes how to move from report-only or staged behavior to production writes with evidence and control. One technique inside that progression is shadow evaluation, where the workflow writes to a safe non-production target before promotion. + +### Sharing Workflows + +[Sharing Workflows](/gh-aw/guides/organization-practices/sharing-workflows/) describes how workflows can be reused across repositories and organizations. It covers imports, reusable components, and central workflow repositories. \ No newline at end of file diff --git a/docs/src/content/docs/organization-practices/safe-rollout.md b/docs/src/content/docs/guides/organization-practices/safe-rollout.md similarity index 100% rename from docs/src/content/docs/organization-practices/safe-rollout.md rename to docs/src/content/docs/guides/organization-practices/safe-rollout.md diff --git a/docs/src/content/docs/organization-practices/sharing-workflows.md b/docs/src/content/docs/guides/organization-practices/sharing-workflows.md similarity index 100% rename from docs/src/content/docs/organization-practices/sharing-workflows.md rename to docs/src/content/docs/guides/organization-practices/sharing-workflows.md diff --git a/docs/src/content/docs/organization-practices/index.mdx b/docs/src/content/docs/organization-practices/index.mdx deleted file mode 100644 index a70553aa7d2..00000000000 --- a/docs/src/content/docs/organization-practices/index.mdx +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Organization Practices -description: Guidance for adopting, sharing, and governing GitHub Agentic Workflows across teams and repositories. ---- - -Organization Practices collects guidance that matters at team and enterprise scale such as: - -- Safe rollout strategies before production writes are enabled -- Workflow sharing across repositories and organizations -- Centralized ownership models for workflow infrastructure -- Platform conventions for versioning, review, and promotion - -### Safe Rollout - -[Safe Rollout](/gh-aw/organization-practices/safe-rollout/) describes how to move from report-only or staged behavior to production writes with evidence and control. One technique inside that progression is shadow evaluation, where the workflow writes to a safe non-production target before promotion. - -### Sharing Workflows - -[Sharing Workflows](/gh-aw/organization-practices/sharing-workflows/) describes how workflows can be reused across repositories and organizations. It covers imports, reusable components, and central workflow repositories. \ No newline at end of file From 776ad3ab43384d965c26498fdb912d2188046d3a Mon Sep 17 00:00:00 2001 From: Mara Nikola Kiefer <8320933+mnkiefer@users.noreply.github.com> Date: Thu, 30 Apr 2026 16:36:16 +0200 Subject: [PATCH 2/2] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/src/content/docs/guides/organization-practices/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/src/content/docs/guides/organization-practices/index.mdx b/docs/src/content/docs/guides/organization-practices/index.mdx index ab629cedb41..1f961d64620 100644 --- a/docs/src/content/docs/guides/organization-practices/index.mdx +++ b/docs/src/content/docs/guides/organization-practices/index.mdx @@ -10,10 +10,10 @@ Organization Practices collects guidance that matters at team and enterprise sca - Centralized ownership models for workflow infrastructure - Platform conventions for versioning, review, and promotion -### Safe Rollout +## Safe Rollout [Safe Rollout](/gh-aw/guides/organization-practices/safe-rollout/) describes how to move from report-only or staged behavior to production writes with evidence and control. One technique inside that progression is shadow evaluation, where the workflow writes to a safe non-production target before promotion. -### Sharing Workflows +## Sharing Workflows [Sharing Workflows](/gh-aw/guides/organization-practices/sharing-workflows/) describes how workflows can be reused across repositories and organizations. It covers imports, reusable components, and central workflow repositories. \ No newline at end of file