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
