started work on docs
further docs improvements
upgrade docs merged
Merge pull request #1842 from evildmp/docs3

Release notes docs minor rewrites