3 ms·
I don’t need no stinking comments Literate programs are not comments. Literate programming is no "documenting". Literate programming is communicating ideas a
by daly 7y ago
I don’t need no stinking comments
Literate programs are not comments.
Literate programming is no "documenting".
Literate programming is communicating ideas and details to other humans. A physics textbook is not "documenting physics".
Cut out all the equations in a physics textbook. PUt them on index cards. Throw away the textbook. Now try to learn physics "from the code".
Confusing literate programming with "comments" and "documentation" is a clear indication of a lack of understanding about what it means to communicate.