3 ms·
The point is not whether to comment or not - it is just to do whatever it takes to make what is happening on every level more understandable whenever there's th
by placebo 10y ago
The point is not whether to comment or not - it is just to do whatever it takes to make what is happening on every level more understandable whenever there's the slightest doubt that it might appear unclear to anyone else (including the future you). It doesn't matter if it requires rewriting the function, adding a link to more in-depth documentation or populating the code with ASCII art of wild flowers - just make sure that the next person that has to understand the code won't curse you...