Colin, > http://people.debian.org/~walters/descriptions.html Well, I'm not sure there should be a template -- people will use it (and thus try to squeeze information into it). I usually tell my sponsees that a description should answer the following questions, roughly in that order: - What does it do (in nontechnical terms)? - Do I need it? (look at the last sentence in the Linux Configure.help descriptions -- they're really helpful if you don't want to understand stuff because you don't need it but need to pick a choice now) - What are outstanding features and deficiencies compared to other packages (if you need X, use Y instead)? - Is this package related to other packages in some way that is not handled by the package manager (this is the client to the foo server)? I try to keep all descriptions novice friendly -- after all, it allows them to learn stuff by installing and trying out. Simon -- GPG Fingerprint: 040E B5F7 84F1 4FBC CEAD ADC6 18A0 CC8D 5706 A4B4
Attachment:
pgppxTe836Rwo.pgp
Description: PGP signature