gabriel jourdain a écrit :
Bonjour à tous,

Dans le cadre de la rédaction d'un howto, existe t-il un emplacement privilégié pour positionner un avant propos, informant de la nécessité de maîtriser quelques notions simples, et doit-il paraître dans la table des matières ?


Bonjour Gabriel,

Un avant-propos se place... avant le propos, non ? ;)

Pour ma part je pense que les documents devraient toujours débuter par une introduction / avant-propos / présentation. C'est le lieu où donner des indications générales et développer le plan du doc. C'est aussi, comme tu le ressens bien, le lieu où préciser les notions qui doivent être maîtrisées pour en tirer la substantifique moëlle.

Pour ce qui est de présence de l'avant-propos dans la table des matières, je pense que oui, il doit y figurer.

C'étaient mes 2 euro-cents du 14 juillet.

Bonne journée,
--
Jean-Francois Nifenecker, Bordeaux

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Répondre à