On Wed, May 6, 2015 at 1:27 PM, Fluid Dynamics <a2093...@trbvm.com> wrote:
> On Wednesday, May 6, 2015 at 3:15:53 PM UTC-4, Andy Fingerhut wrote: >> >> >> The "rough edges" show up on a lot of things in the Clojure ecosystem. I >> know I suck at documentation which is why I moved clojure.java.jdbc’s >> documentation out to >> http://clojure-doc.org/articles/ecosystem/java_jdbc/home.html which can >> be maintained by the community through Pull Requests etc. *In two years, >> there have been just two small changes from the community: the rest of the >> updates are from me, despite several people complaining about the >> documentation being unclear or insufficient.* >> > > Perhaps the barrier to participation is simply too high to get many > contributors. Consider Wikipedia's: go to website, click edit, fix/add > something. No pull requests, no written and snail-mailed(!) CAs, no > creating yet *another* login/pass pair to remember, no other hoops to jump > through. > > Argue all you want about why <insert hoop here> is *absolutely essential* > to keep the vandals/copyright infringers/terrorists/spammers/whoever out; > it won't change the empirical fact that you only get mass participation > when the entry barrier is *very* low (even a free registration is a > substantial deterrent that will cut participation by an order of magnitude > or more). Or the empirical fact that Wikipedia actually works pretty darn > well... > Fluid: Maybe you are not aware of the history, but clojure-doc.org exists specifically because someone who spoke out loudly and repeatedly against CAs took the time to create it, and it _only_ requires a Github account and creating a pull request. If you think a Github account and creating a pull request is too high a barrier, there is clojuredocs.org, too, but that tends to be separate documentation for each funcation/macro, not more broad-ranging articles. Andy -- 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/d/optout.
