Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-24 Thread Max Suica
Hey, is there such a wiki/doc for core clojure? The wiki for clojure- contrib's project page is so nice, but clojure's wiki has very little. Heh, I've been using clj-doc to make my own reference for it, but the wiki is a lot prettier. It would be nice to generate one for core. I've looked at the

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-24 Thread Tom Faulhaber
Good thought, Steve. Option 1 is now done. On May 23, 5:06 pm, Stephen C. Gilardi squee...@mac.com wrote: Hi Tom, I like the docs a lot. Thanks for making the robot! I have a suggestion for a refinement. We've received an issue for clojure-contrib noting that the doc for   zip-filter at:

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-24 Thread Tom Faulhaber
Max, Sorry that the code for the robot is such a stew. The way it should work is to build all the doc data and then format that data for the wiki, but that's not how it happened. I'll probably do that when Rich moves contrib to a different wiki :-). A lot of the code in there is just to deal

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-23 Thread Stephen C. Gilardi
Hi Tom, I like the docs a lot. Thanks for making the robot! I have a suggestion for a refinement. We've received an issue for clojure-contrib noting that the doc for zip-filter at: http://code.google.com/p/clojure-contrib/wiki/ZipFilterApiDoc contains: Usage: (ns

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-05 Thread Antony Blakey
On 05/05/2009, at 1:53 AM, Tom Faulhaber wrote: Antony: There is a way for authors to add links either to other pages in the wiki or externally. See DataLog and Monad for examples of how this works. One of the issues here is that doc strings are repurposed in a lot of ways and authors

ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Tom Faulhaber
Hello everybody, As many of you know, I have been working on a contrib autodoc robot for the last little while. It is now up and running and you can use the results here: http://code.google.com/p/clojure-contrib/wiki/OverviewOfContrib It includes: * An overview of each namespace in contrib

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Christopher Taylor
Tom, thanks, that's great! I think it would be really useful if the overview appeared as a link on the contrib landing page. all the best, --Chris On 04.05.2009, at 08:41, Tom Faulhaber wrote: Hello everybody, As many of you know, I have been working on a contrib autodoc robot for

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Mark Volkmann
This is great! I hope the contrib authors will take the time to improve their documentation where needed and add some examples for functions and macros whose use isn't obvious. On Mon, May 4, 2009 at 1:41 AM, Tom Faulhaber tomfaulha...@gmail.com wrote: Hello everybody, As many of you know, I

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread e
is it encouraged for people to post questions to that wiki? and do they end up near what the question is referring to? For example, I was just looking at the docs there for cond/cond-let and thought a discussion could help make the docs more immediately penetrable. On Mon, May 4, 2009 at 2:41

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Antony Blakey
This is really good. Have you considered a mechanism for including richer documentation per contribution/namespace, ala javadocs package document e.g. html files with images etc ? On 04/05/2009, at 4:11 PM, Tom Faulhaber wrote: Hello everybody, As many of you know, I have been working

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Andrew Wagner
Absolutely brilliant. Exactly what clojure-contrib and the clojure community needed. Thank you! On Mon, May 4, 2009 at 2:41 AM, Tom Faulhaber tomfaulha...@gmail.comwrote: Hello everybody, As many of you know, I have been working on a contrib autodoc robot for the last little while. It is

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Tom Faulhaber
Glad to hear everyone likes it. Here's my responses to the various comments here: Chris: Rich added a link on the landing page while I was writing this note. Thanks, Rich! Mark: I hoping that the visibility of this page will spur the contributors (myself included!) to ever higher levels of

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread Tom Faulhaber
By the way, source of the robot is available on GitHub, for those who appreciate fine masochism: http://github.com/tomfaulhaber/contrib-autodoc/ Really, nothing to see there, but we like to be open. Enjoy! On May 3, 11:41 pm, Tom Faulhaber tomfaulha...@gmail.com wrote: Hello everybody, As

Re: ANN: Full, continuously updated documentation for clojure.contrib

2009-05-04 Thread kkw
Tom, This is a really helpful service. Thank you very much! It's already helped me find stuff in the clojure.contrib.sql package that I didn't have the smarts to originally search. Kev On May 4, 4:30 pm, Tom Faulhaber tomfaulha...@gmail.com wrote: By the way, source of the robot is