Différences

Ci-dessous, les différences entre deux révisions de la page.

--- abuledu:developpeur:recommandations_de_redaction [2008/11/23 12:09]
http://claimid.com/frucot
+++ abuledu:developpeur:recommandations_de_redaction [2016/01/21 12:00] (Version actuelle)
erics
@@ Ligne 1: / Ligne 1: @@
+{{tag>version-8-08}}
 ====== Recommandations pour la rédaction de la documentation AbulÉdu ======
 ===== Propos et idées =====
-Veillez à ce que vous écrivez soit bien en rapport avec le titre de l'article. Ne créez pas de hors-sujet ou de contresens. Au besoin n'hésitez pas à demander l'aide d'un relecteur sur [[web@abuledu.org|la liste de diffusion web]].
+Veillez à ce que vous écrivez soit bien en rapport avec le titre de l'article. Ne créez pas de hors-sujet ou de contresens. Au besoin n'hésitez pas à demander l'aide d'un relecteur sur le [[http://forum.abuledu.org|forum d'AbulÉdu]] et/ou [[web@abuledu.org|la liste de diffusion web]].
 Si vous sentez que vous faites un hors-sujet mais que l'idée vous paraît tout de même importante, créez une nouvelle page pour cette idée dans une section de la documentation ou dans le glossaire.
@@ Ligne 17: / Ligne 18: @@
 Avant de créer un article spécifique dans le glossaire, cherchez s'il y a une définition pertinente du mot sur [[http://fr.wikipedia.org/|Wikipédia]] et si oui, ne suffirait-elle pas ? En général, nous ne créons une page du glossaire que pour un terme de [[glossaire:jargon informatique]].
-Pour créer un lien vers Wikipédia (comme [[wp>Wikip%C3%A9dia|celui-ci]], regardez le code ci-dessous. Notez que pour un mot comportant des accents, il est nécessaire de réécrire le mot dans le lien (ligne 1), alors que pour un mot sans accent, le lien suffit (ligne 2) :
+Pour créer un lien vers Wikipédia (comme [[wpfr>Wikip%C3%A9dia|celui-ci]], regardez le code ci-dessous. Notez que pour un mot comportant des accents, il est nécessaire de réécrire le mot dans le lien (ligne 1), alors que pour un mot sans accent, le lien suffit (ligne 2) :
 <code>
@@ Ligne 39: / Ligne 40: @@
 ===== Rédaction de nouveaux articles =====
-  * **Écrivez un article sur un sujet que vous maîtrisez** depuis un bon moment, pas sur une fonctionnalité que vous avez découvert récement. Vous aurez ainsi eu le temps de faire le tour de la question, serez plus apte à trouver facilement une organisation didactique de l'information, à choisir des captures d'écran adaptées et utiles, et moins sujet à introduire des erreurs.
+  * **Écrivez un article sur un sujet que vous maitrisez** depuis un bon moment, pas sur une fonctionnalité que vous avez découvert récemment. Vous aurez ainsi eu le temps de faire le tour de la question, serez plus apte à trouver facilement une organisation didactique de l'information, à choisir des captures d'écran adaptées et utiles, et moins sujet à introduire des erreurs.
-  * **Un article ne doit pas être trop long** : cette apréciation est subjective, mais c'est important pour le poids des pages et leur interprétation sur les postes anciens, ainsi que pour la lisibilité générale de l'article et la facilité à trouver l'information : il ne faut pas avoir besoin de manier la roulette de la souris plus de quelques tours pour trouver l'information que l'on cherche dans une page. Il est par exemple innoportun d'écrire un article pour la configuration réseau de toutes les versions de Windows. On préfèrera un article :
+  * **Un article ne doit pas être trop long** : cette appréciation est subjective, mais c'est important pour le poids des pages et leur interprétation sur les postes anciens, ainsi que pour la lisibilité générale de l'article et la facilité à trouver l'information : il ne faut pas avoir besoin de manier la roulette de la souris plus de quelques tours pour trouver l'information que l'on cherche dans une page. Il est par exemple inopportun d'écrire un article pour la configuration réseau de toutes les versions de Windows. On préfèrera un article :
-    * **décrivant de manière générale** ou globale la configuration qui doit être faite. En quelques lignes, **les grands principes**((comme ça un administrateur qui maîtrise son sujet aura l'information utile sans avoir à lire l'article détaillé pour la version spécifique qu'il utilise)),
+    * **décrivant de manière générale** ou globale la configuration qui doit être faite. En quelques lignes, **les grands principes**((comme ça un administrateur qui maitrise son sujet aura l'information utile sans avoir à lire l'article détaillé pour la version spécifique qu'il utilise)),
     * **indiquant** pour tel ou tel système **qu'il y a des spécificités** (sans les citer), incitant donc à lire l'article détaillé si le lecteur ne les connait pas,
     * et renvoyant vers tous les articles traitant chacun de la configuration détaillée (avec captures d'écran) d'une version donnée.
   * **Utilisez les titres et les sous-titres** : la table des matières est automatiquement générée à partir de ceux-ci, ils aident donc à se diriger dans un document lorsqu'on cherche une information très précise.
+  * **Utilisez les annotations suivantes** (Vérifier, Illustrer, Compléter, Actualiser) afin de permettre une recherche plus rapide des pages à modifier. Idéalement, ces annotations seront placées entre les balises %%<code> et </code>%%.
@@ Ligne 72: / Ligne 75: @@
 ==== Généralités sur DokuWiki ====
-Je n'ai pas encore réalisé la traduction / adaptation de la syntaxe de DokuWiki. Cependant, Les contributeurs du site [[http://www.ubuntu-fr.org|Ubuntu-FR]] en ont [[http://wiki.ubuntu-fr.org/wiki/syntax|une qui est excellente]], je vous conseille donc de la lire en attendant. Avec ça vous pourrez commencer à écrire des articles.
+Je n'ai pas encore réalisé la traduction / adaptation de la syntaxe de DokuWiki. Cependant, Les contributeurs du site [[http://www.ubuntu-fr.org|Ubuntu-FR]] en ont [[http://doc.ubuntu-fr.org/wiki/syntaxe|une qui est excellente]], je vous conseille donc de la lire en attendant. Avec ça vous pourrez commencer à écrire des articles.
 Vous pouvez aussi «regarder le source d'une page((bouton en bas à gauche quand vous êtes visiteur))» ou «éditer une page((bouton en bas à gauche quand vous êtes identifié sur le site))» qui vous plait pour copier tout ou partie comme point de départ pour votre article.