docs: move organization practices into guides#29331
Conversation
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>
There was a problem hiding this comment.
Pull request overview
Moves the Organization Practices documentation section under Guides, aligning the sidebar IA, content paths, and redirects with the new location.
Changes:
- Relocates Organization Practices docs to
docs/src/content/docs/guides/organization-practices/(overview + child pages). - Updates Starlight sidebar to nest the Organization Practices group under the Guides section.
- Adds redirects from legacy
/organization-practices/...routes to/gh-aw/guides/organization-practices/....
Show a summary per file
| File | Description |
|---|---|
| docs/astro.config.mjs | Moves nav group under Guides and adds legacy-path redirects to the new Guides routes. |
| docs/src/content/docs/organization-practices/index.mdx | Removes the old top-level Organization Practices landing page from the previous location. |
| docs/src/content/docs/guides/organization-practices/index.mdx | Adds the Organization Practices landing page at the new Guides location. |
| docs/src/content/docs/guides/organization-practices/safe-rollout.md | Adds the Safe Rollout guide page under the new section path. |
| docs/src/content/docs/guides/organization-practices/sharing-workflows.md | Adds the Sharing Workflows guide page under the new section path. |
Copilot's findings
Tip
Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
- Files reviewed: 3/5 changed files
- Comments generated: 1
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Comment MemoryNote This comment is managed by comment memory.It stores persistent context for this thread in the code block at the top of this comment. |
Visual Regression Check
PR Summary (static analysis)This PR restructures documentation navigation by moving the Organization Practices section from a top-level sidebar group into Guides → Organization Practices:
Redirect rules for old URLs are present in Visual / Accessibility Check Status
To run this check manually: cd docs && npm run dev
# then run Playwright against (localhost/redacted)
|
This updates the docs IA so Organization Practices lives under Guides instead of as a top-level section. The change aligns sidebar structure, content paths, and legacy URL handling around the new location.
Navigation
Organization Practicesgroup into theGuidessidebar section indocs/astro.config.mjsContent paths
docs/src/content/docs/guides/organization-practices//guides/organization-practices/...Redirect compatibility
/organization-practices/...paths to the new/guides/organization-practices/...routes