Bonjour,
inscrit depuis peu à la liste, je souhaite traduire les diverses documentations qu'on retrouve dans GNOME, car peu sont traduites alors que c'est le premier endroit que l'utilisateur va consulter en cas de problème.
Cependant, les traductions actuelles des documentations ne sont pas toutes formatées identiquement, du moins dans l'index que présente yelp : certaines sont intitulées « Manuel de l'utilisateur », « guide de l'utilisateur » ou « Manuel d'utilisation ». De même, certains titres sont suivis du le numéro de version, ou précédés de « Manuel de » là ou d'autres possèdent simplement le nom du logiciel documenté. Du coup, l'ordre de présentation des applications dans l'aide n'est pas le meme que dans le menu GNOME, ce qui ralentit la recherche.
Le mieux pour s'en rendre compte est d'aller dans la rubrique d'aide pour les applets (Dans yelp, Bureau -> Applets des tableaux de bord).
En plus, certaines documentations traduites n'ont pas traduit le nom de l'application. Par exemple, dans la page d'aide des applets, on clique sur « Bulletin météo », et on se retrouve sur une page de documentation intitulée « Manuel de l'applet Weather Report V2.3.1 ». Ce n'est pas logique.
Ainsi, ce que j'aimerai faire (en plus de traduire des docs de GNOME jusuqu'à ce que j'en aie marre), c'est rendre le tout plus homogène et plus consistant en adoptant une seule règle pour tout ça, avec l'accord des habitués de la liste.
Ce que je propose, c'est que les entrées de documentation dans yelp (fichiers omf) aient la forme suivante :
<Nom de l'application> Manuel d'utilisation de <nom de l'application>
ou
<Nom de l'applet> Manuel d'utilisation de l'applet <nom de l'applet>
et traduire systématiquement les noms des applications en leur équivalent français dans les documentations.
Si les titres étaient préfixés par « Manuel de » ou même par « Applet » pour les applets, cela perturberait la reconnaissance de l'application par l'utilisateur. Il me semble important que l'intitulé dans l'aide soit le même que dans le menu GNOME.
Sinon, le numéro de version de la documentation ne me semble pas être une information de grande valeur pour la personne qui recherche de la doc, et pour ceux qui désirent réellement connaître cette information, ele est disponible dans le lien « À propos de ce document » accompagné de l'historique du manuel.
Voilà. J'aimerai envoyer des patchs pour les documentations existantes afin qu'elles respectent ce schéma si vous êtes d'accord.
J'enverrai les patchs sur la liste, mais vaut-il mieux un mail par documentation patchée, ou plutôt un mail global avec plusieurs patchs de plusieurs documentations retouchées ?
Bonne journée
Christophe Bliard