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..1f961d64620 --- /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