Le blog d'Olivier FAURAX
Cooker doc : contribuer sans être informaticien !
Ajouté le mardi 22 janvier 2008 à 23h31 /
informatique
logiciels libres
mandriva
faurax
Vous lisez régulièrement sur ce blog des nouvelles sur la liste de diffusion Cooker, qui est aussi le nom de la version de développement de Mandriva Linux.
Anne (de Mandriva) a lancé le projet Cooker doc pour améliorer, traduire et faire évoluer la documentation existante. Jusqu'à maintenant, elle a été rédigée principalement par NeoDoc, qui va s'occuper d'animer le projet. La documentation est disponible en paquet installable sur la distribution ou en HTML et PDF sur le club (gratuit, je le rappelle).
Le but de ce projet de fédérer une communauté pour ajouter de nouveaux
chapitres tout en la traduisant dans plusieurs langues.
C'est l'occasion de participer à Mandriva lorsqu'on n'est pas
informaticien.
- Liste de diffusion sur la documentation
- Annonce originale : http://forum.mandriva.com/viewtopic.php?t=78916
- Dans le SVN : Sources de la documentation Mandriva
Commentaires (fil RSS
) :
# francq, le mercredi 23 janvier 2008 à 10h50 :
Bonjour Olivier,
tout d'abord la bonne année à toi !
Ensuite, il paraît que t'as un boulot : où, quand, comment ?
Et ta thèse, comment se profile t'elle ?
A bientôt,
Julien
tout d'abord la bonne année à toi !
Ensuite, il paraît que t'as un boulot : où, quand, comment ?
Et ta thèse, comment se profile t'elle ?
A bientôt,
Julien
# AshLeDombos (Jabber), le mercredi 23 janvier 2008 à 15h27 :
Olivier, si je travaille sur la doc wiki, je n'aurais pas le temps de contribuer à la doc cooker. Mais rien n'empeche de faire des transferts, non ?
# Olivier (Jabber), le mercredi 23 janvier 2008 à 16h28 :
À ce que j'ai compris, Cooker doc concerne la documentation structurée qui est fournie aux débutants.
Le wiki a une vocation un peu plus large, je pense, comme par exemple pour la documentation technique des outils Mandriva ou des choses plus spécifiques qu'on ne va pas forcément mettre dans la doc Mandriva qui accompagne le powerpack (ex: tutorial RPM, Fstab).
Et pour dire clairement ce que je pense, la plupart des pages du wiki ne sont pas de qualité suffisante. Le style de certains articles est bizarre et personne n'a jamais défini de ligne éditoriale pour que les articles deviennent homogènes.
Dans la pratique, rien n'empêche les transferts, sauf qu'il faut transcrire du DocBook vers la syntaxe mediawiki (ou inversement).
Le wiki a une vocation un peu plus large, je pense, comme par exemple pour la documentation technique des outils Mandriva ou des choses plus spécifiques qu'on ne va pas forcément mettre dans la doc Mandriva qui accompagne le powerpack (ex: tutorial RPM, Fstab).
Et pour dire clairement ce que je pense, la plupart des pages du wiki ne sont pas de qualité suffisante. Le style de certains articles est bizarre et personne n'a jamais défini de ligne éditoriale pour que les articles deviennent homogènes.
Dans la pratique, rien n'empêche les transferts, sauf qu'il faut transcrire du DocBook vers la syntaxe mediawiki (ou inversement).
# AshLeDombos (Jabber), le jeudi 24 janvier 2008 à 00h13 :
d'accord avec toi, mais surtout ne pas délaisser le wiki parce que la qualité est insuffisante, et en effet une ligne éditoriale serait une bonne chose
