logo Debian Debian Debian-France Debian-Facile Debian-fr.org Forum-Debian.fr Debian ? Communautés logo inclusivité

Debian-facile

Bienvenue sur Debian-Facile, site d'aide pour les nouveaux utilisateurs de Debian.

Vous n'êtes pas identifié(e).


L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT → ODT PDF Export

Ceci est une ancienne révision du document !


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, il faut auparavant être membre df inscrit sur le forum.
Tout ajout ou modification des tutos implique (pour l'instant…) de se connecter sur le wiki par la touche connexion et d'utiliser vos nom d'utilisateur et mot de passe du forum pour vous identifier.

Création et modification des pages

Contributions et licence

Toutes vos contribution à ce wiki seront placées sous les termes de la licence suivante : GNU Free Documentation License 1.3 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

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 changement, 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 l'atelier !
Voir ci-dessous :

Nouvelle page du wiki

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

Vous êtes laissés très libre quant au style de la rédaction des tutos. Voici tout de même une liste de conseils qui permettront une meilleure intégration et un suivi facilité de votre page.

Lors de la rédaction de votre page,

  • pensez à faire simple et généraliste pour faciliter son adaptation aux futures versions de Debian
  • pensez à utiliser les balises <code> <code user> <code root> etc.</code> à bon escient
  • évitez toute redite ou documentation 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, ça tue des chatons à coup de cuillère en bois.
  • On limite au maximum l'utilisation des dépôts externes, ou alors on prévient des dangers de sécurité qu'ils amènent.

N'hésitez pas à demander conseil aux modos et rédacteurs 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 si besoin dans le bac-à-sable.

Insérer une image dans le wiki

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

Tags et retours sur le forum

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.

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. C'est à vous de créer le sujet dans la section DebianDocs(wiki) et Projet-df(git) du forum et de compléter 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

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

1)
Debian-Facile !
atelier/atelier.1379913045.txt.gz · Dernière modification: 23/09/2013 07:10 par smolski

Pied de page des forums

Propulsé par FluxBB