DOC: addressing comments by @adamrp and @ElDeveloper
DOC: addressing comments by @adamrp
DOC: changelog additions, comment by @ElDeveloper