Document comment changes

Clean up, rewording, formatting updates.