Différences

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

--- utilisateurs:aldian:repicitrap_ikiw [Le 23/08/2017, 17:53]
aldian [Contributeur]
+++ — (Version actuelle)
@@ Ligne 1: / Ligne 1: @@
-====== Comment participer et améliorer cette documentation ? =====
-La [[:|documentation francophone d'Ubuntu]] est la principale source d'information francophone concernant Ubuntu et les logiciels libres. Elle est publiée sous forme de [[wpfr>wiki]], un système de rédaction ouvert et collaboratif. **Tout le monde peut aider** à l'améliorer chacun suivant ses talents, qu'il s'agisse de créer une nouvelle page, de mettre à jour des pages existantes, de simplifier, corriger, ou mettre en conformité avec nos normes rédactionnelles. Merci d'avance pour vos contributions!
-<note>Pour connaître les autres façons de contribuer à Ubuntu, consultez  [[:comment_participer|cette page]].</note>
-===== Les règles du wiki =====
-Pour pouvoir contribuer de manière efficace, le plus important est de se coordonner avec les autres contributeurs. Deux outils sont mis à disposition dans ce but: une liste de diffusion par email, et un salon de chat. S'y inscrire n'est pas une obligation, mais c'est plus sympa et ça permet de bénéficier de la relecture et des conseils des autres contributeurs. Par ailleurs c'est utile pour discuter de ce qu'il faut changer et ça aide les administrateurs à comprendre ce qu'il se passe.
-Par ailleurs il y a des règles de bon sens auxquelles il est demandé de se conformer: Se limiter au contenu tourné vers Ubuntu ([[wiki:ligne_editoriale|ligne éditoriale]]), respecter la législation française ([[wiki:ligne_ethique|ligne éthique]]), respecter les contributions des autres utilisateurs ([[:codedeconduite|code de conduite]]).
-Enfin il y a un certain nombre de bonnes pratiques qui seront détaillées un peu plus loin et qui visent globalement à avoir un wiki homogène rédigé dans un style neutre et avec des pages organisées de manière similaire, afin que le lecteur ne soit pas perdu en passant de l'une à l'autre.
-===== Apprendre à créer et à modifier des pages =====
-<note important>Merci d'aviser les autres contributeurs via la liste de diffusion ou le salon de discussion pour toute création de page et pour toute modification d'importance.</note>
-Vous pouvez modifier n'importe quelle page simplement en cliquant sur le lien //Modifier cette page// dans le menu (Il n'est pas nécessaire d'être connecté mais c'est une bonne pratique). N'hésitez pas à vous familiariser avec  la [[wiki:syntaxe|syntaxe du wiki]] en faisant des essais sur la page [[wiki:bac_a_sable|Bac à sable]]. Utilisez le bouton //Aperçu// pour prévisualiser vos modifications et une fois satisfait, laissez un commentaire expliquant vos changements dans le champ //Résumé// puis cliquez sur le bouton //Enregistrer//.
-Pour pouvoir créer une nouvelle page, il est nécessaire au préalable de [[http://forum.ubuntu-fr.org/register.php|s'enregistrer]] (ça passe par le forum car il y a une seule authentification pour l'ensemble du site). Une fois connecté, rendez-vous sur l'url de la page que vous souhaitez créer. Par exemple si vous souhaitez [[wiki:modeles:utilisateur|créer votre page contributeur]] afin de vous présenter, rendez-vous sur l'url http://doc.ubuntu-fr.org/utilisateurs/MON_PSEUDO et cliquez sur le lien //Créer cette page// dans le bloc //Actions// du menu de gauche. Pour créer une page dédiée à un logiciel, rendez vous sur l'url http://doc.ubuntu-fr.org/Nom_de_la_page et faites de même.
-Afin de garantir l'homogénéité du wiki, essayez pour chaque page créée ou éditée, de vous conformer à l'un des modèle proposés: [[wiki:modeles:application|Application]] pour parler d'un logiciel, [[wiki:modeles:portable|Portable]] pour présenter un ordinateur, [[wiki:modeles:materiel|Matériel]] pour présenter un périphérique, [[wiki:modeles:tutoriel|Tutoriel]] pour les explications pas à pas, [[wiki:modeles:portail|Portail]] pour lister les ressources en lien avec une thématique, et [[wiki:modeles:utilisateur|Utilisateur]] pour vous présenter sur le wiki. Si la page que vous projetez ne cadre pas avec l'un des modèles proposés, il vaut mieux poser la questions aux autres contributeurs que de se lancer dans une adaptation libre, surtout pour une première contribution.
-===== Bonnes pratiques =====
-En plus des règles évoquées dans les parties précédentes, un certain nombre de bonnes pratiques permettent de garantir la cohérence du wiki, ainsi que sa maintenabilité:
-==== Contributeur ====
-Les contributeurs qui participent régulièrement au wiki sont invités à **s'inscrire sur le site et à être connectés** lorsqu'ils enregistrent une page, car cela facilite énormément le travail des administrateurs et c'est plus convivial. Il est de plus recommandé de **s'inscrire sur la mailing liste et le salon de discussion** afin de pouvoir échanger avec les autres contributeurs, demander conseil, apporter des précisions,..
-Pensez par ailleurs à **vous abonner aux pages** que vous modifiez pour pouvoir en suivre les modifications et contrôler leur évolution. Enfin vous êtes invités à créer votre espace utilisateur, afin de vous présenter, donner éventuellement un moyen de vous contacter, et disposer d'un espace pour enregistrer vos brouillons.
-==== Rédaction ====
-Il est important de savoir **garder un ton neutre**, de parler à la troisième personne et d'être factuel **dans un style encyclopédique**: Éviter l'emploi de la premier personne qui est subjectif (j'ai fait ceci, je vous conseille cela). En effet cela revient à s'approprier une page pour soi et c'est contraire à l'esprit d'un wiki collaboratif qui se veut écrit par la communauté, pour la communauté. Dans le même ordre d'idée il est conseillé d'éviter d'exprimer une opinion, ou d'établir des hiérarchisations à caractère personnel: **le wiki ne prend pas parti, il établit des faits, et autant que possible il cite ses sources** (pensez à les indiquer en bas de page).
-Il est également important de rester aussi simple que possible. Les longues phrases alambiquées embrouillent généralement plus qu'autre chose. Aussi il est préférable dans la mesure du possible d'éviter les ellipses et d'aller au cœur du sujet par des phrases simples et courtes en évitant les mots savants lorsqu'un synonyme plus courant peut faire l'affaire. Il est également demandé d'éviter les anglicismes lorsqu'un mot existe en français pour parler d'une notion. Enfin, il est recommandé de **commencer par la base**: expliquer les notions les plus évidentes vous permettra de mettre en confiance les lecteurs les plus timides.
-==== Syntaxe ====
-    page pas déformée
-    respecter modèle
-    Utiliser les tags mais modérément (+versions supportées seulement)
-    Utiliser les mini-tutoriels
-    respecter syntaxe (liens) + pas d'images externes #Insérer des images
-    sudo
-===== Trucs et astuces =====
-- autre méthode de création de page
-===== Communiquer avec les autres contributeurs =====