Difference between revisions of "MOOC:Guide de rédaction"
From Livre IPv6
(→Structure) |
|||
Line 1: | Line 1: | ||
> [[MOOC:Accueil|MOOC]]>[[MOOC:Gestion_de_projet|Gestion de projet]] > [[MOOC:Guide_de_rédaction |Guide de rédaction]] | > [[MOOC:Accueil|MOOC]]>[[MOOC:Gestion_de_projet|Gestion de projet]] > [[MOOC:Guide_de_rédaction |Guide de rédaction]] | ||
---- | ---- | ||
− | + | __NOTOC__ | |
=Structure= | =Structure= | ||
Chaque activité du document compagnon doit avoir: | Chaque activité du document compagnon doit avoir: |
Revision as of 02:16, 8 April 2016
> MOOC>Gestion de projet > Guide de rédaction
Structure
Chaque activité du document compagnon doit avoir:
- Une introduction: pour présenter la problématique
- Une conclusion: pour rappeler les points importants à retenir de l'activité
- Une référence bibliographique: les citations dans le texte
- Pour aller plus loin: la liste des RFC citées dans le texte
Mise en forme
- Pas de lien vers d'autres pages du wiki
- Inutile de mettre un lien sur un RFC, c'est fait automatiquement par le wiki avec la syntaxe :: RFC xxxx
- les adresses, champs d'en-tête, sont à mettre en police courrier (balise HTML tt )
- Le figures sont à numéroter. Le titre de la figure est à mettre dans le texte sous la figure. Enfin chaque figure doit être citée dans le texte. Ceci se déclare de la manière suivante:
<center> [[Image:42-fig1.jpg|400px|center|thumb|Figure 2: Plan de migration vers IPv6. ]] </center>
- Uniquement les termes anglais sont à mettre en italique, pas les abbréviations anglaises qui restent en police normale. L'abbréviation précède le terme entre paranethèses:
TCP (''Transmission Control Protocol'')
- Les RFC mis dans la section pour aller plus loin sont cité dans le texte soient par [RFC XXXX] ou par Reflist
- Pour ajouter un encadré dans le texte. L'encadré sert à apporter des précisions ou à donner des informations générales. Le template est définit sous ce lien Template
{{HorsTexte| Titre|texte.}}
Titre
texte.
- Tous les RFC cités dans le texte doivent avoir le titre d'indiqué dans la section pour aller plus loin. Ils doivent être triés par ordres croissant de numéro. Si une abnalyse de Bortzmeyer existe, un lien URL doit être ajouté. Exemple:
RFC et leur analyse par S. Bortzmeyer :
Terminologie
- Noeud: Machine ou système connecté (routeur et Hôte). Utiliser à la place de machine
- Hôte : système d'extrémité
- Routeur: système relais
- Internet v4: Internet en IPv4
- Internet v6: Internet en IPv6
Erreurs communes
-
entête=> en-tête (nom masculin !) - Ce qui suit un en-tête est la charge utile
- relais est un mot invariable (s au singulier comme au pluriel)
- interface => nom féminin
- IPv4/IPv6 => le v en minuscule
- Internet avec un grand I pour le réseau mondial (avec un petit i signifie une interconnexion de réseaux)
- MTU est féminin.
- Auto-configuration, un - après Auto
Anglais / Français
- donner le terme français et la traduction anglaise entre parenthèses et italique
- ex: Le message ICMPv6 d'annonce de voisin (Neighbor Advertisment)
- Lorsqu'il y a une abbréviation donner l'abbréviation puis la signification entre parenthèses et italique
- ex: PI (Provider Iindependent).
- RFC est masculin
- Implémentation => mise en oeuvre
- Terminologie
- Solicited Multicast Address : Adresse multicast de sollicitation de voisin
Références
Avec le mécanisme de génération semi-auto du document compagnon, les références sous forme d'URL apparaissent sous la forme '[x]' sans que l'ont ait la liste correspondante de ces références en fin d'activivté.
Il est donc plus intéressant d'utiliser le module de référence
Reflist qui est construit sur le module Cite.
Dans le texte encadrer la référence par
<ref> ma ref</ref>
Ensuite, la liste des réferences est crée dans une page wiki par l'instruction
<references />
Une réference est sur le style: Auteur, Prénom. (Année). Editeur. Titre.
Par exemple:
<ref>Huston, G (2013). APNIC Labs. [http://labs.apnic.net/?p=335 A Primer on IPv4, IPv6 and Transition]</ref>
donnera[1]
References
- ↑ Huston, G (2013). APNIC Labs. A Primer on IPv4, IPv6 and Transition