Enviado por HKR o Lun, 06/20/2016 - 07:37
Revisión de Ajouter un nouveau manuel d'aide de Lun, 06/20/2016 - 07:37
As revisións permítenlle rastrexar as diferenzas que hai entre distintas versións dunha entrada.
La documentation de Trisquel doit rester le plus structuré que possible pour facilité sa modification, sa maintenabilité dans le temps ainsi que la navigation vers un manuel précis.
Pour y arriver voici quelque conseil d'édition :
- É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és.
- Chaque documentation est un manuel enfant de Liste des manuels par ordre alphabétique. Ainsi on est certain que tous les manuels seront listés quelque par et au même endroit. Sur la même la page (dans l'arborescence) ajouter votre nouvelle documentation dans l'une des thématiques déjà présente. Si elle n'existe pas n'hésiter pas à la créer. Si votre nouveau manuel recoupe plusieurs thématiques vous pouvez la mettre dans plusieurs thématiques. Cela en facilitera grandement sa recherche.
- Pour facilité la navigation vers un manuel créez une page de manuel regroupant d'autres manuel en fonction d'une thématique par exemple la thématique Matériel.
- Chaque thématique doit être listé dans Manuel et Liste des manuels par ordre alphabétique (dans l'arborescence ainsi que dans la liste par ordre alphabétique).
