Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-20 Thread Tom Faulhaber
Hey Sean, Thanks for the pointer here. There's a lot of commonality, but mostly I think the products end up being different for two reasons: 1) For the moment, the contrib-autodoc stuff is targeting the googlecode wiki, which is a weird and gross thing of its own. I've been thinking of making so

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-15 Thread Sean Devlin
Check out the thread below in the Compojure group. Specifically, look for the comment by Brain Carper http://groups.google.com/group/compojure/browse_thread/thread/67d92ceb4128a375?hl=en Brian's code: http://briancarper.net/clojure/compojure-doc.clj This might be an alternate approach to the

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Tom Faulhaber
Jason, Thanks for the offer. I may take you up on it as I get this into "production" such as it is. Sean, Nothing that I found in contrib (but who knows, there's no documentation :-)). Rich posted some code (which I'm using in a modified version in the center of things) for doing the API paage

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Tom Faulhaber
Konrad, I too would rather have everything in a single :doc tag and it most cases it will be (just as it is with the clojure.org API page). But I wanted to leave open the option for people to create custom marked-up version for the wiki if they wanted something fancier. Any solution that involves

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Laurent PETIT
2009/4/14 Laurent PETIT > Great initiative ! > > Some thoughts I had when reading your proposal: > > 2009/4/14 Tom Faulhaber > > >> [This is specifically for contrib authors, but also for anyone whose >> interested.] >> >> There was some discussion (or maybe the wailing and gnashing of teeth) >>

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Laurent PETIT
Great initiative ! Some thoughts I had when reading your proposal: 2009/4/14 Tom Faulhaber > > [This is specifically for contrib authors, but also for anyone whose > interested.] > > There was some discussion (or maybe the wailing and gnashing of teeth) > about the fact that there's lots of coo

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Sean
This feature would be very useful, as I know I spend too much time in re-implementing stuff that exists in contrib. However, contrib isn't the only library that needs to be documented. Besides the doc-string metadata, is there any type of Clojure-doc, similar to Java-doc? Is there utility to gen

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Jason Sankey
Hi Tom, Tom Faulhaber wrote: > The next stage of my plan is to build a robot that watches the > subversion repository and updates the doc on every checkin. Therefore > the doc will typically correspond to the tip of the tree. I'd be happy to add generation/upload of documentation as a build st

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Konrad Hinsen
On Apr 14, 2009, at 5:14, Tom Faulhaber wrote: > My idea is to use the namespace and var metadata to auto-generate a > set of documentation that has: > - an overview page that lists the namespaces in contrib and presents a > summary of each derived from the namespace metadata. > - each entry on t

Re: ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-14 Thread Rich Hickey
On Apr 13, 11:14 pm, Tom Faulhaber wrote: > [This is specifically for contrib authors, but also for anyone whose > interested.] > > There was some discussion (or maybe the wailing and gnashing of teeth) > about the fact that there's lots of cool functionally coming into > clojure.contrib but no

ATTN contrib authors: Automatic documentation for clojure.contib

2009-04-13 Thread Tom Faulhaber
[This is specifically for contrib authors, but also for anyone whose interested.] There was some discussion (or maybe the wailing and gnashing of teeth) about the fact that there's lots of cool functionally coming into clojure.contrib but no easily accessible documentation. I had been thinking ab