update copyright year
replace use of 'note' with a more correct 'versionadded' directive
Merge pull request #18 from tshepang/temp

some improvements to the docs