On Wednesday, May 6, 2015 at 2:15:53 PM UTC-5, Andy Fingerhut wrote: > > First some facts, without any evaluation: > > There are only a handful of people in the world with authorization to edit > pages on clojure.org. I would guess maybe only 5. >
14 > Far more have authorization to edit the wiki pages on dev.clojure.org -- > hundreds, I think. A subset of those who have signed a Clojure CA and > requested permission for editing those pages. > 320 > Writing good documentation and giving it away is time consuming, > painstaking, often thankless. There are probably some rare individuals who > can write lots of good documentation in less than an hour per 'page full of > text', but I am not one of them, and I wouldn't be surprised if the typical > number is more like 5 to 10 person-hours per 'page full of text' for good > documentation. It isn't just writing it the first time, but re-reading and > editing it 2 or 3 times, responding to requests to fix errors and > suggestions for improvement, and updating as new software versions obsolete > old documentation. > > I do not know how many hours that Alex Miller has spent during the last 2 > years editing the content on clojure.org that exist today. > I have a list where I batch them up and then periodically I'll take an afternoon to make updates. Or add new pages like for transducers (that took about 2 days). Plenty of things still to fix. Depending what the changes are, I have Rich review them too (and then I have to rewrite them :). > There is no public change log I am aware of for its content like there is > for the wiki pages. I suspect it is up in the many tens, at least. This > editing has been in the form of adding new text, and clarifying and > reorganizing existing text, primarily, not in redesigning the look and feel > of the site. > I don't think it's linked anywhere, but: http://clojure.org/wiki/changes -- 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.
