Le Tue, 6 May 2003 09:53:27 +0200 Gérard Delafond gerard@delafond.org a écrit :
Le Mardi 06 Mai 2003 09:32 AM, Denis Barbier a écrit :
On Sat, May 03, 2003 at 06:41:05PM +0200, Gérard Delafond wrote:
Salut !
Une idée : <...> je pense qu'il faudrait marquer au début un avertissement qu'il existe une version anglaise plus à jour, avec éventuellement un lien vers cette version.
Je vois qu'on commence à avancer. Le message serait mieux s'il disait : "Cette traduction n'est pas à jour..."
Je dirais qqch comme : .SH AVERTISSEMENT La traduction de cette page de manuel n'est pas à jour ; veuillez consulter la version anglaise pour référence.
Je ne pense pas que mettre un lien automatique soit une bonne idée. Les lecteurs peuvent vouloir lire le document français mais devraient être avertis que la traduction n'est pas synchro.
En revanche, un truc genre hyperlien serait très bien.
Quelle différence fais-tu entre lien automatique et hyperlien ? Tu parles des liens .so ?
On peut même imaginer qu'il y ait un message générique dans les systèmes d'affichage des documents (par ex man:/ dans konqueror) qui dirait quelque chose comme :
Bof, les liens peuvent changer... De plus, l'utilisation de liens spécifiques à Konqueror (ou à toute autre application d'ailleurs) est à proscrire.
«Attention ! les versions françaises des documents sont généralement des traductions.
Monsieur de La Palice en aurait dit autant... ;)
Il est possible que ces traductions contiennent des erreurs ou ne soient pas à jour par rapport à l'original
en anglais (facultatif)
Il est également possible que la version anglaise soit elle-même en retard par rapport au programme lui-même.
C'est inhérent à tout type de documentation, et ne devrait donc pas être mentionné.
En cas de doute, n'hésitez pas à multiplier vos sources de documentation :-l'aide en ligne du programme (nom du programme --help le plus souvent)-la documentation sous forme texte souvent jointe au programme-le site web du programme»
Idem
Ça peut paraître idiot, mais beaucoup de gens, dont moi avant, croient à une informatique parfaite, où il ne viendrait pas à l'idée d'un développeur de mettre un programme à disposition si la doc n'est pas disponible et à jour.
Encore un exemple : man tar fr ne connaît pas l'option -j.
A+
Gérard