docs(#631): de-duplicate versioning.md (.github-private is authoritative)

[don-petry]

Closes #631. Follow-up to epic #613.

What

Epic #613 (#624) copied docs/release/versioning.md into .github, creating a duplicate that has since diverged from the .github-private original.

.github's own standards already name .github-private as authoritative (ci-standards.md; agent-canary-rings-adr.md links there), and the doc covers cut-release.sh which lives in .github-private.

Change

• Remove docs/release/versioning.md (the redundant feat(#613): relocate canary-rollout engine + bootstrap into .github (workflow disabled) #624 copy).
• Repoint canary-rollout-adr.md's two links to the .github-private canonical URL.

No content lost. No broken relative links remain (verified). markdownlint clean.

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated release-notes cross-references to point to the current online versioning documentation.
  • Removed an outdated release/versioning guide from the documentation set.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 23ce104f-7e80-4493-a4d6-667bd8fe4186

📥 Commits

Reviewing files that changed from the base of the PR and between 10241b4 and dbb5375.

📒 Files selected for processing (2)

• docs/initiatives/canary-rollout-adr.md
• docs/release/versioning.md

💤 Files with no reviewable changes (1)

• docs/release/versioning.md

---

📝 Walkthrough

Walkthrough

This PR removes the duplicated docs/release/versioning.md file and updates two references in docs/initiatives/canary-rollout-adr.md to point to the canonical .github-private absolute URL instead of the previous relative path, reformatting surrounding text accordingly.

Changes

Versioning doc de-duplication

Layer / File(s)	Summary
Repoint references and remove duplicate docs/initiatives/canary-rollout-adr.md, docs/release/versioning.md	The Context and References sections' links to versioning.md are changed from relative paths to absolute .github-private GitHub URLs with reformatted text, and the duplicated versioning.md file is deleted entirely.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• petry-projects/.github#624: Original PR that added the canary-rollout-adr.md reference and the duplicated docs/release/versioning.md file now being cleaned up.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: removing the duplicate versioning doc and keeping the .github-private copy authoritative.
Linked Issues check	✅ Passed	The PR deletes the redundant versioning.md copy and repoints the two ADR links to the canonical .github-private URL as requested.
Out of Scope Changes check	✅ Passed	All changes relate to de-duplicating versioning docs and updating references; no unrelated edits are evident.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix-631-dedup-versioning

---

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.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[don-petry]

Dev-Lead — waiting on PR blockers (intent: review-changes)

PR: #632
No changes were committed, but the PR still has blocking checks or reviews (failing or cancelled checks, or changes-requested reviews). The retry cron will re-attempt automatically. Next attempt after: 2026-07-09T19:21:04Z

[don-petry]

Note

@don-petry I reviewed this PR and no code changes were needed, but it still has blocking checks or reviews (failing or cancelled checks, or changes-requested reviews), so I cannot mark it done yet. I'll re-check automatically.
Next attempt after: 2026-07-09T19:21:04Z

[gemini-code-assist]

Warning

Gemini encountered an error creating the review. You can try again by commenting /gemini review.

[Copilot]

Pull request overview

Removes a duplicated versioning.md document from this repo and updates references to point at the canonical .github-private copy, avoiding ongoing divergence while keeping the documentation source-of-truth co-located with the tooling it describes.

Changes:

• Deleted docs/release/versioning.md (redundant, diverging copy).
• Updated docs/initiatives/canary-rollout-adr.md to link to the canonical .github-private versioning.md URL in both referenced locations.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
docs/release/versioning.md	Removes the redundant local copy to prevent further divergence from the canonical doc in .github-private.
docs/initiatives/canary-rollout-adr.md	Repoints references from the removed relative doc to the canonical .github-private URL.

[don-petry]

Dev-Lead — fix-bot-comment (no-changes)

Agent reasoning

Issues addressed: 0
- Bot encountered an error generating review; no specific findings provided
Files changed: 0
Tier 1 blockers: 0
```
**Analysis:**
The bot comment is an error from the Gemini reviewer—it failed to generate a review and doesn't contain any specific code findings. Looking at the actual PR state:
1. **CI status:** All checks are passing or in progress. No failures, timeouts, or action-required states.
2. **Reviews:** Only the `copilot-pull-request-reviewer[bot]` has reviewed (state: `COMMENTED`, no changes requested). It reviewed both changed files and generated no comments.
3. **Tier 1 blockers:** None (no failed checks, no `CHANGES_REQUESTED` reviews).
**PR changes (verified):**
- Deleted `docs/release/versioning.md` (redundant copy)
- Updated `docs/initiatives/canary-rollout-adr.md` (two references redirected to `.github-private` canonical URL)
Since the bot provided no actionable code findings, only an error message about its own failure, and all other checks pass with no reviewer objections, **no code changes are needed**. The PR is ready.