update existing comment style, add comments for the methods missing them