doc: improve doc on unintended breaking changes
Improve the material in the Collaborator Guide on unintended breaking changes.
Checklist
-
make -j4 test
(UNIX), orvcbuild test
(Windows) passes -
documentation is changed or added -
commit message follows commit guidelines