Archive:Fr FR/ProjetDocs/EcrireBrouillons

Formats de fichiers préférés
Les formats de fichiers suivant sont recommandé pour les brouillons et sont facile à manipuler avec:


 * DocBookXML: utilisez le fichier  dans le CVS du Projet Documentation.
 * Texte brut
 * OpenOffice Writer, sauvegardez au format DocBook (voir  cette page  pour plus d'information sur l'utilisation de Writer)

Utilisez le format et l'outil que vous trouvez le plus pratique. Consultez le Guide de la Documentation pour plus d'informations sur l'utilisation de XML, Docbook et CVS.

Structure des documents
Si vous choisissez d'écrire votre brouillon au format DocBook, utilisez le fichier  du CVS comme point de départ. Chaque tutoriel devra commencer avec une introduction contenant les sections suivantes:


 * Introduction
 * Objectif - ce que le document permettra au lecteur d'accomplir.
 * Audience - A qui s'adresse ce document (les compétence et intérêts de vos lecteur).
 * Ressources additionnelles - les pages et   appropriés, la documentation en rapport se situant dans , sur les système Fedora et les sites Internet.

Inclure ces sections dans votre brouillon aidera également les autres membres du Projet à vous fournir des réaction plus pertinentes.

La seconde section de votre brouillant devra inclure une brève partie expliquant les concepts techniques que vous utiliserez tout au long du document. Par exemple, le tutoriel Gérer les programmes avec Yum comporte les sections Concepts suivantes:


 * Concepts
 * About Packages
 * About Repositories
 * About Dependencies
 * Understanding Package Names

Établir les concepts technique au début du document vous permettra de vous focaliser sur les tâches que le lecteur aura à accomplir. Réutilisez les sections "about" de document déjà publié (si il existent) - ceci est tout à fait acceptable et vous épargnera un travail inutile. Le reste des sections sont le corps du tutoriel. Les documentations Fedora sont orienté tâches, donc chaque section devra être concentrée sur une tâche ou une activité particulière.

Style d'écriture
Il y a un ensemble de règles en cours d'élaboration sur le Wiki : DocsProject/StyleGuide.

Soyez certain d'avoir lu et compris les section les fondamentaux de la documentation technique et sur la composition  dans le Guide de la Documentation. Les éditeurs peuvent vous aider, mais le processus sera plus rapide si vous suivez ces instructions.

Soumission de votre brouillon
Une fois que vous voulez soumettre votre document pour relecture, envoyez un message sur la liste de diffusion avec comme sujet "Request for Review: nom_de_votre_document". Le corps de votre message devra contenir un lien vers une copie en ligne de votre brouillon.Si vous êtes également capable de fournir une version HTML, faite le, cela permet de toucher plus de monde pour la lecture et de recevoir plus de commentaires.

Si votre document fait plus de 1Mo spécifiez la taille dans votre message, pour le respect des utilisateurs de connections bas débit.