some docs cleanups + changelog (#3122)

2 files changed