RFC: fix summary text for lots of packages

Christoph Wickert christoph.wickert at googlemail.com
Sun Nov 23 15:01:05 UTC 2008


Am Freitag, den 21.11.2008, 15:52 +0000 schrieb Naheem Zaffar:
> Considering that the package name is not given much prominence in the
> UI, is it really a bad thing to repeat it in the summary?
>  
>         * XQilla is an XQuery and XPath 2.0 library, built on top of
>         Xerces-C
>         (repeating the program name)
>         * DeVeDe is a program to create video DVDs and CDs (VCD, sVCD
>         or CVD)
>         (to much detail)

These are good examples of how _not_ to do it. We have not reached
consensus on not repeating the program name or on how detailed
descriptions should be, but I think we all agree that "foo is a ..." is
completely useless and should thus should be avoided. 

Christoph




More information about the devel mailing list