Ideally we should have:

• Higher level update notes in docs. This would also work as a general migration guide.
• Complete list of changes in a changelog in the repo itself.

This is definitely not doable fir 3.0.x considering the length of the development but we should follow this strictly from 3.0.0 and up.