DOC: fix-up docs for 0.15.2 release

@jreback some more clean-up of whatsnew
+ some small fixes so now everything builds ok, ready for release

I also reworded a little bit the intro of the minor release (I thought was a bit more appropriate for minor release vs major release)
ok by me