various fixes to documentation
'Release: 1.0.0rc3'