[Fedora-packaging] Long and "advertising" descriptions (was: Fedora 8 Update: enlightenment-0.16.999.043-3.fc8)
mclasen at redhat.com
Mon Sep 15 21:10:57 UTC 2008
On Sun, 2008-09-14 at 09:35 -0400, Tom "spot" Callaway wrote:
> 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 first and foremost, what is needed is to figure out what
audience the description is targeted for. Everything else will fall in
place once that is clear...
More information about the Fedora-packaging