I added a link to http://clojure-doc.org in both the group discussion and the about page for the Den of Clojure (http://www.meetup.com/denofclojure/). Sean (or anyone else for that matter) is there an easy way we can let the rest of the user group to lend a hand? Is there a better place to post the link on the meetup site?
Daniel On Wednesday, February 27, 2013 12:55:09 PM UTC-7, Alex Miller wrote: > > I've updated http://clojure.org/documentation to add a link to > http://clojure-doc.org. I think it's a great resource for all Clojure > developers!! > > I think it would be useful in your regular updates to highlight areas that > could use help. Another area that I think would be useful in addition to > the current docs are smallish examples of full projects that highlight how > to put the existing pieces together into a (small) real project. > > Alex > > > On Wed, Feb 27, 2013 at 12:06 PM, Michael Klishin > <michael....@gmail.com<javascript:> > > wrote: > >> Started in October 2012, http://clojure-doc.org is a pretty extensive >> community documentation effort. It covers Clojure, its ecosystem >> and tools and has two key goals: >> >> * We produce beginner-friendly content >> * It is dead easy to join and help >> >> Even though recently that hasn't been >> as much activity as in the past, it is not abandoned and continues >> to accumulate useful, beginner-friendly material. >> >> We constantly get praises from newcomers to Clojure who discover >> clojure-doc.org. Unfortunately, it does not appear even in top 10 >> in Google for "clojure docs" or "clojure documentation" and >> many community members are not aware of it. >> >> In part it is less visible because we no longer actively post >> progress reports. Things have settled down and most of changes >> now are small edits and improvements all over the place. It is >> a bit pointless to post progress reports more often than >> once a month or so. >> >> So I'd like to start a discussion about what can be done about it. >> The community (we have 40 contributors) has worked very hard >> on clojure-doc.org and I'd like to see high profile resources >> (namly clojure.org and leiningen.org) link to it. What would >> it take to convince clojure.org maintainers to do so? >> >> There are still guides left ot be written (macros, gen-class), >> but overall, I'd say there is no better source of freely available, >> beginner-friendly, hackable (no Clojure CA, everything is developed >> on GitHub [1], content is in Markdown) documentation. All it needs >> is some linking and promotion love. >> >> One way to help would be to start a campaign such as Mozilla's >> Promote JS [docs]. Unfortunately, unlike Mozilla key contributors >> behind clojure-doc.org largely lack graphic and Web design skills, >> so replicating that campaing is probably not an option. >> >> Do you have any ideas about how we can make clojure-doc.org more >> visible? Do you know who can help with getting a link from clojure.org? >> Do you think clojure-doc.org is not good enough to be the "blessed" >> open source documentation resource? Please post your suggestions >> and concerns. >> >> Improving CDS visibility will benefit the entire community plus all the >> people who will join it in the future. Most of the work is already done, >> it just needs to be promoted better. >> >> Thanks you. >> >> >> 1. https://github.com/clojuredocs/cds >> >> -- >> MK >> >> http://github.com/michaelklishin >> http://twitter.com/michaelklishin >> >> -- >> You received this message because you are subscribed to the Google Groups >> "clojure-power" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to clojure-powe...@googlegroups.com <javascript:>. >> To post to this group, send email to clojur...@googlegroups.com<javascript:> >> . >> Visit this group at http://groups.google.com/group/clojure-power?hl=en. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> >> > > -- -- 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.
