From: Massimiliano Mirra <list@...>
Date: 2001-12-30T02:11:21+09:00
Subject: [ruby-talk:29635] Re: [ANN] RubyGems 0.4

On Sat, Dec 29, 2001 at 04:56:28PM +0900, Conrad Schneiker wrote:
> Please consider including a couple of sentences in _every_ announcement
> describing what it is you have produced--i.e. what it does and why/which
> people should most likely be interested in it. Please do yourself (and
> others :-) a favor by not assuming people (including many newbies)know (or
> remember) what a given package (or whatever) does.

I second that and would also like to add:

Please also do not assume people are coming from a certain language,
or from any language at all.  Sometimes I see on RAA descriptions like
``Equivalent of the XXX::XXX module for Perl'' or ``Does the same
thing of Java's YYY'' followed by nothing.

Little honorable as it is, I often leave it where it is instead of
searching around for what XXX::XXX or YYY actually do, just because I
don't know Perl or Java.  I wouldn't be surprised if others did the
same.

Massimiliano