LPS-48146 add documentation on breaking