<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class="">Donald E. Knuthâs work on Literate Programming may be of interest:<div class=""><br class=""></div><div class=""><<a href="https://en.wikipedia.org/wiki/Literate_programming" class="">https://en.wikipedia.org/wiki/Literate_programming</a>></div><div class=""><<a href="http://www.literateprogramming.com/knuthweb.pdf" class="">http://www.literateprogramming.com/knuthweb.pdf</a>></div><div class=""><<a href="https://cs.stanford.edu/~knuth/lp.html" class="">https://cs.stanford.edu/~knuth/lp.html</a>></div><div class=""><br class=""></div><div class=""><span class="Apple-tab-span" style="white-space:pre"> </span>Ken G. Brown<br class=""><div><br class=""><blockquote type="cite" class=""><div class="">On Feb 19, 2018, at 11:18, tim Rowledge <<a href="mailto:tim@rowledge.org" class="">tim@rowledge.org</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div class=""><br class=""><br class=""><blockquote type="cite" class="">On 19-02-2018, at 7:23 AM, Tony Garnock-Jones <<a href="mailto:tonyg@leastfixedpoint.com" class="">tonyg@leastfixedpoint.com</a>> wrote:<br class=""><br class="">(I spent rather too much time writing documentation.)<br class=""></blockquote><br class="">I'm pretty sure that is impossible except in the very special sense of spending time getting it wrong and having to redo it. Which probably in't even a mistake in truth.<br class=""><br class="">I really wish the software world in general would live by the aphorism "don't document the program, program the document" rather than "comments? why do you think we call it code?"<br class=""><br class=""><br class="">tim<br class="">--<br class="">tim Rowledge; <a href="mailto:tim@rowledge.org" class="">tim@rowledge.org</a>; <a href="http://www.rowledge.org/tim" class="">http://www.rowledge.org/tim</a><br class="">Useful random insult:- Diarrhea of the mouth; constipation of the ideas.<br class=""><br class=""></div></div></blockquote></div><br class=""></div></body></html>