With respect to "documentation" of open source software... "You keep using that word. I don't think it means what you think it means." -- "The Princess Bride"
The notion that "reading the code" is the ultimate truth for "documentation" is based on a misunderstanding at so many levels it is hard to explain. In fact, most of the ideas don't begin to cover "documenting the system". Fortunately, Robert Lefkowitz absolutely illuminates the scope of the problem in these delightful talks. For those who have not heard it, this is truly a treat. For those who "document" this is a must-hear. Robert Lefkowitz -- The Semasiology of Open Source http://web.archive.org/web/20130729214526id_/http://itc.conversationsnetwork.org/shows/detail169.html http://web.archive.org/web/20130729210039id_/http://itc.conversationsnetwork.org/shows/detail662.html Tim Daly -- 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 --- You received this message because you are subscribed to the Google Groups "Clojure" group. To unsubscribe from this group and stop receiving emails from it, send an email to clojure+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.