Suggestion: Maintain a page with breaking changes like apache superset does. https://github.com/apache/superset/blob/master/UPDATING.md. While github releases are good, the way apache superset has been doing it https://github.com/apache/superset/tree/master/RELEASING/release-notes-1-2 is great

Thanks for the suggestion! We recently started auto-generating a Releases page here (https://datahubproject.io/docs/releases). Hopefully we can follow a similar process to document breaking changes as well (culled from release notes)