Ceci est une ancienne révision du document !
La documentation du site Ubuntu-FR est publiée sous forme de wiki, un système de rédaction ouvert et collaboratif que chacun est libre de modifier.
Modifier une page
Il suffit de cliquer sur éditer cette page (dans l'encart actions en haut a gauche) pour avoir la possibilité de modifier une page existante.
Le bouton aperçu permet de visualiser les changements et permet de les retrouver (depuis son ordinateur seulement).
Le bouton enregistrer sauve la modification (sur le serveur) et la rend accessible a tous.
Pour se familiariser avec ce système la page bac à sable permet de faire des essais sans aucun risque.
Les règles
Comme pour tout site de type wiki, la qualité repose sur la responsabilité et le bon sens de chacun. Ces règles en sont issue et sont donc proposées pour rendre cette notice encore plus agréable et efficace :
- Des recommandations sont exprimées afin de tendre vers une documentation toujours plus claire et homogène. Elle sont notamment issue d'une réunion qui a eut lieu en 2006 1).
- Un code de conduite (http://doc.ubuntu-fr.org/codedeconduite) est issue du site anglais, induit par les principes d'ubuntu (Il se rattache notamment à la philosophie du même nom Ubuntu (idéologie)).
Principes de base
Il ressort de l'expérience commune quelques principes élémentaires représentatifs de l'état d'esprit recherché :
- Rester aussi simple que possible : Cette notice a comme ambition de pouvoir s'adresser à tous.
- Distinguer les faits : Ce sont eux qui vont aider l'utilisateur. Un choix, une préférence, ou une recommandation sont du domaine des avis, Pour obtenir un fait il faut préciser selon qui.
- Commencer par la bases : Ce qui est évidents est important. C'est la première marche indispensable pour les plus novices, mais aussi ce qui permet organiser facilement les choses plus complexes.
La raison d'être de ces principes peut être exprimées par des métaphore de ce qu'est cette documentation :
- Un pense bête communautaire : Il doit permettre à chacun de retrouver ce qui est utile pour lui, sans gêner ce qui est utile pour les autres.
- Un bagage pour un voyage vers l'inconnu : Les choses les plus utiles doivent rester les plus accessibles, mais il faut aussi prévoir de faire face a des situations qu'on ne connais pas encore.