Hi Tim, Thanks! for such a detailed response. Really got things in perspective for me, my thinking yet isn't of such large scale.
So you say literate programming is for those who are writing code that will live for decades to come and that writing literate programs takes ~3x resources. Is there a stripped down version of literate programming that will benefit the majority of programmers who are just average coders, writing a few APIs etc. that would probably take say ~1.5x resources? I'm just curious as the concept seems really good. I'm not sure how many people are willing to do 3x work for writing their APIs. I absolutely agree with your point of documenting (with the goal of communicating to people) design decisions; and comments are not enough for the same. Very recently I started to get interested in code formalism (i.e. mathematically proving programs), although literate programming is not geared in this direction, it might play its part. - Thanks -- You received this message because you are subscribed to the Google Groups "Clojure" group. To post to this group, send email to clojure@googlegroups.com Note that posts from new members are moderated - please be patient with your first post. To unsubscribe from this group, send email to clojure+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/clojure?hl=en