Insufficient detail about 0.23 breaking changes
Author: tschundlerCreated Aug 11, 2026Updated Sep 7, 2026
Documentation issue
Summary
v0.23 basically breaks any existing Zola user with the tera2 migration. There is no clear changelog or migration guide. There isn't a rollback guide either. (I think I'll have to cargo install with a tag?)
Proposed solution
Include a clearly labeled migration guide on the https://www.getzola.org/documentation/getting-started/overview/ docs site.
And/or for releases with breaking changes, have a migration + release notes like Bevy: https://bevy.org/learn/migration-guides/introduction/ Bevy breaks a lot often, but it's less painful when there is a document explaining what changes are needed and small examples.
Or Django also has excellent release notes https://docs.djangoproject.com/en/6.1/releases/
Source: getzola/zola