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
>
>