Speaking as MODX Chief Architect, MODX development has adopted the rules of
Semantic Versioning. And of course, any API changes, breaking or not, will be documented.
Bug fixes not affecting the API increment the patch version, backwards compatible API additions/changes increment the minor version, and backwards incompatible API changes increment the major version.
This has not always been the way we've done things, but will be moving forward.