Gentoo Archives: gentoo-doc-fr

From: Xavier Neys <neysx@g.o>
To: gentoo-doc-fr@l.g.o
Subject: Re: [gentoo-doc-fr] Réflexions du lundi matin^Wmidi
Date: Mon, 29 Mar 2004 16:18:12
Message-Id: 40684C3E.4020308@gentoo.org
In Reply to: Re: [gentoo-doc-fr] Réflexions du lundi matin^Wmidi by Camille Huot
1 Camille Huot wrote:
2 > Hum j'avais répondu mais le mail s'est perdu et j'ai mis du temps à le
3 > retrouver :
4 >
5 > Je ne vois pas le problème d'utiliser valider à la place de commit.
6 cf. ci-dessous.
7
8 > Enregistrer ne me plait guère et confirmer me plait bien.
9 >
10 >>Disons les choses autrement. Si je te demande de valider gentoo-howto.xml,
11 >>comment sais-tu si je te demande de vérifier qu'il respecte la DTD ou si te
12 >>demande de faire un commit ?
13 >
14 >
15 > gentoo-howto.xml étant un fichier et non pas une transaction cvs, je
16 > vais vérifier la DTD.
17 >
18 Donc si je traduis « you need to commit labelledoc.xml » par « vous devez
19 valider labelledoc.xml », tu ne fais plus commit, mais bien xmllint.
20 Voilà un bel exemple qui démontre que commit != valider
21 Ça ne veut pas dire que valider ne dois jamais être utilisé. Je préfère
22 enregistrer, valider est acceptable aussi, mais pas systématiquement.
23 C'est ce qui est le plus important pour moi : pas systématiquement et jamais
24 quand on parle d'enregistrer un document xml.
25
26 >
27 >>>Pour le reste, je prefere personnellement voir « page du manuel » que
28 >>>« page man ». Le lecteur doit savoir ce qu'est le manuel. S'il ne le sais
29 >>>pas il faut lui dire. On peut aussi tourner la phrase comme tu le proposes.
30 >>>
31 >>
32 >>Une page du manuel est bien trop flou. Comment le lecteur peut-il savoir de
33 >>quel manuel il s'agit ? Les pages man, info, html dans doc/, le gros bouquin
34 >>sur le coin du bureau, le manuel livré avec sa distribution ou le manuel Gentoo ?
35 >
36 >
37 > Je suis d'accord. Pourtant, tout utilisateur moyen sait que « le manuel »
38 > est le man, je pense. Faites ce que vous voulez :)
39 >
40 > +
41 Et pourtant, quand je fais man tar, je vois «The GNU folks, in general,
42 abhor man pages, and create info documents instead.»
43 Moi, j'ai le réflexe man et d'info, je ne connais que 'q' pour vite en sortir.
44 /me déteste info
45 Cependant, on peut concevoir que pour un utilisateur de GNU/Linux, info soit
46 *LE* manuel.
47 Je ne suis pas opposé à une « page man ». Celui que ça choque peut utiliser
48 une phrase qui énonce la commande entre <c></c> comme proposé plus tôt, c'est
49 le plus explicite pour un utilisateur quel que soit son niveau AMHA.
50
51 --
52 / Xavier Neys
53 \_ Gentoo Documentation Project
54 / French & Internationalisation Lead
55 \ http://www.gentoo.org/doc/en
56 /\

Attachments

File name MIME type
signature.asc application/pgp-signature

Replies

Subject Author
Re: [gentoo-doc-fr] Réflexions du lundi matin^Wmidi Camille Huot <cam@g.o>