[Anne]

Bonjour

Comme nous pensons que la documentation est un élément majeur de la qualité d'une distribution et qu'elle fournit une valeur ajoutée certaine, particulièrement aux débutants, nous avons réfléchi à la meilleure manière d'améliorer la situation actuelle. Nous disposon déjà d'une documentation de bonne qualité, fournie sous forme de rpm et d'aide en ligne dans l'installeur et les outils Mandriva. C'est lé résultat de l'excellent travail fourni par Neodoc notre partenaire qui a la charge de releaser cette documentation et fournir les traductions.

L'objectif est de rendre cette documentation plus visible et benéfique pour les utilistauers Mandriva mais aussi de la mettre à jour et la traduire. Un autre objectif pour être de développer le nombre de sujets traités, mettre à jour les chapitres obsolètes ou non maintenus.

C'est pourquoi nous souhaitons lancer Cooker doc. Tout comme son pendant pour le développement, Cooker doc doit permettre à chacun de contribuer de différentes manières : écrire de nouveaux chapitres, améliorer/mettre à jour l'existant, traduire, relire... Pour organiser ce projet, nous mettons en place un comité de rédaction composé de membres de Mandriva, Neodoc et de la Communauté. Neodoc continuera à avoir une place particulière dans la réalisation de la documentation, particulièrement dans la documentation en ligne. Ils auront également un role majeur dans l'animation du projet au regard de leur expérience.

Si vous êtes intéressé par ce projet, alors n'hésitez pas . Inscrivez-vous à la mailing-list (pour s'enregistrer : https://ml.mandriva.net/wws/subscribe/doc). Ce projet ne fait que démarrer, rejoindre cette liste vous permettra de participer aux discussions, nous mettrons à jour prochainement le wiki en prenant en compte le résultat de ces discussions.

Amicalement
_________________
Mandriva engineering director

[baud123]

Les archives de la ML sont disponibles sur https://ml.mandriva.net/wws/arc/doc (cliquer sur le bouton I'm not a spammer)

Ces archives font allusion au dépôt subversion (svn), visualisable via http://svn.mandriva.com/cgi-bin/viewvc.cgi/doc/trunk/Distrib/fr/ (pour le français par exemple)
et http://svn.mandriva.com/cgi-bin/viewvc.cgi/doc/trunk/Distrib/ pour l'ensemble des langues gérées (allemand, anglais, espagnol, français, italien, polonais, portugais, portugais/brésilien, russe et j'en oublie).
Chaque section est en xml (Docbook a priori) et ensuite rassemblée comme indiqué dans le README afin de générer automatiquement les documents PDF ou pages HTML.

Tel que je le comprends le projet propose une organisation, pas forcément besoin de focaliser sur les outils (même si il vaut mieux connaître l'existant).

A ce jour, cette documentation est mise en avant sur la page http://club.mandriva.com/xwiki/bin/view/KB/Mandriva_Linux_2008_documentation et disponible dans les paquets mandriva-doc comme le montre Sophie
=> tout le monde connaissait-il déjà cette documentation ? (et l'a lu au moins une fois j'espère )

Il avait été question de bénéficier de cette documentation pour le wiki mandriva http://wiki.mandriva.com (à voir s'il y a un convertisseur vers mediawiki), resterait à déterminer le moyen simple d'enrichir la documentation, soit avec les outils actuels soit avec de nouveaux.

Comme dit plus haut, pas forcément besoin de réclamer de nouveaux outils, autant que chacun prenne connaissance de cette documentation s'il ne l'a pas déjà fait, en fasse profiter le maximum de personnes (pour leur faire découvrir au besoin), les retours et utilisations possibles viendront d'eux-mêmes àmha. Indication : pour ceux qui voudraient démarrer immédiatement, le Docbook n'est pas très compliqué et très orienté documentation technique comme indiqué sur wikipedia

Bonne lecture et propositions d'idées

[Anne]

Ce que nous allons ajouter :

- un howto plus orienté pour aider les participants
- un peu de formation
- un outil de suivi du projet de documentation : suivi des traductions et attribution des taches de redaction/relecture...
- facilitation de l'édition de fichier de traduction
- mise à disposition html donc indexee des versions stables et cooker de la documentation avec un moteur de recherche
- et surtout de l'animation
_________________
Mandriva engineering director

[deap]

Je trouve l'idée séduisante.
Sera-t-il possible de rétro-porter certaines doc dans le wiki ?
_________________
Avez-vous cherché sur le wiki ?
Rapportez votre bug en anglais (c'est mieux) ou en français !

[Anne]

Si certains d'entre vous le souhaite c'est possible mais nous nous orientons vers un système basé sur svn, plus facile à utiliser pour gérer le versioning
_________________
Mandriva engineering director

[goom]

Je me suis inscrit, presque plus histoire de savoir ce qui va se dire que pour vraiment participer à fond (parce que sinon je ne dors plus )

Ceci dit j'espère qu'il y aura aussi des «débutants» pour apporter un oeil neuf, une vision de ce qu'un débutant peut attendre en matière de documentation.
_________________
Téléchargez maintenant Mag'num n°3
jabber :
http://wiki.mandriva.com/fr/Accueil

[Fredxx]

J'en profite pour préciser que Mandriva a demandé à l'asso MAGNUM de l'aider à diffuser très largement cette info sur le web. La doc est totalement ouverte, il faut donc le faire savoir !
Que vous soyez de MAGNUM ou pas, le résultat est le même, il faut le faire savoir et poster partout.

merci
_________________
http://www.reachsummit.com/FR/ | Le Vade Mecum | fredxx AT jabber-fr POINT net

[prosper3]

Posté sur le site de Magnum (http://magnum.tuxfamily.org/)
_________________
--Sebastien
sebo AT jabber.nuxo.net

Le site Mag'Num: http://magnum.tuxfamily.org
Téléchargez maintenant Mag'num n°3 !