Overall I liked this article. It only touches points I've come across before (I would have liked to see at least one reference to one of the many existing articles on the topic), but the specific examples offer an opportunity for re-evaluating my understanding.
But this bothered me:
It’s always better to have too many comments than none at all.
Be careful with absolutes. This is certainly not true. Comments add nothing to simple, straight-forward, self-documenting code.
E.g., Christian Dohnert's example:
// returns name of person
public String getName(){return this.name}
For further actions, you may consider blocking this person and/or reporting abuse
We're a place where coders share, stay up-to-date and grow their careers.
Overall I liked this article. It only touches points I've come across before (I would have liked to see at least one reference to one of the many existing articles on the topic), but the specific examples offer an opportunity for re-evaluating my understanding.
But this bothered me:
Be careful with absolutes. This is certainly not true. Comments add nothing to simple, straight-forward, self-documenting code.
E.g., Christian Dohnert's example: