LPS-44342 document breaking changes

First pull with a documented breaking change :)