Uh oh!
There was an error while loading. Please reload this page.
docs: Phase 3 Part 2 — Fix supporting documentation issues - #1638
Merged
mergify[bot] merged 1 commit intoAug 8, 2026
Conversation
Fix issues identified in ADDITIONAL_DOCS_AUDIT.md: **ARCHITECTURE.md:** - Update Release Workflow data flow to show develop-first stacked PR model - Replace bullet-point workflow list with table format for clarity - Add cross-references to RELEASE_PROCESS.md and ADRs - Include authorization gating in flow diagram - Reference post-release sync process **AUTOMATION.md:** - Fix workflow table: change release.yml trigger from "main" to "manual (workflow_dispatch)" - Clarify that release workflow doesn't run automatically on push - Update main branch section to explain stacked PR flow accurately - Add reference to RELEASE_PROCESS.md for complete release details - Clarify post-release-sync.yml role in keeping branches in sync **DEPLOY.md:** - Add section explaining integration with release workflow - Clarify that website deploys automatically on each push to develop - Note that releases trigger website updates via PR #1 merge - Cross-reference RELEASE_PROCESS.md for release details These fixes ensure documentation accurately reflects the develop-first release flow and authorization gating strategy implemented in Phase 1-2. Related: Phase 3 (Design & Documentation) planning Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
Contributor
Important Review skippedAuto reviews are disabled on base/target branches other than the default branch. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Repository YAML (base), Organization UI (inherited) Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Contributor
✅ Template check passed after update. Thanks for fixing the PR description. |
Contributor
Merge Queue Status
This pull request spent 11 seconds in the queue, including 1 second running CI. Required conditions to merge |
mergifyBot
merged commit Aug 8, 2026
c88ff1c
into
design/release-process-redesign-phase3
6 of 7 checks passed
Uh oh!
There was an error while loading. Please reload this page.
6 tasks
42 tasks
ashleyshaw added a commit
that referenced
this pull request
Aug 8, 2026
) * docs: Add Architecture Decision Records and flow diagrams for release process Phase 3 (Design & Documentation) — Part 1: - Create docs/ADRs/ directory with 4 architectural decisions - ADR-001: Develop-first stacked PR flow (rationale, alternatives, implementation) - ADR-002: Authorization gating strategy (role-based, audit logging) - ADR-003: Post-release sync automation (keep main/develop in sync) - ADR-004: Rollback & error handling (semi-automated with manual control) - Add Mermaid flow diagrams to RELEASE_PROCESS.md: - Full release flow (authorization → publish) - Authorization validation flow - Post-release sync flow - Rollback decision tree - Cross-reference ADRs from RELEASE_PROCESS.md - Update version to v3.1.0 (added documentation) These ADRs document the major design decisions made during Phase 1-2 implementation, providing context for future maintainers and supporting team training. Related: ADRs linked to specific sections in RELEASE_PROCESS.md Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com> * docs: Fix supporting documentation issues (Phase 3 Part 2) (#1638) Fix issues identified in ADDITIONAL_DOCS_AUDIT.md: **ARCHITECTURE.md:** - Update Release Workflow data flow to show develop-first stacked PR model - Replace bullet-point workflow list with table format for clarity - Add cross-references to RELEASE_PROCESS.md and ADRs - Include authorization gating in flow diagram - Reference post-release sync process **AUTOMATION.md:** - Fix workflow table: change release.yml trigger from "main" to "manual (workflow_dispatch)" - Clarify that release workflow doesn't run automatically on push - Update main branch section to explain stacked PR flow accurately - Add reference to RELEASE_PROCESS.md for complete release details - Clarify post-release-sync.yml role in keeping branches in sync **DEPLOY.md:** - Add section explaining integration with release workflow - Clarify that website deploys automatically on each push to develop - Note that releases trigger website updates via PR #1 merge - Cross-reference RELEASE_PROCESS.md for release details These fixes ensure documentation accurately reflects the develop-first release flow and authorization gating strategy implemented in Phase 1-2. Related: Phase 3 (Design & Documentation) planning Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com> --------- Co-authored-by: Claude Haiku 4.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Linked issues
Relates to #1558 (CHILD-016: Documentation Reorganization Plan)
Relates to #1546 (EPIC: Release Process Redesign)
What changed
Audience & placement
Notes
Changelog
Changed
Checklist (Global DoD / PR)
🤖 Generated with Claude Code