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.

• 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 la liste de discussion de la documentationdocumentation. Ce type d'envoi nécessite une inscription préalable sur son portail.
• Créations de nouvelles pages : Pour pouvoir 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 ici). comme c'est aussi une intervention importante, l'équipe qui gère le wiki souhaite aussi en être informé.

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 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 un modèle pour ce type d'articles ainsi qu'un modèle spécifique pour les 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 : 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 ».

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 :

Utilisez une phrase du type : Installez les paquets foo bar etc grâce au code :

[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **foo bar etc**.

Utiliser une phrase du type : Supprimez les paquets foo bar etc grâce au code :

[[:tutoriel:comment_supprimer_un_paquet|Supprimez les paquets]] **foo bar etc**.

Utilisez une phrase du type : Éditez le fichier /chemin/du/fichier grâce au code :

[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] **/chemin/du/fichier**.

Utilisez aussi un lien vers le tutoriel du type :
Modifiez vos sources de mises à jour pour y ajouter le dépôt suivant :

deb http://url_du depot …

Code à utiliser :

[[: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>

Utilisez une phrase du type : rechargez la liste des paquets grâce au code :

[[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|rechargez la liste des paquets le fichier]]

Utilisez un lien vers le tutoriel du type : Créez un raccourci en utilisant comme commande :

foo

Code à utiliser :

[[:raccourci-lanceur|Créez un raccourci]] en utilisant comme commande :

  foo

Si vous comptez participer régulièrement au wiki, vous êtes invités à 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éé.

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.

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).

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 application et matériel et essayez de vous limiter à ceux déjà existant (voir la liste des tags). Et n'oubliez pas que la règle, c'est de mettre les accents dans les tags (matériel et non materiel par exemple).

Comme dans tout ce qui a trait à Ubuntu, inspirez-vous de son code de conduite.

En cas de doute, en cas de problème : contactez un coordinateur ! Ils sont accessibles par courriel : _Enchained, Ner0lph et DidRocks.

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 cette page

• Pour rédiger des articles, on utilise la syntaxe DokuWiki : voir la syntaxe.
• Pour ajouter des images dans le wiki.
• Voir les aides à la traduction.
• Les modèles : utilisateur, application, matériel, portable.
• La page des chantiers en cours pour ceux qui veulent aider mais sont en manque d'inspiration.