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
