> > 5. The functionality of the docs hasn't kept up with Clojure. We > often resorted to text searches of the various sources. Need links > and see-also's. Clojure has grown/matured so much that it needs a doc > system of some sort. >
This has been recognized for awhile now. I have promised to extend the documentation system we use for clojure.contrib (see http://richhickey.github.com/clojure-contrib/) to clojure itself. This will mean that we have up-to-the-minute doc on the latest Clojure (as well as info for historical versions and, eventually, all the branches) with links to the source code, the ability to attach more detailed docs, link to URLs, full index, etc. This has been taking awhile because my real life (both work and personal) has been ridiculously crazy the last few months. But I have begun to lean in on it and think I should have a preliminary version running with the next couple of weeks. The goal is that this system will be generalizable for all projects and can be used as a sort of "javadoc" for Clojure libraries (with extra bonuses like direct github support). Tom --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---