<https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=273859#c5>:
> how can we document all these breakages and workarounds, so that people can just do the equivalent of `do-release-upgrade`?
I guess, for some types of issue there can be a package message.