Documentation fixes

Comments for significant changes inline.