Soumis par HKR le lun, 06/20/2016 - 08:37

Ajouter un nouveau manuel d'aide

Règles pour la création et modification de contenu⁽¹⁾

Les lignes directrices de la communauté Trisquel
Nous ne faisons de la promotion que pour le logiciel libre.
Le contenu de ce site est publié sous la licence FDL, n'utilisez pas du matériel provenant d'autres sites Web sans permission.
Si vous publiez un script, précisez sa licence, de préférence GPL⁽²⁾.
Si vous joignez un fichier, assurez-vous qu'il soit libre.
Incluez les captures d'écran en utilisant des pièces jointes.
Notez que les pages de ce manuel sont régulièrement mises à jour, si vous voulez participer à la rédaction, traduction, corrections, prenez soin de vérifier préalablement les versions originelles.
Si un article est marqué comme 'fait' cela ne veut pas nécessairement dire qu'il ne peut pas être amélioré. Cela veut simplement dire qu'il a atteint un stade suffisant pour sa publication, les aspects tels que l'orthographe et la grammaire peuvent toujours être améliorées ou corrigées. À titre d'exemple, si un article fait référence à une ancienne version de Trisquel celui-ci peut être mis à jour.
Vous pouvez essayer la syntaxe du Wiki^(en,fr) dans le Tas de sable.

La documentation de Trisquel doit rester le plus structurée que possible pour faciliter ses modifications, sa maintenabilité dans le temps ainsi que la navigation vers un manuel précis.

Pour y arriver voici quelques conseils d'édition :

Comment ranger les manuels ?

Chaque manuel est un manuel enfant de la page Liste des manuels par ordre alphabétique.

Chaque manuel doit être dans l'une des thématiques de la page Manuel.

Pour faciliter la navigation vers un manuel créez une page de manuel regroupant d'autres manuels en fonction d'une thématique par exemple la thématique Matériel.

Évitez de documenter deux fois la même chose dans deux bouts de Wiki différents. On préfèrera créer une nouvelle documentation factorisant les points communs entre ces Wikis et mettre un lien de cette nouvelle documentation dans chaque Wiki concerné.

Notes

(1) : Cette partie, auparavant nommée Règles pour l'édition de contenu, était sur la page Manuel. Voici la liste des personnes ayant participé à sa rédaction : AndrewT, RedGuff, marioger, slugnaz, Ker Tris et HKR.

(2) : Cette traduction non-officielle de la GNU GPL 3 est disponible à titre indicatif et n'a pas de valeur juridique car la version originale en anglais prime sur toutes traductions, officielles comme non-officielles.