Le format des messages
Le nombre de messages sur la liste étant assez important et les sous-projets variés, nous donnons des titres spéciaux à nos messages pour pouvoir sélectionner facilement ceux qui nous intéressent. Les principes généraux sont expliqués ici, veuillez vous reporter à chaque sous-projet pour les nuances pouvant apparaître.
Format classique du sujet des messages
Avec le temps, nous sommes arrivés à un formalisme que tout le monde semble trouver suffisant et utile. Ces titres sont analysés par un robot, les résultats sont disponibles pour la traduction française sur la page de coordination. Essayez donc de ne pas vous tromper lorsque vous utilisez ce format. Si cela arrivait, ce n'est évidemment pas la fin du monde. Il suffit d'envoyer immédiatement un [done] contenant l'erreur, suivi du message corrigé.
Le titre d'un message doit contenir quatre informations :
L'état du document
Certains de ces états ne sont applicables que pour une partie des sous-projets (par exemple, la marque [bts] ne concerne pas le site web). Lisez bien les instructions spécifiques à chacun de ces sous-projets pour comprendre les différences.
- [taf] : Travail À Faire
- Un des coordinateurs de la liste signale qu'un document doit être traduit. Si vous découvrez qu'un document doit être traduit et que vous n'avez pas vu de tel message, parlez-en au coordinateur, n'envoyez pas de [taf]. Vous risqueriez de troubler la coordination.
- [maj] : Mise À Jour
- Un des coordinateurs de la liste signale qu'un document doit être mis à jour. Si vous découvrez qu'un document doit être mis à jour et que vous n'avez pas vu de tel message, parlez-en au coordinateur, n'envoyez pas de [maj]. Vous risqueriez de troubler la coordination.
- [itt] : Intent To Translate
- C'est un document que vous prévoyez de traduire, et vous voulez vous assurer que vous ne marchez sur les plates-bandes de personne. Comme personne n'est parfait, il est possible que quelqu'un ait déjà traduit ce que vous comptiez traduire sans rien dire, ou que vous n'ayiez pas vu passer son annonce. Si quelqu'un d'autre envoie un tel message sur quelque chose que vous avez déjà traduit, signalez-le immédiatement.
- [rfr] : Request For Review
- Vous avez fini la traduction, et cherchez des relecteurs.
- [lcfc] : Last Call For Comments
- Vous avez intégré les relectures qu'on vous a fournies, et vous vous préparez à publier cette version finale.
- [bts] : Bug Tracking System
- Vous avez envoyé votre traduction dans le BTS.
- [done] : Done
- Vous signalez que le document que vous avez traduit est publié et que l'ensemble du travail est fini.
- [hold] : Hold
- La traduction du fichier concerné est incomplète, mais il n'est pas nécessaire de la mettre à jour. Cela peut arriver si le responsable du paquet a fait une erreur, le paquet est traduit ailleurs, etc. Il ne faut donc rien faire.
Ces marques peuvent être indifféremment en minuscules ou en majuscules.
Ces différents états sont chronologiques et certains clients de messagerie gèrent parfaitement les fils de discussion. Il faut donc toujours essayer de répondre à l'ancien message en y changeant le sujet. Pour plus de précision, voici un exemple de ce qu'il ne faut pas faire et de ce qu'il faut faire.
Ce qu'il ne faut pas faire : Envoyer un nouveau message à chaque nouvel état. Les (bons) clients de messagerie afficheront alors :
- ...
- [taf] wml://www.debian.org/index.wml
- ...
- [itt] wml://www.debian.org/index.wml
- ...
- [rfr] wml://www.debian.org/index.wml
- Re: [rfr] wml://www.debian.org/index.wml
- Re: [rfr] wml://www.debian.org/index.wml
- ...
- [lcfc] wml://www.debian.org/index.wml
- Re: [lcfc] wml://www.debian.org/index.wml
- ...
- [done] wml://www.debian.org/index.wml
- ...
Chaque nouvel envoi pourra être entrecoupé par d'autres messages au sujet complètement différent, ce qui complique la gestion du même fichier.
Ce qu'il faut faire : Toujours répondre à un ancien message, en changeant le sujet si nécessaire (ceci n'est valable que pour la gestion d'un même fichier, pour un nouveau fichier, il conviendra d'envoyer un nouveau message).
- ...
- [taf] wml://www.debian.org/index.wml
- [itt] wml://www.debian.org/index.wml
- [rfr] wml://www.debian.org/index.wml
- Re: [rfr] wml://www.debian.org/index.wml
- [lcfc] wml://www.debian.org/index.wml
- Re: [lcfc] wml://www.debian.org/index.wml
- [done] wml://www.debian.org/index.wml
- Re: [lcfc] wml://www.debian.org/index.wml
- [lcfc] wml://www.debian.org/index.wml
- Re: [rfr] wml://www.debian.org/index.wml
- Re: [rfr] wml://www.debian.org/index.wml
- [rfr] wml://www.debian.org/index.wml
- [itt] wml://www.debian.org/index.wml
- ...
Le sous-projet concerné
Des pseudo-URL sont utilisés pour cela :- ddp:// désigne la documentation Debian ;
- di-manuel:// désigne le manuel d'installation ;
- man:// désigne les pages de manuel ;
- po:// désigne les fichiers po traditionnels ;
- po4a:// désigne la documentation convertie au format po avec po4a ;
- po-debconf:// désigne les questionnaires Debconf ;
- wml:// désigne le site web.
Le paquet concerné
Dans le cas de la documentation, il s'agit de manuals.sgml et dans le cas du site web, de www.debian.org. Pour les autres sous-projets, il s'agit du paquet auquel le fichier traduit est rattaché.
Le document
La pseudo-URL est complétée par le chemin complet (répertoire et nom du fichier) où trouver le document original.
Exemples
- Pour traduire la page web http://www.debian.org/devel/index, envoyez un message dont le sujet sera : [itt] wml://www.debian.org/devel/index.wml ;
- Pour demander une relecture du fichier po du paquet dpkg, envoyez un message dont le sujet sera : [rfr] po://dpkg/po/fr.po ;
- Pour signaler que la traduction du fichier po du questionnaire Debconf du paquet apt-build se trouve dans le système de suivi des bogues et que le numéro du bogue est le 290244, envoyez un message dont le sujet sera : [bts] po-debconf://apt-build/fr.po #290244.
Autres
Quelques autres marques sont également utilisées à certains moments. Elles ne sont pas lues par les robots, donc le format est nettement moins strict. Cependant, en les utilisant, vous permettez à tout le monde de savoir précisément de quoi parle votre message. En voici quelques-unes :- [dico] un_mot
- Le mot un_mot pose problème. Vous demandez des avis éclairés aux personnes de la liste.
- [vac] JJ/MM/AAAA - JJ/MM/AAAA
- Vous serez indisponible entre les deux dates indiquées dans le sujet. Il est très important de le signaler lorsque vous êtes responsables de documents importants, pour que quelqu'un d'autre puisse faire sans hésiter les mises à jour nécessaires.
- [hs] titre quelconque
- Votre message n'a pas grand chose à voir avec la localisation de Debian en français, mais vous estimez qu'il peut intéresser suffisamment de personnes sur la liste pour y être envoyé. Vous signalez donc que votre message est hors sujet.
