logoalt Hacker News

waterheatertoday at 5:07 PM0 repliesview on HN

I remember hearing once that a core element of collegiate humanities education involves teaching that a great work can only be understood and appreciated when the reader first understands the work's context. Only then should the reader attempt to summit the great work.

Of course, this is also true in engineering disciplines as well. Perhaps the greatest software engineering work is the Linux kernel. Open the repo, and navigate to a random line in a random file. The odds that you will understand exactly--and I mean exactly--what occurs on that particular line on your first read without an explanatory comment is relatively low. If, however, you consider header files, libraries, how the file fits into the broader kernel, language features, and additional contextual information, your ability to understand that line of code increases significantly.