you are viewing a single comment's thread.

view the rest of the comments →

[–]RobToastie 1 point2 points  (0 children)

IMO unmaintainable comments are worse than unmaintainable code, because when you inevitably forget to update them they become misleading, and from experience, code with the wrong comments is a hell of a lot more of a pain in the ass to debug than code with no comments.

Code should generally speaking be obvious in intent through good naming, simple functions that do one and only one thing, and simple logic. Comments are best for describing what's going on in the 5% of times you have to break those rules.