I just did some major overhaul on the mkps.html article in our master branch (sorry, German only for the next days). Feel free to check after midnight to find out what’s new in 2.2.0.
And yes: we have to better communicate breaking changes, and we have to better communicate which command output is intended for parsing by scripts and which is only intended to be human-readable.