[Fedora-packaging] Re: Long and "advertising" descriptions (was: Fedora 8 Update: enlightenment-0.16.999.043-3.fc8)

zing shishz at alum.rpi.edu
Sun Sep 14 16:42:18 UTC 2008


On Sun, 14 Sep 2008 09:35:06 -0400, Tom \"spot\" Callaway wrote:

> On Sun, 2008-09-14 at 10:36 +0200, Thorsten Leemhuis wrote:
>> Yes, I know, enlightenment is designed for small machines and quite
>> fast
>> on them. But those things I quoted and other sections in the
>> description
>> sound more like advertising than a proper description. Up to a specific
>> point that's okay IMHO, but here the packager IMHO shoot way over the
>> top.
> 
> Wow. That is indeed too much information. :) I'm not sure how we should
> "guideline" that, other than something like:
> 
> == Descriptions ==
> Your package description should contain useful data about the package,
> and answer the question "what is this and what does it do?". In general,
> the description should not exceed 10 lines or so. Try not to put too
> much here, this isn't an epic novel, it's just a package description.
> Also, there is no real need to "advertise" the package here, so
> statements like "this is the best perl module that has ever been created
> by humans", while possibly accurate, are not terribly useful in
> answering the question "what is this and what does it do?".

I think these types of "advertising" and/or packager's notes are better 
put into /usr/share/doc/package/README.RPM or similar.  Maybe just an 
additional sentence that packager's can stick extra additional info 
there.  Packagers already do this.

zing





More information about the Fedora-packaging mailing list