DOC: add some highlights to release notes and reorganize

also minor general documentation fixes
[ci skip]