doc: list breaking changes

List git commits introducing breaking changes in the documentation, for quick reference. Also add a table for deprecated APIs.

The result can be seen at: https://lisa-linux-integrated-system-analysis.readthedocs.io/en/test-rtd/transition_guide.html#breaking-changes