News for hackers. Stuff that matters.
Re:Should You Comment Your Code? by _lce0 on Wednesday January 14, 2015 @01:22PM (#8888009)
Leaving aside code documentation (aka dockblocks), I can think of dozen of examples where you MUST comment you code..

  - strict order of execution
  - math formulas in the code (or its results)
  - external systems requirements/hacks
  - non-explicit side effects
  - legacy or costly known issues
  - intention of cryptic code
  - design choices (and its tradeoff)
  - ..
This obviously implies you actually care about who will maintain such best

There are no comments on this comment yet.