On Tue, Sep 18, 2012 at 9:01 PM, Paul deGrandis <paul.degran...@gmail.com>wrote:
> > 1.) Clojure.org should have a better host of documentation, especially for > newcomers. > We saw from the Clojure Survey, as well as threads here on the mailing > list, that documentation is still something on which we as a community need > to work. > Could perhaps a different process govern documentation contributions, > something more akin to http://docs.scala-lang.org/contribute.html that > doesn't involve the CA? > How could we best integrate such a project into Clojure.org? Would anyone > be willing to help push such a project forward? > I am not personally willing to push such a project forward at this time. I have some suggestions if someone else is. The only things required for someone to create a new web site dedicated to better Clojure documentation is time, knowledge, and some money. If you, perhaps together with a group of like-minded colleagues, have those resources, my guess is that it would be easier to create a new site than to expect someone else to do an overhaul on clojure.org. You would own your own destiny. You would never need to wait on someone else to do something for you, unless it was someone at the company you chose to host your site, or one of your colleagues to do their part. It is quick and easy for clojure.org to add one or several links to such a site once it is up and going. The Clojure cheatsheet ( http://clojure.org/cheatsheet) currently links to ClojureDocs.org, but it would be easy to switch those links to point to another site if something else superseded it (I've edited the cheatsheet significantly 6 months ago, and the links are now auto-generated, and thus easy to retarget :-) Create a site that does everything ClojureDocs.org does and even more, with the ability to add examples specific to Clojure 1.4, and in the future Clojure 1.5+, but otherwise lets examples for older versions of Clojure be displayed until and unless they are tagged by someone as obsolete. It would be cool if it allowed submissions not only for the contrib modules, but was able to quickly "import" any Clojure library, i.e. write some code that automates most of the steps of adding a new Clojure library to the web site. Even better if people wrote tutorials on how to use a library as a whole and put it on the site, and not only for individual functions. For whoever thinks they might want to do such a thing, expect many thanks, many bug reports and suggestions for improvements, and sometimes complaints that you aren't doing what others think you ought to be doing. If that and what you will learn are enough to motivate you, go for it. Bonus points if you have a team of people working on it that can keep it going even as people move on to other projects in their lives. 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
