Participer à la documentation du site Debian Facile.

Vous voulez aider DF¹⁾ en participant au WiKi ?
Quelle bonne idée !
Voici quelques informations pour vous indiquer comment faire.

Pensez à lire le paragraphe contributions et licence afin de vérifier que vous êtes en accord avec la politique de partage de la connaissance de DF.

Pour contribuer au wiki, il suffit d'être membre df inscrit sur le forum.

Comme sur le forum, les entretiens concernant le wiki se font sur le forum au post dédié pour le tuto à modifier (sinon le créer) et surtout pas par MP, (s'péce d'égoïstes) que tout l'monde en profite aussi !
Pour maintenir un tuto sans modification par d'autres contributeurs, on le signale dans la rubrique Suivi : de l'entête par le tag : en-chantier, tout simplement.

Merci à tous de vos efforts pour ce wiki !

Avant de créer une page dans le wiki, afin de ne pas créer de doublon, vérifier TOUJOURS par une petite recherche qu'elle n'existe pas déjà.
Si la page existe, vous pouvez la modifier pour l'améliorer ou la mettre à jour.

Si la page du Wiki n'existe pas Taïaut, créez-là dans le chantier !
Voir ci-dessous :

Pour créer une nouvelle page allez dans la page chantier et suivez les indications qui y sont portées.

La rédaction des tutos est libre bien sûr. Voici tout de même une liste de conseils qui permettront une meilleure intégration et à faciliter le suivi de votre page.

Lors de la rédaction :

• faites simple et généraliste pour faciliter son adaptation aux futures versions de Debian
• utilisez les balises <code> <code user> <code root> etc.</code>
• évitez surtout les redites ou documentations en doublon, c'est une plaie infâme lors des mises à jour !

Merci également de suivre les conventions suivantes :

• On utilise apt-get plutôt qu' aptitude autant que possible.
• On n'utilise pas d' apt-url, c'est tabou, c'est cruel, ça tue des chatons à coup de cuillère en bois.
• On limite au maximum l'utilisation des dépôts externes à Debian, ou alors on avertis fortement des dangers de sécurité qu'ils entraînent.
• On signale les mélanges de branches Stable/Testing/Sid par un encart Warning, parce que les FrankenDebian, ça fait peur

N'hésitez pas à demander conseil sur le forum aux habitués !

Les pages du wiki se rédigent en syntaxe DokuWiki.
Consultez la page d'aide à la syntaxe et entraînez-vous ou testez vos écritures si besoin est dans le bac-à-sable.

• La syntaxe de Dokuwiki
• Le bac à sable pour vous entrainer à rédiger sur le Wiki

Pour insérer une image dans le wiki, celle-ci doit impérativement être hébergée chez Debian-Facile car elle pourrait être retirée par son hébergeur à tout moment.
Assurez-vous aussi que cette image est sous GPL3 ou +.

• Images dans le wiki La méthode pas à pas.

• Créer des mini-tuto-video

Pour assurer le suivi et la maintenance des tutos, nous utilisons deux canaux distincts :

• Un sujet dans le forum pour les annonce, commentaires, retours et suggestions.
• Un système de tag pour indiquer l'état du tuto aux modérateurs.

L'en-tête des tutos contient la ligne suivante : * Commentaires sur le forum : [[:url-a-changer | Lien vers le forum concernant ce tuto]]((N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))

Elle est destinée à recevoir le lien vers le sujet du forum permettant les retours.
Il vous revient donc de créer le sujet de votre tuto dans la section DebianDocs(wiki) et Projet-df(git) du forum et de compléter l'url l'en-tête du tuto.

Pour faciliter le suivi d'un tuto, il est important de maintenir ses tags à jour.
On place les tags d'un tuto dans l'en-tête ou juste en dessous de la ligne de titre, via la syntaxe suivante : * Suivi : {{tag>en-chantier à-tester à-placer}}

S'il y a plusieurs tags, ils peuvent être listés séparés par des espaces :

{{tag>mon-tag1 mon-tag2 mon-tag3}}

Par exemple, pour un nouveau tuto, il faut veiller à ce que soit présente la ligne complète :

{{tag>en-chantier à-tester à-placer}}

Créer une page n'est pas le seul moyen d'aider le Wiki. Plus importante encore est la tâche de maintenir les pages existantes.
Pour voir l' état du wiki, c'est ici !

Les statistiques du wiki sont (seront) accessibles ici : stats.

Pour les curieux mais à usage des modos principalement :

• L'arborescence du wiki expliquée pas à pas.