Rapports de bogue pour "templates mal écrits"

[Christian Perrier <bubulle@debian.org>]

Quoting Christian Perrier (bubulle@debian.org):
> > ps2 (pour JL) : je n'ai pas vu de "template non conforme"...
> 
> 
> je viens d'ailleurs d'envoyer mon rapport de bogue standard pour
> pointer le mainteneur sur le chapitre ad-hoc de la référence du développeur.


Pour ceux que ça intéresse et qui voudraient le faire quand ils
tombent sur des templates mal écrits.

Script bug-rewrite:

#!/bin/sh
if [ -n "$1" ]
then
    reportbug --body-file="/home/bubulle/src/debian/translation/po/rewrite.txt" --offline -s "$1: Debconf templates do not follow Developer's Reference recommendations" --severity=minor --no-config-files --tag=none ""--package-version="N/A" --list-cc="" $1
else
    echo Usage: $0 paquet
fi


Ficher rewrite.txt:

The debconf templates for this package do not follow the
recommendations given in the Developers Reference, section 6.5
("Configuration management with debconf").

Even though not mandatory, this part gives general advices about the
Right Way to write debconf templates to achieve a general consistency
in Debian about the way to prompt users. Please make your best
following these advices.

If you follow these suggestions, please consider later using the
podebconf-report-po utility from the "po-debconf" package, to notify
translators of the induced changes. Then leave them a few days to
update their translations (1 week is considered good practice so that
translation teams can apply their usual QA policies).

This bug report template is mostly generic so I can't point out
exactly which part of your debconf templates I have considered not
following these recommendations. I recommend your first read the
mentioned part of the DR, make the changes you feell needed, then come
back to me with the new templates file.

Most often encountered "errors":

-using interrogative form for string/select/multiselect templates. For
 instance: "Which web server should be reconfigured?" instead of "Web
 server to reconfigure:"

-making specific reference to some debconf interfaces widgets such as
 using "If you choose 'No'" in boolean templates

-using the first person ("I will do this....")

-too long extended description (should idealistically fit in one
 screen with the dialog interface in a 80x25 terminal)

-extended description repeating the short description

-extended description using an interrogative sentence in a boolean
 template. Only the short description should issue a question in such
 templates.

etc...