On Friday, November 12, 2004, 1:28:41 PM, Sam wrote:
> Quoteing jbritt@xxxxxxxxxxxx, on Thu, Nov 11, 2004 at 07:23:37PM -0700:
>> Sam Roberts wrote:
>>
>> >Should doc patches be sent here?
>>
>> Depends, sort of. Documentation for the core classes and the standard
>> library come from the rdoc comments in the source code. There are some
>> here who have CVS commit access who could apply the change.
> Let me put it this way... I'm willing to hack the src doc comments, and
> I'm willing to push the cvs diffs towards one mailing list, but not
> to hunt down individual authors. The docs are important, and it doesn't
> take too much effort for me to add things to some of the almost
> undocumented libraries.
> The ruby-doc.org page gave the strong impression that there is a group
> working through the stdlibs adding docs.
> Is this not the case?
> Should I be subscribed to ruby-core, and posting doc diffs there?
I'm more than happy to see doc patches here. I agree that people
making to effort to correct things should not then face administrative
hurdles. Furthermore, I'm happy to do the administrative legwork.
(Although I'll be on holiday for a month around Christmas...)
James is correct to point out that different kinds of patches should
be treated differently. But this is a good place for discussing them.
Cheers,
Gavin
|
