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.
Comme pour tout site de type wiki, la qualité repose sur la responsabilité et le bon sens de chacun, bien qu'il existe un état d'esprit associé à la technique utilisé.
Enfin, pour que le travail commun soit plus efficace des recommandations sont exprimées, et il est demandé de les suivre afin de tendre vers une documentation toujours plus claire et homogène.
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 à tous.
Pour se familiariser avec ce système le page bac à sable permet de faire des essais sans aucun risque.
état d'esprit
Voici différentes façon de présenter à titre indicatif les bases éthiques sur lesquelles repose les mécanisme techniques (d'ubuntu, du site ubuntu-fr et plus précisément de cette documentation) :
- Un code de conduite (issue du site anglais) est induit par les principes d'ubuntu qui se rattachent notamment à la philosophie du même nom. (Voir aussi l'article Ubuntu (idéologie) sur wikipédia et une vidéo représentant ce concept, présente dans la distribution ubuntu et visible ici).
- Il ressort également de l'expérience commune quelques principes élémentaires relatifs à la documentation sous forme wiki :
- 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 d'organiser facilement les choses plus complexes.
- Cette documentation peut aussi être représenté par des métaphores (pour imager autrement les principes précédents) :
- C'est 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.
- C'est aussi 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 à des situations qu'on ne connait pas encore.
Autre aides
- Aide à la syntaxe, pour savoir comment utiliser le langage de mise en forme de ce système wiki.
- playground Littéralement la salle de jeu avec des exemple de mise en forme.