Cooker doc

Anne · Posted: Mon Jan 21, 2008 1:00 pm Post subject: Cooker doc

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 Smile

. Inscrivez-vous à la mailing-list doc@mandrivalinux.org (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 · Posted: Mon Jan 21, 2008 2:19 pm Post subject:

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 Smile

)

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 Wink

Anne · Posted: Mon Jan 21, 2008 2:59 pm Post subject:

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 · Posted: Mon Jan 21, 2008 8:41 pm Post subject:

Je trouve l'idée séduisante.
Sera-t-il possible de rétro-porter certaines doc dans le wiki ?

Anne · Posted: Mon Jan 21, 2008 8:51 pm Post subject:

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 · Posted: Mon Jan 21, 2008 9:07 pm Post subject:

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 Laughing

)

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.
_________________
Président de l'AUFML / President of French-speaking Mandriva users association
l'AUFML
http://identi.ca/goom

Fredxx · Posted: Tue Jan 22, 2008 10:47 am Post subject:

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
_________________
Vice-Président de l'AUFML (Association des Utilisateurs Francophones de Mandriva Linux) | fredxx AT jabber-fr POINT net

prosper3 · Posted: Tue Jan 22, 2008 2:52 pm Post subject:

Posté sur le site de Magnum (http://magnum.tuxfamily.org/)
_________________
--Sebastien
sebo AT jabber.nuxo.net
mandriva@chat.jabberfr.org
Le site magnum: http://www.mandrivafr.org/

Hall Maney · Posted: Wed Jul 02, 2008 11:27 pm Post subject:

Je ne peux pas télécharger ces fichiers ... Je ne sais pas pourquoi

pamputt · Posted: Thu Jul 03, 2008 5:43 am Post subject:

lebarhon · Posted: Thu Jul 03, 2008 6:14 pm Post subject:

Inscrit !
_________________
Athlon 64 3500+ - VIAK8T800Pro - 2048 DDR - Nvidia FX 5200

.:Spip:. · Posted: Sat Jul 05, 2008 7:21 am Post subject:

roudoud0u · Posted: Sun Jul 06, 2008 1:56 pm Post subject:

excellentes questions de .:Spip:. je trouve Smile

a+

.:Spip:. · Posted: Tue Jul 08, 2008 8:23 pm Post subject:

Personne ne peut me répondre ? ou personne n'ose ? Laughing

je plaisante
_________________
http://sciunto.wordpress.com/

Anne · Posted: Mon Aug 04, 2008 2:36 pm Post subject:

Nous disposons d'une base extremement riche de documentation non à jour qui mérite d'être reprise. L'utilisation des outils utilisés par cooker-i18n permet la traduction facile en un nombre de langues substantiel. Le projet cooker-doc permet à toutes les communautés Mandriva. Aujourd'hui il y a pas mal de doc éparpillée sur le wiki et ca reste extremement problématique. On nous a fait également la demande de traductions sans pour autant soutenir un wiki à part entière pour une langue donnée.
_________________
Mandriva engineering director