On Sunday, September 8, 2013 4:07:33 AM UTC-4, Steven Degutis wrote:

>
> https://github.com/sdegutis/clojuredocs/wiki 
>
> {snip}
>
> Thoughts? 
>
> Hi Steven,

This is a nice piece of work. Thank you.

Some thoughts:

  * Wikis are difficult to keep nice. And, seemingly contradictory to that, 
it's difficult to find contributors.

  * There is already a Clojure wiki, 
<http://en.wikibooks.org/wiki/Clojure_Programming>, but it does not see 
many updates.

  * I really like clojuredocs.org's clean (and enforced) separation of 
examples, see-also, and comments.

  * Although github's wiki feature is handy, for a pure wiki there are 
better solutions, IMO (for example, my favorite is 
[gitit](http://www.gitit.net/)).

  * I think some of the work necessary to replace/rewrite clojuredocs.org 
has already been done by dakrone. Dunno the status of it though.

  * I think it's worthwhile to pull docstrings directly from Clojure 
itself. Fixing docstring typos in a wiki is nice, but I'd rather see fixed 
the actual source docstrings themselves...

-- John

-- 
-- 
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
--- 
You received this message because you are subscribed to the Google Groups 
"Clojure" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to clojure+unsubscr...@googlegroups.com.
For more options, visit https://groups.google.com/groups/opt_out.

Reply via email to