FR/Documentation/Contribuer
Contribuer au projet Apache OpenOffice
Chez Apache OpenOffice, les nouveaux collaborateurs sont toujours les bienvenus. Peu importe votre niveau d'expérience, vous pouvez apporter une contribution de valeur à la documentation. Voici quelques façons de contribuer : écrire, réviser, éditer, rechercher ou illustrer. Voir comment puis-je aider. Plus bas.
 |
Pour participer, vous devez d'abord avoir l'esprit d'initiative. Nous pouvons vous expliquer comment utiliser le site Web et le Wiki, comment appliquer nos procédés, etc. mais nous n'assignons aucune tâche, ni n'agissons comme mentors en matière de pratique et de compétences en rédaction technique. Nous serions heureux de vous l'enseigner mais nous n'avons tout simplement ni le temps, ni les compétences pour le faire. En général, nous vous pouvons vous dire ce qui est à faire mais c'est à vous de choisir quoi faire et ensuite de le faire. |
Pour commencer
- Joindre la liste de diffusion francophone ou s'inscrire sur forum selon vos intérêts.
- Poser vos questions sur la liste de diffusion ou le forum si vous n'êtes pas sûr de savoir comment faire quelque chose.
Tâches hautement prioritaires
- Effectuer des recherches afin de déterminer quelles questions (tirées des forums) pourraient faire l'objet d'une documentation (via des Comment-Faire ou encore être couvertes par un guide utilisateur).
Tâches courantes
- Traductions entre divers langages
- Nettoyage et conversion des documents de développeurs en Guides officiels de l'utilisateur.
- Nouveaux Comment-Faire. Par exemple, Trucs et Astuces dans Base ou tout autre module. Documents qui n'apparaissent pas dans le guide de l'utilisateur mais qui soient utiles. Par exemple, un Comment-Faire sur la création d'un diagramme de flux avec Draw.
- Autres petits manuels / tutoriels / Comment-Faire spécifiques orientés caractéristiques, orientés tâche ou encore orientés débutants. Voir cette page et liens pour quelques idées.
- Consulter la liste de souhaits pour la documentation].
Contribuer aux Wikis
Cette information peut être périmée par les développements chez Apache OpenOffice.
Il existe deux Wikis au sein du projet.
- Celui sur lequel vous vous trouvez et rassemble la documentation sur le logiciel.
- Le Wiki Confluence (CWiki) sur lequel vous retrouvez des informations sur le projet (annonce, notes de version...)
Les deux sont étanches. Un compte distinct devra être créé si vous souhaitez alimenter l'un ou l'autre.
Wiki OpenOffice
N'importe qui peut contribuer à ce Wiki en suivant cette simple procédure :
Pré-requis
- Souscrire à la liste de diffusion des développeurs à cette adresse : Dev Liste, en mettant simplement en objet "subscribe" (sans les guillemets), vous recevrez un courriel pour confirmer votre adresse.
- Envoyer un courriel à cette adresse :Dev Liste avec en objet Request Mwiki account et dans le texte le pseudo et le nom que vous souhaité utiliser.
- Vous recevrez un courriel de confirmation.
Connexion sur le Wiki
- Connectez-vous avec le compte qui vous a été confirmé par retour depuis la liste des développeurs.
- Lire la politique d'édition du Wiki.
- Naviguer dans le Wiki et choisir un sujet qui vous intéresse. Voir, en particulier, les pages de la catégorie : Documentation/Besoins de révision.
- Éditer la page, effectuer les changements et/ou modifications nécessaires puis sauvegarder.
Si les modifications invoquent une ré-écriture ou tout autre travail majeur, en discuter d'abord via le forum afin de faire savoir à la Communauté ce que vous faites. Un ample travail de réécriture nécessite un certain niveau de coordination et de suivi.
Cwiki
Vous trouverez ci-dessous la procédure pour créer un document dans le Cwiki d'Apache OpenOffice. Vous y trouverez entre autres les Releases Notes des différentes version AOO.
Pré-requis
- S'inscrire sur le site : Cwiki/confluence.
- Souscrire sur la mailing list des développeurs à cette adresse : Dev Liste, en mettant simplement en objet "subscribe" (sans les guillemets), vous recevrez un courriel pour confirmer votre adresse.
- Envoyer un courriel à cette adresse :Dev Liste avec en objet [Cwiki] Account Whitelisting et dans le texte votre pseudo et votre nom utilisés au point 1. Cela vous permettra d'écrire sur le Cwiki. Vous recevrez un courriel de confirmation.
Connexion sur le Cwiki
Se connecter sur le site Cwiki avec vos identifiants définis en A- 1 ci-dessus.
Création d'un document
Comme exemple j'ai pris la création de la Release Note 4.1.3 en français.
Pour créer un document :
Dans la nouvelle page entrer le titre du document exemple : AOO 4.1.3 Release Notes (french), enregistrer et fermer le document.
- Afficher la page anglaise Aoo 4.1.3 Release Notes, depuis l'arborescence à gauche de l'écran
- Clic sur bouton "Modifier",
- Insérer à la fin de la ligne "translations:" un hyperlien vers votre document en français
- Copier l'ensemble du texte en anglais
- Enregistrer.
- Ouvrez votre document
- Passez en mode modification
- Coller le texte en anglais que vous n'aurez plus qu'à traduire (bon courage).
Comment puis-je aider ?
Voici quelques façons d'aider.
Rédiger
Si vous êtes doué pour organiser l'information, expliquer des concepts et en écrire les instructions, vous serez d'une plus grande aide en rédigeant. Idéalement, vous êtes rédacteur technique si vous avez de bonnes compétences en français. Mais aucun de ces idéaux ne sont obligatoires parce que d'autres personnes peuvent corriger votre français. Ou alors, vous pouvez écrire dans une autre langue pour que cela soit ensuite traduit en français.
Réviser
Vous n'avez pas confiance en vos capacités d'écriture ou votre niveau de connaissance concernant Apache OpenOffice ? Un bon moyen de commencer consiste à réviser la documentation (en particulier les documents visant les nouveaux utilisateurs). Est-ce correctement écrit pour les débutants ? Les informations et instructions sont-elles correctes ? Rien ne manque ? Faites-nous savoir ce qui a besoin d'être corrigé ou mieux, corrigez-le vous-même.
Éditer
Parfois appelé "correcteur" bien que les deux ne soient pas la même chose, ils sont amené à modifier l'existant. Ici, vous aurez besoin d'un bon niveau de français. En plus de corriger les fautes et les erreurs, les éditeurs aident à améliorer la lisibilité des documents.
Rechercher
Souvent les écrivains n'ont pas le temps de s'assurer que les documents existants sont complets et à jour. Vous pouvez aider en parcourant les forums et les listes de diffusion pour découvrir les questions des utilisateurs. Est-ce que l'info manque dans nos documents ou bien est-elle juste difficile à trouver? Avons-nous besoin d'une nouvelle Question Fréquente, d'un Comment-Faire ou d'une section dans un guide de l'utilisateur?
Entretenir
Actualiser les pages en fonction des nouvelles diffusions de version pour Apache OpenOffice.
Illustrer
Aider les écrivains en effectuant des captures, découpages et étiquetages de copie d'écran ou encore en créant des diagrammes et tout type d'illustrations visant à améliorer la lisibilité.
Autre
Cette information peut être périmée et dépassée par les développements de Apache OpenOffice.
Nous avons aussi besoin d'aide pour des choses comme :
- Entretien du site web Projet Documentation ;
- Administrer et surveiller les changements effectués sur le Wiki ;
- Concevoir et exporter des livres en utilisant les collections Wiki ;
- Répondre aux questions soulevées dans les pages de discussion Wiki ;
Toutes nouvelles idées sont les bienvenues. Existe-t-il une meilleure façon de faire quelque chose ? Faites-le savoir aux membres de l'équipe de projet.
