DEV Community

Discussion on: The ONE book every developer MUST read!

Collapse
 
combinatorylogic profile image
combinatorylogic

Code cannot express things external to code, such as - implicit assumptions about input data, performance considerations, all the background theory and extensive research put into the resulting optimised algorithm, experimental results (such as performance measurements) taken into account, and so on.

I believe in the very opposite approach - Literate Programming. You must have more comments than code, because code is the easy part, all the background thought trail is hard and must be recorded. No way you'll put it in your variable names.

Some comments have been hidden by the post's author - find out more