#3235·zola

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/