minor fixes to improve documentation