[haiku-commits] Re: haiku: hrev47598 - build/jam/repositories/HaikuPorts

  • From: Stephan Aßmus <superstippi@xxxxxx>
  • To: haiku-commits@xxxxxxxxxxxxx
  • Date: Tue, 29 Jul 2014 23:04:35 +0200

Am 29.07.2014 22:36, schrieb Augustin Cavalier:

On 07/29/2014 04:06 PM, Stephan Aßmus wrote:

Please update the packages with proper information about them. I don't
want to google the package name when the description should have been
right there in the package.

This is actually a growing problem that quite a lot of packages don't
say what they are for. Some have one-liners, some have a paragraph, and
some have FIVE paragraphs (e.g. xz-utils was this way, before I cut it
down to its current state).

This once again raises the problem that we have no style guide for
packages...
I guess you are right. It seems so unfortunate that one can't rely on common sense. Like, uhm, 'description' is where you *describe* the package. No, we have to explicitely say "describe" means to "tell what it is good for". 

Best regards,
-Stephan

Other related posts:

  1. Home
  2. haiku-commits
  3. Archive
  4. 07-2014