Différences

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

--- wiki:recommandation_wiki_proposition [Le 17/10/2008, 10:46]
88.167.28.185, 127.0.0.1
+++ — (Version actuelle)
@@ Ligne 1: / Ligne 1: @@
-Voiçi des recommandation pour optimiser les contributions ((voir [[:évènements:reunion3_2006_compte_rendu#a._wiki|le compte-rendu de la réunion 2006 n° 3]])).
-<note important>Cette page est une proposition pour scinder la page [[ameliorer_wiki]] existante en [[ameliorer_wiki_proposition]] et la présenta page [[recommandation_wiki_proposition]]</note>
-====== Principes de base =====
-<note>Cette partie nouvelle est faite a titre d'exemple et dans un premier temps dans le but d'être discuté. (surtout la partie métaphore)</note>
-Quelques principes élémentaires qui sont chaudement recommandé :
-  * **Rester aussi simple que possible** : Cette notice a comme ambition de pouvoir s'adresser à tous.
-  * **Distinguer les faits** : C'est eux qui vont aider l'utilisateur. Un choix, une préférence, ou une recommandation sont du domaine des avis, il doivent être signalé comme tel en précisant selon qui.
-  * **Ce concentrer sur ce qui est commun** : C'est ce qui fait le liens entre tous les sous-sujet qui permet d'éviter de perdre l'utilisateur de cette notice et d'aborder la suite avec les idées claire.
-Des métaphore pour aider :
-  * Le //pense bête communautaire// : On y met juste ce qui est utile pour soi même en laissant la possibilité aux autres de faire la même chose.
-  * Le //bagage pour un voyage vers l'inconnu// : C'est a dire tenter de mettre le maximum de chose utile tous en restant le plus léger possible, pour pouvoir faire face à des problèmes qu'on ne connais pas encore.
-====== Pratique technique recommandées =====
-===== Selon le types d'interventions =====
-  * **Modifications légères :** si vous corrigez des fautes d'orthographe, des liens ou toutes autres coquilles, ou si vous améliorez la forme plutôt que le fond, alors il ne vous est rien demandé d'autre que de remplir la section « Résumé » en bas de la zone de modification : ceci permet de décrire rapidement quel genre de contribution vous avez apporté, à l'attention des autres contributeurs.
-  * **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]].
-  * **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 aussi en être informé.
-===== selon le 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 »**.
-===== Le mini-tutoriels, pour centraliser les infos récurrentes =====
-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>
-===== Les pratiques appréciées =====
-==== Créer une page utilisateur ====
-Si vous comptez participer régulièrement au wiki, vous êtes invités à [[:wiki:modeles:utilisateur|Créer une page utilisateur]]. Vous pourrez vous présenter et donner un moyen de vous contacter.
-Si vous aviez besoin de créer une page temporaire, vous pourriez la placer dans votre répertoire ainsi créé.
-==== Les sources ====
-Si vous avez l'intention de recopier ou traduire un article ou une partie d'article d'un autre site, assurez vous au préalable que la licence sous laquelle cet article est placé vous le permet. De plus, il vous faudra indiquer la licence elle-même, la provenance et l'auteur de l'article original. D'ailleurs, un petit courriel à cet auteur lui fera sûrement plaisir.
-==== le bouton Aperçu ====
-Lorsque vous éditez une page, vous serez tenté de sauver régulièrement votre travail pour éviter de le perdre en cas de plantage. Pour cela, préférez l'utilisation du bouton **Aperçu** à celui **Sauver**, cela crée un brouillon que vous pouvez récupérer sans difficulté en cas de besoin. En effet, de trop nombreuses sauvegardes surchargent la page **Derniers changements** et la boîte aux lettres de ceux qui reçoivent un courriel à chaque sauvegarde (sisi, y'en a).
-==== Les tags ====
-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).
-==== Respectez le code de conduite ====
-Comme dans tout ce qui a trait à Ubuntu, inspirez-vous de son [[: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.
-----