Good code is its own best documentation
Amit Shekhar
1.2K69
If your code is self-explanatory, there’s no need for comments and documentations, most of the time.
Ah, the ever-popular “end the statement with something that renders the previous bit meaningless” bit.
“There’s no need for comments and documentation. Most of the time”
Well, most of the time, the code’s going to work. It’s when things go haywire that you suddenly need more than the“you have the source code, what else do you need” schtick. Like why, and there is no code, no matter how clear, that documents why, and why is regularly far, far more important than either how or what.
Even if your code is self-explanatory, you always need comments and documentation. Always.