minor, documentation related edits. Some thinking