Self-documenting code is a myth. Code only communicates action, not intent. Nor does it communicate assumptions about input constraints.
-
-
@paulg As a non-LISP native, I bet a simple code comment on that would get me to comprehension much faster. =) -
@mojombo You raise an interesting point, which is that code, like writing, has an intended audience. -
@paulg Yes! But there is also a temporal component. What is obvious to the coder NOW may be very much non-obvious to a reader years later. -
@mojombo@paulg My favorite reason to write documentation: http://docs.writethedocs.org/writing/beginners-guide-to-docs/#you-will-be-using-your-code-in-6-months … -
@ericholscher@paulg Yes, absolutely! Think of your future self! -
-
@ericholscher@paulg That's an awesome metaphor. Serialization of brain state. Love it.
End of conversation
New conversation -
-
-
-
@danb415
@paulg That's super helpful, but doesn't answer a great many questions about what that code might do. What resources, for example?
End of conversation
New conversation -
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.