DOC: fix signature of NpyIter_GetIterNext in capi doc
DOC: add highlights to release notes and rewrite and move some sections

closes gh-3842, gh-3843
Merge pull request #3868 from charris/forwardport-1.9-3859

Forwardport 1.9 3859