>However, in the case of v158, it would have been nice to be warned in some way of the many additional pitfalls...

IMHO this is a definite use-case for the hated <blink> tag, to point out in big flashing text in no uncertain terms that trying to integrate ZC158 into an existing shop as an "upgrade" is just not a feasible option/the path of madness. There are too many changes and will introduce multiple break points with mods.

Users should take a new ZC158, import and upgrade their real database and then sequentially add their mods one by one, fixing, fettling and learning along the way.