pt
Moulé à la louche depuis 1999
Les trucs qui m'énervent... et je vais pas prendre de pincettes
Internet, informatique, logiciel libre, économie, politique, vie courante et tout le reste...

:-) Satisfaction du jour

Lundi 15 septembre 2008

J'ai pris l'habitude - quand j'arrive à régler un problème sur ordinateur - de faire une petite documentation et de la publier (sur mon site ou sur CCM). Déjà parceque ça me permet de résoudre plus facilement le problème s'il se re-présente, mais aussi parce que ça peut potentiellement aider d'autres personnes.

Je dis potentiellement, parceque souvent on se dit que la probablité que ça intéresse quelqu'un d'autre frise le zéro absolu. Et on se trompe.

Exemple: Ma page qui explique comment compiler des extensions C/C++ pour Python sans utiliser de compilateur Microsoft. Oui j'imagine bien que c'est du chinois pour la plupart d'entre vous, et franchement, j'étais certain que ça n'intéresserait personne à part moi.

Erreur !... ma page est citée dans presque tous les groupes de discussion Python, les forums et - comble de satisfaction - même mentionnée dans la dernière édition du livre "Python Cookbook" chez les prestigieuses éditions O'Reilly (ça fait plaisir).

Ne sous-estimez jamais la valeur d'une documentation, si petite soit-elle. Même si vous la jugez incomplète, imprécise, trop courte, insignifiante ou trop spécialisée, publiez-la. Elle aidera forcément quelqu'un un jour ou l'autre.

Aucune contribution n'est insignifiante. C'est quelquechose que les nouveaux contributeurs (Wikipedia, CCM...) ont du mal à saisir, et qui les fait souvent hésiter. Foncez ! Pas grave si vous faites des erreurs. Personne n'est parfait. Il y aura sûrement des internautes qui vous aideront à corriger vos erreurs. Et vous pourriez même apprendre des choses en même temps.

Non seulement publier des articles vous obligera à formaliser ce que vous pensez et clarifier vos idées, mais en plus cela aidera d'autres internautes et vous apprendrez de nouvelles choses grâce aux internautes qui corrigeront vos erreurs et complèteront votre article.