A tangential point is that the syntax coloring configuration in the editor should emphasize comments. If comments are de-emphasized (e.g. grayed out compared t

A tangential point is that the syntax coloring configuration in the editor should emphasize comments. If comments are de-emphasized (e.g. grayed out compared to code) you will get bad comments and comments out of sync with the code.