Différences

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

--- wiki:recommandation_wiki_proposition [Le 20/10/2008, 09:45]
Ma-Nu
+++ — (Version actuelle)
@@ Ligne 1: / Ligne 1: @@
-{{tag>wiki brouillon}}
-<note important>Cette page est majoritairement issue de la page [[ameliorer_wiki]].
-Elle fait partie d'une proposition de réécriture incluant la page [[ameliorer_wiki_proposition]].
-Il existe une page pour pouvoir [[utilisateurs:ma-nu:ameliorer_wiki_discussion|en discuter]]
-</note>
-----
-Des recommandations sont faites pour favoriser le travail commun. Choisir de les suivre permet d'optimiser l'efficacité de ses propres contributions tout en facilitant le travail des autres. (Elle sont notamment le résultat d'une réunion ayant eut lieu en 2006)((voir [[:évènements:reunion3_2006_compte_rendu#a._wiki|le compte-rendu de la réunion 2006 n° 3]])).
-===== Intro =====
-Les recommandations sont présenté de différentes manières :
-  * Selon le **types d'interventions** ( en fonction de l'importance des modifications effectuées)
-  * et selon de **type d'article** (en fonction de la nature du sujet)
-Une démarche vise également a Centraliser les informations récurrentes en utilisant les **mini tutoriels**
-Enfin quelles **pratiques appréciées** sont répertoriées.
-===== types d'interventions =====
-  * **Modifications légères :** Pour corriger des fautes d'orthographe, des liens ou toutes autres coquilles, et d'une manière générale pour les amélioration la forme plutôt que du fond, le fait de remplir la section « Résumé » en bas de la zone de modification permet de décrire rapidement le genre de contribution a l'intention des autre contributeurs.
-Cette pratique est apprécié car elle facilite grandement l'utilisation de l'historique.
-  * **Interventions importantes :** en cas de refonte d'articles, d'ajout ou de suppression de passages ou plus généralement de modifications changeant grandement le sens du document, L'équipe qui gère cette documentation souhaite en être informé par l'intermédiaire de la [[wiki:liste_discussion|la liste de discussion de la documentation]]documentation. Ce type d'envoi nécessite une inscription préalable [[http://eshu.ubuntu-eu.org/mailman/listinfo/ubuntu_wiki-fr|sur son portail]].
-Cela permet aux utilisateurs de la mailing liste d'intervenir plus rapidement pour ajouter les logiques d'uniformisations, pour corriger les éventuelles erreurs, ...
-  * **Créations de nouvelles pages :** Pour pouvoir [[:wiki:comment_creer_une_page|créer une page]], il faut être connecté en tant que membre de ce site (il s'agit du même compte que pour le forum, pour s'inscrire, c'est [[http://forum.ubuntu-fr.org/register.php|ici]]). Comme c'est aussi une intervention importante, l'équipe qui gère le wiki souhaite également en être informé par l'intermédiaire de la mailing liste
-=== Modèles de page ===
-En cas de création d'un page il existe des modèles standardisé :
-  * [[wiki:modeles:materiel]] pour la création d'une page concernant sur du matériel informatique (hardware)
-  * [[wiki:modeles:application]], pour la création d'une page concernant un logiciel (software).
-===== types d'articles =====
-Il existe essentiellement 3 types d'articles sur le wiki :
-  * **Les pages application** : leur but est d'expliquer et présenter une application (installée par défaut ou non). Il existe [[wiki:modeles:application|un modèle]] pour ce type d'articles. Les pages application sont placées à **la racine** du wiki.
-  * **Les pages matériel** : leur but est d'expliquer comment faire fonctionner un matériel particulier sous Ubuntu. Il existe [[wiki:modeles:materiel|un modèle]] pour ce type d'articles ainsi qu'un modèle spécifique pour les [[wiki:modeles:portable|portables]]. Veillez à être le plus généraliste possible (par exemple, un modem PPPOE s'installe de la même manière pour tous les fournisseurs d'accès : il n'est pas nécessaire d'écrire une nouvelle page pour Free, Skynet, Alice, etc.). Les pages matériel doivent comporter le tag « matériel » et sont placées à **la racine** du wiki.
-  * **Les tutoriels** : Ils se proposent de résoudre une problématique et utilisent généralement plusieurs applications (exemple : [[tutoriel:comment_compiler_un_kernel_sur_mesure|Personnaliser son kernel ou comment compiler un kernel sur mesure ?]]). Les tutoriels n'ont pas vraiment de modèle ; veillez cependant à mentionner les versions d'Ubuntu pour lesquelles il est écrit. Les tutoriels doivent comporter le tag « tutoriel » et sont placés dans le **sous-dossier « tutoriel »**.
-===== mini-tutoriels  =====
-Afin d'alléger la documentation, il est demandé aux contributeurs de ne pas expliciter directement dans la page certaines actions souvent invoquées. A la place, il est renvoyé à des "mini-tutoriels" grâce à des liens. Voici la liste des actions en question et les liens à utiliser :
-==== Installation de paquets ====
-Utilisez une phrase du type : //[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **foo bar etc**// grâce au code :
-<code>[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **foo bar etc**.</code>
-==== Suppression de paquets ====
-Utiliser une phrase du type : //[[:tutoriel:comment_supprimer_un_paquet|Supprimez les paquets]]// **foo bar etc** grâce au code :
-<code>[[:tutoriel:comment_supprimer_un_paquet|Supprimez les paquets]] **foo bar etc**.</code>
-==== Édition de fichier ====
-Utilisez une phrase du type : //[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] **/chemin/du/fichier**// grâce au code :
-<code>[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] **/chemin/du/fichier**.</code>
-==== Modification des sources de mises à jour (dépôts) ====
-Utilisez aussi un lien vers le tutoriel du type :\\
-//[[:tutoriel:comment_modifier_sources_maj|Modifiez vos sources de mises à jour]] pour y ajouter le dépôt suivant ://
-<file>deb http://url_du depot …</file>
-Code à utiliser :
-<code>
-[[:tutoriel:comment_modifier_sources_maj|Modifiez vos sources de mises à jour]] pour y ajouter le dépôt suivant :
-<file>deb http://url_du depot …</file>
-</code>
-==== Recharger la liste des paquets ====
-Utilisez une phrase du type : //[[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste des paquets]]// grâce au code :
-<code>[[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste des paquets le fichier]]</code>
-==== Création d'un Lanceur ====
-Utilisez un lien vers le tutoriel du type :
-//[[:raccourci-lanceur|Créez un raccourci]] en utilisant comme commande : //
-  foo
-Code à utiliser :
-<code>
-[[:raccourci-lanceur|Créez un raccourci]] en utilisant comme commande :
-  foo
-</code>
-===== pratiques appréciées =====
-==== Créer une page utilisateur ====
-**[[:wiki:modeles:utilisateur|Créer une page utilisateur]]** permet de mettres quelques informations pour se présenter ou encore pour donner un moyen d'être contacté, ou encore de créer des pages temporaires dans cette page utilisateur pour plus de commodité.
-==== Les sources ====
-Ce qui recopié ou traduit  il est nécessaire de vérifier la licence sous laquelle cet article est placé (
-  * Si la licence ne le permet pas la modification serra illégale, et serra donc supprimé rapidement).
-  * Si elle le permet il faut l'indiquer pour éviter qu'elle soit supprimé en précisant la provenance et l'auteur de l'article original (D'ailleurs, un petit courriel à cet auteur lui fera sûrement plaisir).
-==== Utiliser le bouton Aperçu ====
-Lorsque vous éditez une page, l'utilisation du bouton **Aperçu** permet de sauver régulièrement les modifications apportés et évite de les perdres en cas de plantage sans avoir recours au bouton **Sauver**. Il crée un brouillon que  récupérable sans difficulté en cas de besoin.
-De trop nombreuses sauvegardes surchargent la page **Derniers changements** et la boîte aux lettres de ceux qui reçoivent un courriel à chaque sauvegarde (si si, y'en a ;-).
-==== Utiliser les tags modérément ====
-Chaque page doit être référencée avec au moins un tag (mot-clé). Mais n'en abusez pas : trop de tags est contre-productif. Inspirez-vous des tags présents dans les modèles de pages [[:wiki:modeles:application]] et [[:wiki:modeles:matériel]] et essayez de vous limiter à ceux déjà existant (voir la [[:category|liste des tags]]). Et n'oubliez pas que la règle, c'est de mettre les accents dans les tags (mat__é__riel et non mat__e__riel par exemple).
-==== Respecter le code de conduite ====
-Comme dans tout ce qui a trait à Ubuntu, sa philosophie induit un [[:codedeconduite|code de conduite]].
-===== Les adresses utiles =====
-==== Les coordinateurs ====
-En cas de doute, en cas de problème : contactez un coordinateur !
-Ils sont accessibles par courriel : [[utilisateurs:_Enchained]], [[utilisateurs:Ner0lph]] et [[utilisateurs:DidRocks]].
-==== La liste de discussion ====
-Une liste de discussion est disponible pour les contributeurs du wiki. Il est recommandé de s'y inscrire et d'y annoncer ses modifications importantes.
-Plus d'informations sur [[liste_discussion|cette page]]
-==== Autres adresses ====
-  * Pour rédiger des articles, on utilise la syntaxe DokuWiki : [[wiki:syntaxe|voir la syntaxe]].
-  * [[wiki:ajout_image|Pour ajouter des images dans le wiki]].
-  * Voir les [[groupetraducteur:aide_a_la_traduction|aides à la traduction]].
-  * Les modèles : [[wiki:modeles:utilisateur|utilisateur]], [[wiki:modeles:application|application]], [[wiki:modeles:materiel|matériel]], [[wiki:modeles:portable|portable]].
-  * La page des [[:wiki:chantiers|chantiers en cours]] pour ceux qui veulent aider mais sont en manque d'inspiration.
-----b