Pour commencer

  • Raccourci de la révision : Project:Pour_commencer
  • Titre de la révision : Pour commencer
  • ID de la révision : 123736
  • Créé :
  • Créateur : Chbok
  • Version actuelle ? Non
  • Commentaire /* Traduction */ mauvais lien vers la page d'accueil anglaise

Contenu de la révision

{{wiki.template('Éditeurs_Devmo_TOC')}} Cette page est destinée aux utilisateurs de devmo qui désirent contribuer au projet. Elle détaille ce qu'il y a à faire pour devenir contributeur et comment nous aider.

Créez-vous un compte

Créez un compte sur devmo, en suivant les instructions sur la page d'identification. L'utilisation d'un compte permet de combattre le vandalisme et permet de retrouver plus facilement vos contributions (et de vous en donner le crédit).

Inscrivez-vous à la mailing list

Pour qu'on puisse se coordonner comme il faut, inscrivez vous à la mailing-list xulfr.devmo. Voir la page http://xulfr.org/communiquer.php pour savoir comment faire. Il peut également être intéressant de s'inscrire à la mailing-list générale en anglais (voir {{mediawiki.interwiki('en', 'Devmo:Community', 'en:Devmo:Community')}} pour savoir comment évolue le projet en général.

Ce que vous pouvez faire

Traduction ou relecture des documents

Traduction

Pour commencer, lisez la référence des balises wiki pour comprendre comment le balisage se fait. Si vous voulez voir des exemples plus concrets, regardez la Référence du DOM Gecko (cliquez sur le lien Modifier d'une page et observez comment elle est faite, n'enregistrez juste pas les changements à la fin). La référence n'est pas parfaite, mais elle devrait vous donner une idée générale de la façon de faire.

Ensuite, lisez les conventions de nommage. Les noms de page dans ce wiki sont un peu compliqués si vous réalisez un livre complet ou quelque chose de similaire, mais très faciles pour des articles plus petits. À nouveau, regardez comment la référence est organisée pour en avoir une meilleure idée.

Si vous n'avez jamais traduit de documentation technique auparavant, ou simplement pour vous rafraichir la mémoire, lisez attentivement la partie « Style, grammaire et typographie » du Guide de style pour le français de Sun Microsystems. C'est assez long (une vingtaine de pages), mais cela vous évitera de perdre du temps par la suite en levant de nombreuses hésitations. Par ailleurs, sa lecture vous aidera à être plus clair et lisible dans vos articles, tant pour les autres contributeurs qui vous reliront que pour les visiteurs du site.

Maintenant, il convient de choisir votre article. Consultez la page qui indique les tâches que nous considérons comme prioritaires : pages à traduire. Vous pouvez également poursuivre la traduction en cours d'une page, en suivant les consignes décrites ici : Catégorie:Traduction en cours. Assurez-vous que le traducteur précédent n'est pas encore occupé à apporter des changements pour éviter des conflits de version.

Enfin, la meilleure manière est peut-être de choisir un sujet qui vous intéresse personnellement. La chose la plus évidente à faire est de traduire des articles {{mediawiki.interwiki('en', 'Main_Page', 'depuis l\'anglais')}}, langue dans laquelle la documentation est la plus importante.

Cependant, si vous avez plus de facilité dans une autre langue (allemand, espagnol, polonais, néerlandais, etc.) vous pouvez partir de cette base également. Pour voir ce qui existe dans les autres langues, partez de la page d'accueil et cliquez sur la langue de votre choix dans le menu sur le côté. Dans certaines d'entre-elles il n'y a malheureusement pas encore grand chose.

Relecture

Certains documents sont marqués comme étant à relire soit par le traducteur lui même, soit par une autre personne. Le marquage d'un document à relire s'effectue simplement en ajoutant une ligne {{Traduction à relire}} en haut d'une page. Il vous est très facile de participer au projet MDC en choisissant un document parmi la liste des documents à relire.

Rédiger des articles originaux

Là aussi cela peut être très intéressant. Si vous avez écrit un article sur le développement avec ou pour Mozilla, n'hésitez pas à le publier ici. Si vous en avez la possibilité, pensez également à en publier une version en anglais pour faciliter sa traduction vers les autres langues.

Pour créer de nouveaux articles, la procédure est la suivante :

Pour commencer, lisez la référence des balises wiki pour comprendre comment le balisage se fait. Si vous voulez voir des exemples plus concrets, regardez la Référence du DOM Gecko (cliquez sur le lien Modifier d'une page et observez comment elle est faite, n'enregistrez juste pas les changements à la fin). La référence n'est pas parfaite, mais elle devrait vous donner une idée générale de la façon de faire.

Ensuite, lisez les conventions de nommage. Les noms de page dans ce wiki sont un peu compliqués si vous réalisez un livre complet ou quelque chose de similaire, mais très faciles pour des articles plus petits. À nouveau, regardez comment la référence est organisée pour en avoir une meilleure idée.

Si votre contenu est un ajout à une page existante, cliquez simplement sur Modifier sur cette page et ajoutez votre texte en le balisant de votre mieux.

Si votre contenu est nouveau et nécessite une nouvelle page, créez d'abord un lien vers la page à créer depuis votre page utilisateur (cliquez sur votre nom dans la page de navigation), cliquez ensuite sur ce lien pour commencer à écrire. Lorsque c'est prêt, ajoutez les liens de catégorie appropriés en bas de votre page, et il sera automatiquement ajouté dans ces catégories.

Par exemple, si vous voulez ajouter un article intitulé "Une nouvelle approche pour les rollovers en JavaScript", il faut :

1) Vous rendre sur votre page utilisateur et cliquer sur Modifier.

2) Ajouter le titre de l'article à la page, entouré par les balises wiki indiquant un article, comme ceci :

* [[Une nouvelle approche pour les rollovers en JavaScript]]

3) Après avoir cliqué sur Enregistrer, cliquer sur le titre de l'article venant d'être créé, qui devrait amener vers une nouvelle page vide où le contenu peut maintenant être ajouté.

4) Une fois terminé, ajouter une balise de catégorie [[Catégorie:JavaScript:Articles]] en bas de la page.

Après avoir ajouté votre article, vous pouvez le signaler sur la mailing-list. Cela permettra aux autres contributeurs de savoir qu'il y a du nouveau contenu afin d'aider à sa relecture et vérifier qu'il se trouve au bon endroit.

Corriger des erreurs techniques

Si vous avez des connaissances techniques dans un domaine particulier couvert par la documentation, votre expertise sera appréciée si vous pouvez faire une relecture du contenu existant dans le wiki.

Tout le monde fait des erreurs, et personne ne connaît toutes les meilleures manières de tout faire. Plus il y a d'yeux relisant notre documentation du point de vue technique et des meilleurs pratiques, mieux c'est.

Si vous trouvez une page contenant des erreurs techniques ou qui pourrait être améliorée, cliquez simplement sur le lien « Modifier » et changez ce qui devrait l'être. Si vous avez besoin d'aide concernant le balisage, utilisez la référence des balises wiki. Une fois la modification effectuée, enregistrez les changements à l'aide du bouton Sauvegarder.

Les erreurs dans la documentation technique peuvent à la fois venir d'une mauvaise compréhension de l'original anglais ou d'erreurs dans celui-ci. Une fois la correction faite, vérifiez si l'erreur est également présente en anglais à l'aide du lien dans le menu et, le cas échéant, corrigez-y l'erreur ou signalez-la dans la page de discussion correspondante.

Améliorer la qualité des textes

Si vous vous exprimez facilement par écrit et avez une bonne connaissance de la langue, de la grammaire et de l'orthographe, votre expertise peut être utile dans l'édition et l'amélioration de la qualité des textes présents sur ce wiki.

Il arrive que les écrits sur des sujets techniques soient peu lisibles suite à une trop grande concentration sur la précision plutôt que sur le style. Vérifiez bien que les changements que vous apportez ne changent pas la signification des informations techniques communiquées. En cas de doute, n'hésitez pas à poser la question sur la mailing-list ou la page de discussion de l'article.

Si vous trouvez des passages améliorables ou contenant des fautes (de frappe, d'orthographe, de grammaire, de clarté, etc.), cliquez simplement sur le lien « Modifier » et changez ce qui devrait l'être. Une fois la modification effectuée, enregistrez les changements à l'aide du bouton Sauvegarder.

{{ wiki.languages( { "de": "Project:de/Wie_kann_ich_helfen?", "en": "en/Devmo/How_to_Help", "nl": "Project:nl/Hoe_Je_Kan_Helpen", "pl": "Project:pl/Jak_pom\u00f3c", "pt": "Project:pt/Como_Ajudar", "ja": "Project:ja/How_to_Help" } ) }}

Source de la révision

<p>{{wiki.template('Éditeurs_Devmo_TOC')}}
Cette page est destinée aux utilisateurs de devmo qui désirent contribuer au projet. Elle détaille ce qu'il y a à faire pour devenir contributeur et comment nous aider.
</p>
<h3 name="Cr.C3.A9ez-vous_un_compte"> Créez-vous un compte </h3>
<p>Créez un compte sur devmo, en suivant les instructions sur la <a href="Special:Userlogin">page d'identification</a>. L'utilisation d'un compte permet de combattre le vandalisme et permet de retrouver plus facilement vos contributions (et de vous en donner le crédit).
</p>
<h3 name="Inscrivez-vous_.C3.A0_la_mailing_list"> Inscrivez-vous à la mailing list </h3>
<p>Pour qu'on puisse se coordonner comme il faut, inscrivez vous à la mailing-list xulfr.devmo. Voir la page http://xulfr.org/communiquer.php pour savoir comment faire. Il peut également être intéressant de s'inscrire à la mailing-list générale en anglais (voir {{mediawiki.interwiki('en', 'Devmo:Community', 'en:Devmo:Community')}} pour savoir comment évolue le projet en général.
</p>
<h3 name="Ce_que_vous_pouvez_faire"> Ce que vous pouvez faire </h3>
<h4 name="Traduction_ou_relecture_des_documents"> Traduction ou relecture des documents </h4>
<h5 name="Traduction"> Traduction </h5>
<p>Pour commencer, lisez la <a href="Help:fr/R%c3%a9f%c3%a9rence_des_balises_wiki">référence des balises wiki</a> pour comprendre comment le balisage se fait. Si vous voulez voir des exemples plus concrets, regardez la <a href="fr/R%c3%a9f%c3%a9rence_du_DOM_Gecko">Référence du DOM Gecko</a> (cliquez sur le lien Modifier d'une page et observez comment elle est faite, n'enregistrez juste pas les changements à la fin). La référence n'est pas parfaite, mais elle devrait vous donner une idée générale de la façon de faire.
</p><p>Ensuite, lisez les <a href="Help:fr/Nommage_des_pages">conventions de nommage</a>. Les noms de page dans ce wiki sont un peu compliqués si vous réalisez un livre complet ou quelque chose de similaire, mais très faciles pour des articles plus petits. À nouveau, regardez comment la référence est organisée pour en avoir une meilleure idée. 
</p><p><b>Si vous n'avez jamais traduit de documentation technique auparavant</b>, ou simplement pour vous rafraichir la mémoire, lisez attentivement la partie « <i>Style, grammaire et typographie</i> » du <a class="external" href="http://frenchmozilla.sourceforge.net/FTP/TEMP/guide_stylistique_December05.pdf">Guide de style pour le français</a> de Sun Microsystems. C'est assez long (une vingtaine de pages), mais cela vous évitera de perdre du temps par la suite en levant de nombreuses hésitations. Par ailleurs, sa lecture vous aidera à être plus clair et lisible dans vos articles, tant pour les autres contributeurs qui vous reliront que pour les visiteurs du site.
</p><p>Maintenant, il convient de choisir votre article. Consultez la page qui indique les tâches que nous considérons comme prioritaires : <a href="Project:fr/Pages_%c3%a0_traduire">pages à traduire</a>. Vous pouvez également poursuivre la traduction en cours d'une page, en suivant les consignes décrites ici : <a href="Special:Tags?tag=Traduction_en_cours&amp;language=fr">Catégorie:Traduction en cours</a>. Assurez-vous que le traducteur précédent n'est pas encore occupé à apporter des changements pour éviter des conflits de version.
</p><p>Enfin, la meilleure manière est peut-être de choisir un sujet qui vous intéresse personnellement. La chose la plus évidente à faire est de traduire des articles {{mediawiki.interwiki('en', 'Main_Page', 'depuis l\'anglais')}}, langue dans laquelle la documentation est la plus importante. 
</p><p>Cependant, si vous avez plus de facilité dans une autre langue (allemand, espagnol, polonais, néerlandais, etc.) vous pouvez partir de cette base également. Pour voir ce qui existe dans les autres langues, partez de la <a href="fr">page d'accueil</a> et cliquez sur la langue de votre choix dans le menu sur le côté. Dans certaines d'entre-elles il n'y a malheureusement pas encore grand chose.
</p>
<h5 name="Relecture"> Relecture </h5>
<p>Certains documents sont marqués comme étant à relire soit par le traducteur lui même, soit par une autre personne. Le marquage d'un document à relire s'effectue simplement en ajoutant une ligne <b><span class="plain">{{Traduction à relire}}</span></b> en haut d'une page. Il vous est très facile de participer au projet MDC en choisissant un document parmi <a href="Special:Tags?tag=Traduction_à_relire&amp;language=fr">la liste des documents à relire</a>.
</p>
<h4 name="R.C3.A9diger_des_articles_originaux"> Rédiger des articles originaux </h4>
<p>Là aussi cela peut être très intéressant. Si vous avez écrit un article sur le développement avec ou pour Mozilla, n'hésitez pas à le publier ici. Si vous en avez la possibilité, pensez également à en publier une version en anglais pour faciliter sa traduction vers les autres langues.
</p><p>Pour créer de nouveaux articles, la procédure est la suivante :
</p><p>Pour commencer, lisez la <a href="Help:fr/R%c3%a9f%c3%a9rence_des_balises_wiki">référence des balises wiki</a> pour comprendre comment le balisage se fait. Si vous voulez voir des exemples plus concrets, regardez la <a href="fr/R%c3%a9f%c3%a9rence_du_DOM_Gecko">Référence du DOM Gecko</a> (cliquez sur le lien Modifier d'une page et observez comment elle est faite, n'enregistrez juste pas les changements à la fin). La référence n'est pas parfaite, mais elle devrait vous donner une idée générale de la façon de faire.
</p><p>Ensuite, lisez les <a href="Help:fr/Nommage_des_pages">conventions de nommage</a>. Les noms de page dans ce wiki sont un peu compliqués si vous réalisez un livre complet ou quelque chose de similaire, mais très faciles pour des articles plus petits. À nouveau, regardez comment la référence est organisée pour en avoir une meilleure idée.
</p><p>Si votre contenu est un ajout à une page existante, cliquez simplement sur Modifier sur cette page et ajoutez votre texte en le balisant de votre mieux.
</p><p>Si votre contenu est nouveau et nécessite une nouvelle page, créez d'abord un lien vers la page à créer depuis votre page utilisateur (cliquez sur votre nom dans la page de navigation), cliquez ensuite sur ce lien pour commencer à écrire. Lorsque c'est prêt, ajoutez les liens de catégorie appropriés en bas de votre page, et il sera automatiquement ajouté dans ces catégories.
</p><p>Par exemple, si vous voulez ajouter un article intitulé "Une nouvelle approche pour les rollovers en JavaScript", il faut :
</p><p>1) Vous rendre sur votre page utilisateur et cliquer sur Modifier.
</p><p>2) Ajouter le titre de l'article à la page, entouré par les balises wiki indiquant un article, comme ceci :
</p>
<pre>* [[Une nouvelle approche pour les rollovers en JavaScript]]
</pre>
<p>3) Après avoir cliqué sur Enregistrer, cliquer sur le titre de l'article venant d'être créé, qui devrait amener vers une nouvelle page vide où le contenu peut maintenant être ajouté.
</p><p>4) Une fois terminé, ajouter une balise de catégorie <span class="plain">[[Catégorie:JavaScript:Articles]]</span> en bas de la page.
</p><p>Après avoir ajouté votre article, vous pouvez le signaler sur la mailing-list. Cela permettra aux autres contributeurs de savoir qu'il y a du nouveau contenu afin d'aider à sa relecture et vérifier qu'il se trouve au bon endroit. 
</p>
<h4 name="Corriger_des_erreurs_techniques"> Corriger des erreurs techniques </h4>
<p>Si vous avez des connaissances techniques dans un domaine particulier couvert par la documentation, votre expertise sera appréciée si vous pouvez faire une relecture du contenu existant dans le wiki.
</p><p>Tout le monde fait des erreurs, et personne ne connaît toutes les meilleures manières de tout faire. Plus il y a d'yeux relisant notre documentation du point de vue technique et des meilleurs pratiques, mieux c'est.
</p><p>Si vous trouvez une page contenant des erreurs techniques ou qui pourrait être améliorée, cliquez simplement sur le lien « Modifier » et changez ce qui devrait l'être. Si vous avez besoin d'aide concernant le balisage, utilisez la référence des balises wiki. Une fois la modification effectuée, enregistrez les changements à l'aide du bouton Sauvegarder.
</p><p>Les erreurs dans la documentation technique peuvent à la fois venir d'une mauvaise compréhension de l'original anglais ou d'erreurs dans celui-ci. Une fois la correction faite, vérifiez si l'erreur est également présente en anglais à l'aide du lien dans le menu et, le cas échéant, corrigez-y l'erreur ou signalez-la dans la page de discussion correspondante.
</p>
<h4 name="Am.C3.A9liorer_la_qualit.C3.A9_des_textes"> Améliorer la qualité des textes </h4>
<p>Si vous vous exprimez facilement par écrit et avez une bonne connaissance de la langue, de la grammaire et de l'orthographe, votre expertise peut être utile dans l'édition et l'amélioration de la qualité des textes présents sur ce wiki.
</p><p>Il arrive que les écrits sur des sujets techniques soient peu lisibles suite à une trop grande concentration sur la précision plutôt que sur le style. Vérifiez bien que les changements que vous apportez ne changent pas la signification des informations techniques communiquées. En cas de doute, n'hésitez pas à poser la question sur la mailing-list ou la page de discussion de l'article.
</p><p>Si vous trouvez des passages améliorables ou contenant des fautes (de frappe, d'orthographe, de grammaire, de clarté, etc.), cliquez simplement sur le lien « Modifier » et changez ce qui devrait l'être. Une fois la modification effectuée, enregistrez les changements à l'aide du bouton Sauvegarder.
</p>{{ wiki.languages( { "de": "Project:de/Wie_kann_ich_helfen?", "en": "en/Devmo/How_to_Help", "nl": "Project:nl/Hoe_Je_Kan_Helpen", "pl": "Project:pl/Jak_pom\u00f3c", "pt": "Project:pt/Como_Ajudar", "ja": "Project:ja/How_to_Help" } ) }}
Revenir à cette révision