+1 for clojure-doc.org. As a beginner, i greatly appreciate your efforts and think this solves the 'lack of beginner friendly documentation' problem very well. Keep up the good work. :)
On Monday, October 29, 2012 3:57:36 AM UTC+6, Michael Klishin wrote: > > ## TL;DR > > The Clojure documentation project (http://clojure-doc.org) continues to > make progress. > Lion's share of the work this week went into the Concurrency and > Parallelism guide: > > http://clojure-doc.org/articles/language/concurrency_and_parallelism.html > > which is now about 75% complete. > > > ## CDS Progress Report > > The Clojure Documentation Site (a.k.a. CDS) publishes > periodic reports (every week so far, possibly two weeks in the future) > to give the Clojure community a better idea of what CDS shapes up to > be and what it has to offer. > > This is a report for the week ending October 28st, 2012. > > > ## New Content > > This week was all improvements to existing guides, no new content merged. > There is at least one new tutorial > in the works by a contributor we've heard from, though. > > > ## Updates > > By far most of the work merged this week went into the Concurrency and > Parallelism guide [1] > > It now covers topics such as > > * An overview of concurrency terminology and common hazards > * Identity/Value separation in Clojure > * atoms > * agents > * refs, STM in Clojure, STM limitations > * vars > * delays > * futures > * promises > * dereferencing > * some commonly used `java.util.concurrent` bits > * other approaches to concurrency on the JVM available to Clojure through > libraries > > Reading that guide is highly recommended for developers of all expertise > levels with the language. > > > Tutorials updated this week: > > * Getting Started With Emacs for Clojure [2] > > Other guides updated this week: > > * Functions [3] > * clojure.core Overview [4] > * Interoperability with Java [5] > * Community [6] > > > > ## Thank You, Contributors > > CDS would not be possible without the following people who make Clojure > community a better place: > > * AtKaaZ > * Ben Poweski > * John Gabriele > * Lee Hinman > * Michael S. Klishin > * Wes Freeman > > > ## You Can Help! > > ### How It Works > > We have a repository on GitHub [7] that has Markdown files, toolchain > setup instructions and several articles > as well as stubs for several more articles. The stubs help contributors > pick a topic to write about and not worry too much about > article structure initially. Just pick something that you are very > familiar with or interested in and write. > > When you are done, submit a pull request on GitHub and someone from the > existing contributors team will > suggest improvements or merge your work. Pretty straightforward. > > In order to make it easier for potential contributors to join the project, > we will post a brief list of > guides that do not require deep expertise and can benefit from > contributions by complete beginners. > > ### Existing Guides > > Tutorials that badly need to be written: > > * Tutorial on VimClojure [8] > > Guides that have structure and good chunk of the content in place but > still have holes you > can help us plug: > > * Java interop [5] > * Collections and Sequences [9] > * Namespaces [10] > * clojure.core Overview [11] > > These guides are new and cover advanced topics, so we need as much > proof-reading as we can > get from the community: > > * Concurrency and Parallelism in Clojure [1] > > ### New Content > > If you want to start working on one of those articles or have existing > content you've authored that can be ported, > please let us know on the Clojure mailing list. > > > ## Summary > > CDS is 2-3 guides from covering the language "reasonably well". There > still are holes in various guides > but mostly in the more advanced areas and > > Want to help us make things better? Join us by forking and contributing to > http://github.com/clojuredocs/cds. > > > > 1. > http://clojure-doc.org/articles/language/concurrency_and_parallelism.html > 2. http://clojure-doc.org/articles/tutorials/emacs.html > 3. http://clojure-doc.org/articles/language/functions.html > 4. http://clojure-doc.org/articles/language/core_overview.html > 5. http://clojure-doc.org/articles/language/interop.html > 6. http://clojure-doc.org/articles/ecosystem/community.html > 7. http://github.com/clojuredocs/cds > 8. http://clojure-doc.org/articles/tutorials/vim.html > 9. http://clojure-doc.org/articles/language/sequences.html > 10. http://clojure-doc.org/articles/language/namespaces.html > 11. http://clojure-doc.org/articles/language/core_overview.html > > > -- > MK > > http://github.com/michaelklishin > http://twitter.com/michaelklishin > > -- 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
