From: Dave Thomas <dave@...>
Date: 2004-03-05T01:29:06+09:00
Subject: Re: Comment football being played... with lib/test/unit.rb


On Mar 4, 2004, at 10:06, Nathaniel Talbott wrote:

> Dave and Gavin, you should probably have a conversation about where 
> the comment should be, and why, since you keep going in and undoing 
> each others change. I'm guessing the issue is that for ri it's better 
> to have a class-level comment, and for generated html it's better to 
> have a file-level comment, and I'm curious to hear what the final 
> consensus is.

Oops - I missed the original change here.

I vote for it the way it is now, with the possible addition of a 
file-level comment with a pointer to the class-level comment. That way 
both HTML and the ri will produce reasonable results. The idea is to 
make

    ri Test::Unit

produce meaningful results (and right now it produces really nice 
looking results: nice job Nathaniel/Gavin)

ri doesn't look at file level comments (because it didn't seem 
particularly meaningful), so as unit.rb was previously, all that 
wonderful comment was being lost.


Cheers

Dave