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 wit
Good thought, Steve. Option 1 is now done.
On May 23, 5:06 pm, "Stephen C. Gilardi" 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:
>
>
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 r
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
Yeah, no doubt.
However the goal of this project was not to develop a new, more
sophisticated mechanism for documentation, but rather to expose what
was already available.
The discussion you bring up is more of a language discussion (in the
sense of supporting a more 'literate' style over the mo
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 ge
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 wrote:
> By the way, source of the robot is available on GitHub, for tho
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 wrote:
> Hello everybody,
>
> As many of you know, I
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
docu
Absolutely brilliant. Exactly what clojure-contrib and the clojure community
needed. Thank you!
On Mon, May 4, 2009 at 2:41 AM, Tom Faulhaber wrote:
>
> 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 run
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 worki
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
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 wrote:
>
> Hello everybody,
>
> As many of you know, I have been working
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"
>
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
15 matches
Mail list logo
