|
|
|
|
|
by throwk8s
1431 days ago
|
|
I find that terseness has a real downside when debugging code. If you need to get down to the level of what is actually executing, having to unpack all that compact code involves many more things than I can keep in my short-term memory. Compactness is great for things that are true and work, but when there's a bug in there somewhere, terse code requires a lot of scribbling on paper. |
|
Many programmers instead see self-documenting code as the ideal outcome: maybe not very compact, but virtually free of comments (and with documentation at least partially autogenerated).
In reality, successful open-source projects tend to have many comments in the source code. Often not one-liners, but detailed descriptions of functions, their arguments and algorithms, motivation for the choice of the implementation and so on.