[Buildd-tools-devel] Bug#425964: schroot-common has inadequate package description

[Craig Sanders]

Package: schroot-common
Version: 1.1.3-1

the following description is inadequate:

Description: common files for schroot
 This package provides files common to all schroot packages, such as
 translations.

it fails to provide the crucial required information, which is a brief
description of what schroot is/does.

it is also redundant. the package name alone tells the user that it is
probably common files for schroot (whatever "schroot" is).

btw, don't assume that someone reading the description for one package
has already read the desc for closesly related packages, or vice-versa,
or that they have encountered the software on the web previously. the
description for all related packages should assume that the reader has
no prior knowledge of what the package is, so should provide a brief
description/summary. that might mean cutting-and-pasting (some of) the
description from one package to another in the control file.

this bug probably applies to the other schroot packages.  dunno,
haven't checked.       

craig

-- 
craig sanders <cas at taz.net.au>