LPS-47559 Document breaking changes

Hey @pablocp, send this over to you again because I was not sure about the nested fields. Could you double check?

Thanks