Différences

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

--- abuledu:developpeur:recommandations_de_redaction [2006/12/13 23:08]
jean
+++ abuledu:developpeur:recommandations_de_redaction [2016/01/21 12:00] (Version actuelle)
erics
@@ Ligne 1: / Ligne 1: @@
-<code>
+{{tag>version-8-08}}
-Documentation valable pour AbulÉdu Pro 1.4/1.6 et AbulÉdu PLM
-</code>
 ====== 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 21: / 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>
-.    Lien vers [[wp>Wikip%C3%A9dia|Wikipédia]]
+.    Lien vers [[wpfr>Wikip%C3%A9dia|Wikipédia]]
-.    Lien vers le [[wp>Jargon]] sur Wikipédia.
+.    Lien vers le [[wpfr>Jargon]] sur Wikipédia.
 </code>
+Pour accéder à wikipédia en anglais, insérer : wp
+Pour accéder à wikipédia en français, insérer : wpfr
 Pour savoir qu'il faut écrire ''Wikip%C3%A9dia'', j'ai cherché «wikipédia» sur le site [[http://fr.wikipedia.org/|Wikipédia]], et j'ai copié-collé le dernier mot de la barre d'adresse de mon navigateur juste après ''wp>'' entre les doubles crochets. Je me suis permis de réécrire le mot proprement derrière le "''|''"((le caractère "pipe" |  s'obtient sur un clavier de PC en maintenant la touche "Alt Gr" pressée tout en pressant la touche 6 au-dessus du clavier)), pour qu'il soit affiché de manière lisible.
@@ Ligne 40: / 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 73: / 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.