RFC: fix summary text for lots of packages

Michael Schwendt mschwendt at gmail.com
Fri Nov 21 18:09:35 UTC 2008


On Fri, 21 Nov 2008 16:56:32 +0100, Andrea Musuruane wrote:

> 2008/11/21 Richard Hughes:
> > What do you think of that?
> 
> First of all, I'd like to point out that many of the package you are
> talking about are in RPM Fusion and not in Fedora.
> 
> I think that a packager has every right to make the best summary that
> he can think of in less than 80 characters. Therefore statements like
> "to much detail" for "DeVeDe is a program to create video DVDs and CDs
> (VCD, sVCD or CVD)" are nonsense for me.

Nah, it's nonsense to even try listing the supported video formats
in the summary if you can list them in the longer and detailed
description. What about MVCD,XVCD,XSVCD,RSVCD,TVCD,TSVCD and others?
The short summary simply cannot answer a lot of questions the user
might have.

I'd go even further than Richard and cut

   Simple video DVD and CD authoring software

to 

   Simple video DVD and CD authoring

;) because it doesn't matter that it's "software" or "a program".
Way too many packages contain "programs". It's nothing special that
must be highlighted in a summary, which is supposed to be short and
to the point. On the contrary, a "framework" or "development kit"
is special enough to emphasize it, for example.

> I am not willing to make any other changes. Sorry. I think that
> packagers have much more *serious* activities to do in their _limited
> time_.

True. You'll find that the shorter the summary (which is approved during
review), the longer it will stay accurate (and short and to the point).
Not so with too much details, such as mentioning that an app is written
in C++ or Python.




More information about the fedora-devel-list mailing list