On Feb 20, 3:05 pm, Sean Corfield <seancorfi...@gmail.com> wrote: > On Mon, Feb 20, 2012 at 1:48 AM, Sergey Didenko > > <sergey.dide...@gmail.com> wrote:
> > It looks like our community already has a lot of articles, tutorials, > > gists, but they are just not very reachable to beginners. > > > > May be what we really need is a meta site or article on clojure.org or > > promotion of other meta site like > >http://stackoverflow.com/questions/tagged/clojure, with a lot of > > community rated links to existing resources? > > Folks could contribute tohttp://dev.clojure.org/display/doc/Home(I > believe you need a CA on file and someone has to update your > Confluence account permissions) but I believe this is the official hub > for community-contributed documentation... Looking at clojure.org, I'd just assumed that the central community- driven documentation is the wiki ( http://en.wikibooks.org/wiki/Clojure_Programming ), which appears to include http://en.wikibooks.org/wiki/Learning_Clojure (why is it a separate wikibook?). A issue that all communities face though, is that some authors prefer to write their own articles and blog posts, rather than update and fine-tune the central community doc. It's understandable, since everyone has their own style (and their own favorite markup format) and it's also nice to get recognition for your very own linked-to and possibly-popular article/blog-post vs. shared authorship of a wiki book. As an aside, my hunch is that it may be easier to get folks to contribute to the wikibooks rather than contribute to http://dev.clojure.org/display/doc/Home --- partly because the wiki seems more familiar and easier to navigate compared to the Confluence site. Also, if the Confluence site requires a signed contributor agreement on-file, I'd bet that inhibits folks who just wanted to clarify a sentence, fix some grammar, add a small example, etc. Regarding a Clojure cookbook, I don't see any reason why it should be separate from the main community-driven wiki. So, my guess is that a good solution would be: 1. have one central wiki that the community is encouraged to monitor and contribute to (the 2 wikibooks?), 2. expand the wiki's cookbook section (possibly split it out into multiple sub-pages), and 3. have a page on that wiki that keeps a community-curated, categorized, and (important!) dated list of useful external articles (perhaps even roughly sorted by date --- newest at the top). I've gone ahead and created an [External Articles](http:// en.wikibooks.org/wiki/Clojure_Programming/External_Articles) page on the main wiki. If you've got any favorite articles and/or blog posts that you think would be useful to others, please add them (creating category sections for them as needed). ---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
