Update breaking changes docs

This commit adds further content to the breaking changes docs to highlight the high level changes.
All public API type headers are now [discrete] rather than [float], so that they do not appear in the side nav.

Author: russcam