Complete with the monk robes, pizza and 1 liter of dark beer per hour? Sounds like something that'll be really good for everyone. On Tue, Apr 8, 2008 at 4:10 PM, Jeremy McAnally <jeremymcanally / gmail.com> wrote: > We're probably going to do something like that for Rails at RailsConf > at the community code drive, but there's no saying that we couldn't > work on Ruby too (or even more so, work on them at Cabooseconf). > > --Jeremy > > > > On Tue, Apr 8, 2008 at 4:00 PM, Kyle Schmitt <kyleaschmitt / gmail.com> wrote: > > Php's docs are good, really good. But I always felt that it's because > > it's a domain specific language. > > > > It lives, breaths and is a web language. Sure, you can use it as > > general purpose, but it was designed for the web. > > With that mindset they made possibly the best web-friendly docs I've ever seen. > > > > Ruby on the other hand was developed because some hacker got an itch, > > and wanted something kindof like lisp, only better. > > It's definitely documented like a hacker language. Good docs are > > eventually written, but very rarely updated, because hackers generally > > have something better to do than document: hack their language and > > make it better. > > > > There needs to be something like a ruby-illumination (see > > http://en.wikipedia.org/wiki/Illumination_(manuscript) ) going on. > > Maybe at the big ruby conferences a bunch of ruby hackers can be paid > > in pizza to spend 8 or so hours on a mass documenting session. Make > > the docs beautiful in every way: correct, complete, elegantly written, > > indexed, and, of course, aesthetically. > > For fun have them all in monks robes, and bring them dark German > > beer.....but no more than 1L per hour. > > > > Just my thought. > > --Kyle > > > > > > > > > > -- > http://jeremymcanally.com/ > http://entp.com > > Read my books: > Ruby in Practice (http://manning.com/mcanally/) > My free Ruby e-book (http://humblelittlerubybook.com/) > > Or, my blogs: > http://mrneighborly.com > http://rubyinpractice.com > >