loading...

re: Don't document your code. Code your documentation. VIEW POST

TOP OF THREAD FULL DISCUSSION
re: This is forgetting the (few) times you have to document why you are doing something non-obvious. I otherwise agree documenting the "what" is genera...
 

Documenting the why, rather than the what, can be absolutely crucial. As for comments being easier to understand than code being extracted into separate functions; I'd say there is far more chance of a comment being out of date than a function name (although the latter is also entirely a possibility).

Code of Conduct Report abuse