News for hackers. Stuff that matters.
Re:Programming as Theory Building (1985) [pdf] by ColinWright on Monday August 19, 2019 @05:13AM (#20736162)
The last paragraph:

    Documentation cannot--and so need
    not--say everything. Its purpose is
    to help the next programmer build an
    accurate theory about the system.
Re:Programming as Theory Building (1985) [pdf] by defined on Monday August 19, 2019 @05:14PM (#20741894)
I keep sending copies of this paper to numerous colleagues. AFAIK almost none of them finished (or even started) reading it. I’m at a loss to explain why, since it is such a deeply insightful paper.