Add section about comments, also fix some code blocks