Introducing Upgrading & Blog
sincev5.10.0 2026-09-05Guides and API docs change version to version, but some content is point-in-time: release announcements, deprecation guides, and one-off migration guides. That content needs a stable home whose URLs don't move under it.
Starting today, warp-drive.io has two new top-level sections for exactly this:
- Upgrading — major-version upgrade guides, and eventually deprecation guidance and feature-specific migration guides, organized by major version.
- Blog (this section) — release posts and other announcements, dual-published here so that non-Ember consumers of WarpDrive* don't have to go looking for them on blog.emberjs.com.
Both sections share the same guarantee: a published URL here is never renamed and never unpublished. If a page is fully superseded, it stays in place, is marked superseded, and links forward to whatever replaced it.
As a first step, the guides that used to live at /guides/migrating/ have moved to /upgrading/v5/ — their old URLs still resolve and now point readers to the new location.
This is the first piece of the plan described in issue #11028. Next up: bringing deprecation guides in from deprecations.emberjs.com and setting up dual-publishing for release posts from blog.emberjs.com.