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
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
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
so replicating that campaing is probably not an option.
visible? Do you know who can help with getting a link from
clojure.org?
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.
--
MK
http://github.com/michaelklishinhttp://twitter.com/michaelklishin