Breaking changes

Breaking changes should be documented:
- in the nuget release notes (steps + automation TBD)
- in any relevant part of the code (e.g. for deprecated functions)