On Aug 1, 2014, at 5:40 PM, Reid McKenzie <rmckenzi...@gmail.com> wrote: > It's something I've thought about and will probably continue to decline > as a feature. cross-clj already does the easy half of that job: > providing HTML documentation and does it at least as well as Grimoire > does.
Ah, I hadn't looked at cross-clj before - that is super nice! > Sure Grimoire could be extended to provide the same content, but I > see the value of Grimoire in its examples and extended documentation of > Core rather than in being a HTML render of the existing documentation. Indeed. I only asked because clojuredocs.org did have a lot of the old contrib in there (with some examples etc) and wondered whether Grimoire might be a complete replacement... But I think you're right that there's just too much to cover with the way contrib is growing and evolving these days - and we have clojure-doc.org for more extensive, community-maintained documentation that provides guides to using contrib libraries etc. In addition, contrib libraries probably don't lend themselves to isolated examples the way the core Clojure namespaces do. Sean Corfield -- (904) 302-SEAN An Architect's View -- http://corfield.org/ "Perfection is the enemy of the good." -- Gustave Flaubert, French realist novelist (1821-1880)
signature.asc
Description: Message signed with OpenPGP using GPGMail