On Wednesday, September 19, 2012 11:43:45 AM UTC-4, Michael Klishin wrote: > > 2012/9/19 Paul deGrandis <paul.de...@gmail.com <javascript:>> > > My concern with growing the documentation on the dev.clojure is that it >> takes a CA to contribute. I think we'd be better served as a community to >> open up documentation contributions to everyone. >> One possible solution is moving clojure.org or a subset (docs.clojure.org) >> to a github repo, as integrated Markdown pages. Thoughts? Concerns? >> > > Using CA for documentation sounds unnecessary. Using GitHub, pull requests > and writing in Markdown is a much more open > process friendly to developers. docs.scala-lang.org is developed that > way: https://github.com/scala/scala.github.com. >
I think a github project with markdown-formatted files is a good way to go. It strikes a pretty nice balance between a wiki (which tend toward being a free-for-all) and a more rigid centralized setup. Pull-requests are good, and there could be a general policy where the main or original author of the document in question has the major say-so about whether changed are merged or declined. Maybe have it look something like this: https://github.com/uvtc/clojure-docs-collection (though it should probably live under an organization, rather than one doc-focused user :) ). Contributors could propose adding new docs via github issues. ---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
