Table des matières

Participer à la documentation du site Debian Facile.

Vous voulez aider DF1) en participant au WiKi ?
Quelle bonne idée ! :-)
Voici quelques informations pour vous indiquer comment faire.

Prérequis

Licence

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

Créer un compte et se connecter

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

Création et modification des pages

Contributions et licence

Toutes vos contributions à ce wiki seront placées sous les termes de la licence suivante : GNU General Public License 2 et les droits d'auteurs seront partagés avec l'Association Debian-Facile. Elles ne pourront alors plus être retirées du Wiki sans bonne raison.

Modifier une page existante

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 ! :-D
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.

Veuillez tout de même signaler les gros changements, comme une refonte complète de page, dans le forum à la rubrique DebianDocs(wiki) et Projet-df(git).
Les pages récentes du wiki disposent déjà d'un tel sujet signalé dans l'en-tête.
Si aucun n'est indiqué, vous pouvez en créer un nouveau dans cette section du forum (sans oublier de le reporter aussi dans l'en-tête url de la page du wiki).

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

Le chantier

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

Comment bien rédiger

Conseils et conventions

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 :

Merci également de suivre les conventions suivantes :

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

Syntaxe du wiki

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.

Insérer une image dans 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 +. :-?

Créer une video-tuto pour le wiki

Tags et retours sur le forum

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

Retour sur le forum

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.

Tags

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}}
Pour marquer un tuto comme rajouter le tag
À créer à-créer
En chantier en-chantier
À tester à-tester
À placer à-placer
À compléter à-compléter
À corriger à-corriger
Obsolète obsolète

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

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

Comment aider à améliorer le WiKi

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 !

Statistiques sur le Wiki

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

Arborescence

Pour les curieux mais à usage des modos principalement :

1)
Debian-Facile !