a bit more fixes of docs, and updated CHANGELOG.md