From: Dave Bass <davebass@...>
Date: 2008-08-06T19:57:05+09:00
Subject: Re: perl and the culture of libraries

Peter Hickman wrote:
> A critical thing for me is that when programming Perl the POD usually
> contains sufficient information and *EXAMPLES OF USAGE* to throw the
> basics of an application by simply cutting and pasting from the POD.

Hear, hear. Coming from a Perl background myself, I put a synopsis-like 
comment block at the top of every Ruby class or module I write.

I've been surprised at how poor the Ruby language documentation in 
general is. Or maybe I haven't found it yet. ;-)

As someone who has no problem writing technical stuff in English, I 
wouldn't mind contributing to some sort of open documentation project. 
Does such a thing exist for Ruby?

Dave
-- 
Posted via http://www.ruby-forum.com/.