Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
wiki:ameliorer_wiki [Le 20/02/2007, 16:33] 128.178.110.66 |
— (Version actuelle) | ||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| - | {{tag>wiki}} | ||
| - | ====== Comment proposer des améliorations pour clarifier cette documentation ? ====== | ||
| - | |||
| - | La documentation du site Ubuntu-fr est publiée sous forme de wiki, un système ouvert et collaboratif dans lequel tout un chacun peut apporter sa pierre à l'édifice. Il est rédigé sur une base volontaire, bénévole par les utilisateurs-mêmes d'Ubuntu et d'autres logiciels. | ||
| - | |||
| - | Évidemment, cette documentation ne peut pas être totalement parfaite. Il y a toujours place à l'amélioration. Mais comment participer à l'élaboration de cette documentation quand on n'a ni le temps, ni la patience, ni la facilité, ni la technique, ni les connaissances pour écrire un tutoriel ou un article ? De plus, il est vrai que la plupart des contributeurs à cette documentation sont des utilisateurs plus expérimentés, pour qui certaines manipulations semblent être "toutes naturelles", ce qui rend des documents moyennement clairs ou intuitifs. Que faire alors pour simplifier la documentation, ou proposer des améliorations quand un article n'est pas clair ? | ||
| - | |||
| - | ===== Expliquer ce qui doit être amélioré ===== | ||
| - | Mettons tout de suite quelque chose au clair : tous les contributeurs seront ravis de recevoir des critiques de leurs contributions et seront heureux d'apporter clarification et simplification à leurs articles. Mais dire uniquement //"Cet article est compliqué"// ne mène à rien. L'important pour que le contributeur sache comment améliorer et clarifier un tutoriel est **la justification** : | ||
| - | * En quoi est-il compliqué ? (mise en page houleuse ou ne suivant pas une logique début-fin ? terminologie employée peu claire ? phrases mal construites ? article trop long regroupant trop d'informations ? etc.) | ||
| - | * Quelles parties sont peu claires, et pourquoi ? (Tout n'est probablement pas à jeter ; qu'est-ce qui est bien dans l'article ? Ça peut donner une idée de pistes d'améliorations...) | ||
| - | * Avez-vous des idées, des pistes pour améliorer l'article ? | ||
| - | * ... | ||
| - | Bref, ne pas simplement dire que l'entièreté du wiki n'est pas clair, mais d'expliquer aux contributeurs quels éléments doivent être repris, pourquoi et comment les reprendre. Comme nous l'avons dit, la plupart des contributeurs à cette documentation sont des utilisateurs plus expérimentés, pour qui certaines manipulations semblent être "toutes naturelles" et qui ont adopté un vocabulaire adapté à l'environnement informatique ; il peut leur être difficile de bien se mettre dans la peau du néophyte. La justification d'une critique d'article aide énormément à se //nioubizer//. ;-) | ||
| - | |||
| - | |||
| - | ===== Comment faire part de mes critiques ? ===== | ||
| - | La procédure choisie durant [[:evenements:reunion4_2007_compte_rendu|la réunion 2006 #3]] pour notifier les contributeurs des améliorations à apporter est de modifier directement la page et d'indiquer aux endroits appropriées : //"Ce passage n'est pas clair, il mérite révision"//. Les personnes inscrites suivant la page seraient avisées immédiatement de la modification, verraient en quoi elle consiste et pourraient effectuer les actions nécessaires. Toutefois, à l'heure actuelle, le système de notification des modifications par page ne semble pas fonctionner ; aussi cette technique devrait sans doute être 'laissée sur la glace', le temps que le tout se mette en place. | ||
| - | |||
| - | * Beaucoup d'articles sont signés par leur(s) auteur(s), en bas d'article. Beaucoup de contributeurs possèdent leur page de présentation personnelle où l'on peut les contacter directement (voir la [[:utilisateurs:liste|liste des utilisateurs]]). Ainsi, contacter directement le contributeur en expliquant que son document //X// devrait être retravaillé dans telles sections car ceci ou cela est obscur (et de dire en quoi cela est obscur), c'est un moyen efficace pour voir ses remarques prises en compte et de voir apportées des modifications à l'article. | ||
| - | * Les plus téméraires voudront peut-être aussi s'abonner à [[:liste_diffusion#coordination_wiki|la liste de diffusion des contributeurs du wiki]] //(Coordination Wiki)//. Ils pourront ainsi discuter par courriel avec plusieurs contributeurs du wiki, leur présenter quels articles ils jugent difficiles et qui mériteraient une refonte. Bref, travailler en coopération avec ceux-là mêmes qui rédigent la documentation ! | ||
| - | * Enfin, il est toujours possible de [[http://forum.ubuntu-fr.org|créer un fil de discussion dans le forum]] à propos d'un article précis. Quelques-uns des contributeurs au wiki passent aussi dans le forum, mais pas tous. Néanmoins, un fil de discussion aura le mérite d'attirer l'attention de personnes moins connaisseuses, de celles-là mêmes qui vont utiliser le wiki qui pourront réagir aux propositions, et peut-être aussi de futurs contributeurs ? Mais comme nous l'avons mentionné, tous les contributeurs ne passent pas dans le forum, donc il faudra aussi penser à les contacter pour qu'ils puissent appliquer les modifications nécessaires si personne ne s'en charge.((Si quelqu'un apporte directement une contribution, elle devra alors suivre [[:wiki:participer_wiki|les instructions données aux contributeurs]].)) | ||
| - | |||
| - | La documentation d'Ubuntu-FR n'est peut-être pas toujours tout à fait claire, et c'est bien normal. Elle est en constante évolution et rédigée sur une base volontaire. La meilleure façon de la voir devenir meilleure est de la critiquer (de manière constructive) et d'informer de ses observations ! | ||