Skip to content

Migration guide: point Paths 7 and 8 at the current 2026.6.4 baseline#21

Merged
OnlyTerp merged 2 commits into
masterfrom
devin/1781761103-migration-path-consistency
Jun 18, 2026
Merged

Migration guide: point Paths 7 and 8 at the current 2026.6.4 baseline#21
OnlyTerp merged 2 commits into
masterfrom
devin/1781761103-migration-path-consistency

Conversation

@OnlyTerp

@OnlyTerp OnlyTerp commented Jun 18, 2026

Copy link
Copy Markdown
Owner

Summary

Follow-up to #20. That PR updated migration Paths 9, 10, and the new Path 12 to route upgraders to the current 2026.6.4 stable baseline, but Paths 7 and 8 still named superseded endpoints, leaving an inconsistent upgrade narrative (flagged by Devin Review on #20):

  • Path 7 (v2026.4.27 → v2026.4.29-beta.1) ended with "continue to 2026.5.22 stable".
  • Path 8 (v2026.4.29-beta.1 → v2026.5.12 stable) ended with "continue to Path 10 before experimenting with 2026.5.24-beta.1" (since promoted to stable in 2026.5.26).

Both now route through Path 10 and Path 12 to 2026.6.4, matching how Paths 9/10 already read.

Type of change

  • Correction to an existing part
  • Version bump (OpenClaw version)
  • New part
  • Benchmark / data addition
  • Tooling / CI / meta

Review checklist

  • Added or updated cross-links from the README TOC and any related parts
  • Sources / release notes linked in the PR description (not inline as footnotes)
  • Ran markdownlint-cli2 and lychee --offline locally (0 errors, 0 broken links)
  • No speculation presented as fact

Notes / flagged items

  • Docs-only, single file (part26-migration-guide.md). No intermediate-step facts changed — only the "where to go next" endpoints.

Link to Devin session: https://app.devin.ai/sessions/3b1d5b0b85964b2bb4b87bab0979ed3f
Requested by: @OnlyTerp


Open in Devin Review

Paths 9/10/12 were updated in #20 but Paths 7 and 8 still referenced superseded
endpoints (2026.5.22 / 2026.5.24-beta.1). Point them through Path 10 and Path 12.

Co-Authored-By: Rob <onerobby@gmail.com>
@devin-ai-integration

Copy link
Copy Markdown
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Devin Review found 1 potential issue.

Open in Devin Review

Comment thread part26-migration-guide.md Outdated
## Path 7: v2026.4.27 stable → v2026.4.29-beta.1

Former beta jump. If you're upgrading today, treat this as the conceptual migration step for memory/messaging behavior and then continue to 2026.5.22 stable.
Former beta jump. If you're upgrading today, treat this as the conceptual migration step for memory/messaging behavior, then continue through Path 10 and Path 12 to the current 2026.6.4 stable baseline.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Path 7 forward-reference skips required intermediate Path 8

Path 7 ends at v2026.4.29-beta.1, but the updated text tells readers to "continue through Path 10 and Path 12" — skipping Path 8 entirely. Path 10 (part26-migration-guide.md:256) accepts v2026.5.14-beta.1 / v2026.5.12 as input, not v2026.4.29-beta.1. Readers following this guidance literally would skip Path 8 (v2026.4.29-beta.1 → v2026.5.12 stable) and land on a Path 10 whose input version range doesn't include where they are. The old text ("continue to 2026.5.22 stable") was vague but version-correct; the new text is specific but omits a required step. Compare with Path 9 at line 233, which correctly says "continue through Path 10 and Path 12" because Path 9 ends at v2026.5.14-beta.1, which Path 10 does accept.

Suggested change
Former beta jump. If you're upgrading today, treat this as the conceptual migration step for memory/messaging behavior, then continue through Path 10 and Path 12 to the current 2026.6.4 stable baseline.
Former beta jump. If you're upgrading today, treat this as the conceptual migration step for memory/messaging behavior, then continue through Path 8, Path 10, and Path 12 to the current 2026.6.4 stable baseline.
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correct — Path 7 ends at 2026.4.29-beta.1 and Path 10 only accepts 5.12/5.14-beta.1, so it has to pass through Path 8 first. Fixed in 47131e6: now "continue through Path 8, Path 10, and Path 12."

Path 7 ends at 2026.4.29-beta.1; Path 10 accepts 5.12/5.14-beta.1, so the chain
must pass through Path 8 (4.29-beta.1 -> 5.12) first.

Co-Authored-By: Rob <onerobby@gmail.com>
@OnlyTerp OnlyTerp merged commit 3668541 into master Jun 18, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant