vendredi 29 février 2008

Wiki versus Blog / Forum pour la documentation libre

Il serait difficile de reprocher aux systèmes libres leur manque de documentation. Entre les pages de man, les fichiers de conf largement commentés, les verboses modes et autres howto, wiki, blogs, forums, on a affaire a une prolifération de documentation malheureusement pas toujours organisée. Une tendance actuelle est de documenter dans son blog pas mal de choses intéressantes qui serait bien mieux placée dans un wiki. Pourquoi écrire de la doc technique dans un wiki plutot qu'un blog ou une page perso ?
  • le wiki est maintenu par une communauté, ce qui fait que sa pérennité est plus assurée sur le long terme qu'un blog qui depend de votre bon vouloir ou de celui de votre hebergeur.
  • le wiki est modifiable par quelqu'un d'autre a commencer par vous meme, contrairement par exemple a de nombreux forums en lignes qui ne permettent pas de reéditer vos propres posts
  • pourquoi ne pas s'essayer des maintenant a une expérience de travail collaboratif plutôt que de faire les choses dans son coin ?
Il y a cependant deux obstacles a l'utilisation du wiki en general.
Le premier est que la plupart du temps un contributeur de wiki reste anonyme par rapport a un auteur de blog qu'on peut contacter directement pour signaler une erreur ou demander une explication. Le deuxième est que la contribution a un wiki étant bien plus anonyme qu'un beau blog ou l'avatar personnalisé d'un forum, la "part de gloire" de l'auteur est bien moindre. Je connais plusieurs blogs techniques incluant des tutoriels bien detailles, dont je peux citer le nom de l'auteur, mais je serais bien en peine de citer le nom d'un contributeur Wikipedia

Le projet Knol de Google est supposé résoudre ces deux problèmes en associant chaque article de sa base de connaissance a un auteur clairement identifie, qui pourra se remunerer en plaçant des google ads sur son article. Outre le problème qu'un moteur de recherche s'occupe maintenant de generer du contenu, il existe une facon beaucoup plus simple d'identifier vos contributions.
Il suffit d'annoncer sur votre blog/forum préféré les articles que vous avez écrits, et en indiquant votre nom/pseudo et votre email dans l'entête de votre article wiki ( comme le font par exemple certains membres de gcu, suivre les liens tips )

En conclusion pour documenter quelque chose, le mieux serait de commencer essayer de l'inclure dans la documentation officielle de son système ou dans un wiki et enfin d'utiliser son blog/forum/page perso pour des astuces courtes ne depassant pas quelques lignes.

Aucun commentaire: