Hmm... Un petit lien que j'ai oublié :-)
https://developer.mozilla.org/en-US/docs/Project:MDN/Contributing
Le 05/06/2013 16:10, David Bruant a écrit :
Bonjour,
J'ai reçu un message de quelqu'un qui souhaite contribuer à la doc et
qui était un peu hésitant sur le fait de faire certaines
modifications. Ca m'est arrivé de répondre à quelques mails comme ça,
donc je voudrais prendre le temps de formaliser un peu cette question
et la soumettre à une audience plus large.
Ce que j'écris s'applique à la doc, mais je pense s'applique aussi à
d'autres parties de Mozilla et sûrement à beaucoup d'autres projets
open source.
# De l'hésitations à prendre une décision
En règle général, on manque cruellement de gens pour la doc (française
ou anglaise). Donc il n'y a aucune raison à hésiter. Comme disait
l'excellente Grace Hopper : "It's easier to ask forgiveness than it is
to get permission."
Si vous faites quelque chose de bonne foi, personne ne viendra vous
casser les pieds, même si ce que vous faites est imparfait ou qu'il
reste des erreurs. On est dans un contexte ou on préfère des
contributions maladroites à pas de contributions. Se tromper est aussi
l'occasion d'apprendre et faire mieux la fois suivante.
Je crois que Jérémie Patonnier est l'exemple le plus parfait de
contributeur qui fait des erreurs à longueurs de temps. La catastrophe
de son orthographe est légendaire (en français et anglais). Pour
autant, tout le monde s'en tape. Il écrit du contenu d'une qualité
incroyable [1] (un exemple parmi tant d'autres). D'autres passerons
après pour corriger les fautes, c'est pas grave ! Ca sert à ça le
travail d'équipe !
On a tendance à penser une croissance du nombre de contributeurs comme
une croissance "horizontale" de la production. J'ai plutôt tendance à
penser que les contributeurs font des "couches" ("verticales") de
contributions, les uns par-dessus des autres, ajoutant un peu plus de
qualité au travail de la couche précédente (ça marche pareil pour le
code).
Abandonnez l'idée de faire une contribution parfaite. Mieux, acceptez
à l'avance que vous ferez des erreurs ; ça permet de mieux accepter
quand quelqu'un vous fait un retour pour vous expliquer
# Importance de communiquer son intention
J'encourage à "demander pardon plutôt que la permission", mais
j'ajoute un petite nuance. La documentation est une ressource commune
et nos efforts doivent être partagés et doivent aller dans la même
direction pour qu'on soit efficace collectivement. Il est donc
important de communiquer nos intentions quand on fait des changements
assez majeurs.
Si c'est des changements à petites échelle (corriger des fautes,
ajouter des liens entre les pages, ajouter un paragraphe ou un
exemple, créer une page...), pas besoin de le dire. Faites-le, ça sera
dans l'historique de la page et on vous retrouvera si on a des questions.
Si c'est des changements moyens (changements à une page d'accueil
comme [2], réorganisation majeur de pages à assez haut traffic, etc.),
vous pouvez le faire, mais ça vaut le coup de balancer un petit email
sur dev-mdc [3] a posteriori juste pour que les gens soient au courant
et puissent réagir si vraiment vous avez fait quelque chose de zarb.
Si c'est un changement majeur (changer de convention pour
l'organisation des pages, etc.), parlez-en a priori. En général, les
changements majeurs sont rares, donc si les choses sont comme elles
sont, soit il y a une bonne raison, soit on est en train de les
changer (ce qui est le cas pour la doc qui subit actuellement, une
bonne réorganisation). Envoyer un message pour poser une question et
faire une proposition est la meilleure chose à faire.
Lancez-vous ! Laissez des traces pour que les autres soient au courant
de ce qu'il se passe, mais lancez-vous. Si vous faites des erreurs,
personne ne se moquera ou ne vous le reprochera ; toute erreur peut
être corrigée, c'est une des raisons pour laquelle la doc est sur un
wiki.
N'hésitez pas, lancez-vous !
David
[1]
https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Forms/Styling_HTML_forms
[2]
https://developer.mozilla.org/en-US/docs/Web/HTML?redirectlocale=en-US&redirectslug=HTML
[3] https://lists.mozilla.org/listinfo/dev-mdc
_______________________________________________
Moz-fr mailing list
[email protected]
http://mozfr.org/mailman/listinfo/moz-fr
