Nos vérificateurs de la base de connaissances sont des contributeurs et du personnel de Mozilla ayant de l'expérience et des compétences dans la rédaction de documentation d'assistance. Comme le dit le titre, cet article traite des directives pour la vérification d'articles en anglais. C'est la version courte (les détails ennuyeux à mourir sont au-dessous de la table des matières) :

Articles les plus vus (plus de 64 000 visites / mois) :

• Pour les mises à jour de contenus existants — vous pouvez approuver toutes les révisions (même les vôtres) dont vous pensez qu'elles améliorent l'article.
• Pour les gros changements — veuillez discuter de ces derniers dans le forum de l'article avant de les approuver. N'approuvez pas vos propres révisions s'il s'agit d'un gros changement.

Autres articles (moins de 64 000 vues / mois) :

• Approuvez toutes mises à jour et gros changements (même les vôtres) dont vous pensez qu'ils améliorent l'article.

Retour d'expérience pour les rédacteurs :
Lors de la vérification, assurez-vous d'inclure un message à l'attention du rédacteur le remerciant pour sa contribution. Si vous ajournez une révision, vous devriez aussi donner un retour personnalisé et constructif sur ce que vous avez senti nécessaire de changer afin que la révision soit acceptable.

Vérification d'articles

Beaucoup de révisions sont faites par des bénévoles mettant à disposition leur temps et leur talent. Lorsque vous discutez du travail que ces personnes ont soumis, supposez que tout le monde a les meilleures intentions et n'oubliez pas de les remercier pour leur contribution. Rappelez-vous, vous pouvez être le premier et le seul contact que cette personne a avec quelqu'un de Mozilla. Veuillez faire en sorte qu'il soit positif.

Articles les plus vus

Nos articles les plus vus (plus de 64 000 visites par mois ; environ 20 articles) représentent environ 50 - 55% de toutes les visites de la base de connaissances. Il est essentiel que ces articles comportent les dernières informations.

• Pour les mises à jour de contenus existants — vous pouvez approuver toutes les révisions (même les vôtres) dont vous pensez qu'elles améliorent l'article.

Parce que les articles les plus vus ont été considérablement modifiés et qu'ils affectent un grand nombre de personnes, les gros changements concernant l'article devraient être préalablement discutés. N'hésitez pas à contacter par message privé les autres rédacteurs de la base de connaissances pour leur demander leur avis. C'est mieux si un consensus peut être trouvé mais cela est parfois difficile à atteindre. Comme toujours, utilisez votre discernement.

• Pour les gros changements — veuillez discuter de ces derniers dans le forum de l'article avant de les approuver. N'approuvez pas vos propres révisions s'il s'agit d'un gros changement.

Autres articles

Les articles avec moins de 64 000 visites par semaine représentent la grande majorité de notre base de connaissances (plus de 200 articles ; 45% - 50% des visites). Ils couvrent moins de problèmes courants et de nouveaux produits. Là, la politique de vérification est plus accommodante.

• Approuvez toutes mises à jour et gros changements (même les vôtres) dont vous pensez qu'ils améliorent l'article.

Nouveaux articles

Lorsque nous créons un article pour la première fois, il n'a absolument aucune visite. Alors comment voulez-vous le considérer ?

• Si l'article est créé dans un but particulier (sortie d'une version mineure de Firefox, avec un lien vers celui-ci depuis un produit ou depuis mozilla.org), traitez-le comme l'un des articles les plus vus.
• Si nous n'avons aucune raison de penser que l'article va être ultra populaire dans l'immédiat, traitez-le comme les autres articles avec moins de 64 000 visites / mois. Si la révision est une amélioration ; approuvez-la. Les articles qui ne sont pas complètement finalisés sont aussi acceptables. Si ce n'est pas l'un des articles les plus vus, il peut commencer à recueillir des avis tout en étant en cours d'élaboration.

Qu'est-ce qu'une mise à jour d'un contenu existant ?

La tâche la plus courante effectuée sur la base de connaissances est de garder les articles à jour. Généralement, cela concerne :

• La correction de l'orthographe et de la grammaire
• La simplification du langage existant, la suppression du jargon
• La mise à jour ou l'ajout de captures d'écran
• La mise à jour ou l'ajout de captures vidéo de l'écran
• La suppression de contenu pour les versions de Firefox pour lesquelles nous ne fournissons plus d'aide
• La mise à jour des instructions pas à pas pour prendre en charge les nouvelles versions de Firefox
• La mise à jour du texte existant pour prendre en charge les changements dans les nouvelles versions de Firefox
• La correction des problèmes avec la syntaxe Wiki
• La correction des liens
• La mise à jour des mots-clés
• L'ajout ou la mise à jour d'un résumé de recherche

Qu'est-ce qu'un gros changement ?

Les gros changements modifient fondamentalement l'article existant. Ils comprennent :

• L'ajout d'une nouvelle section
• La suppression d'une section existante
• La réécriture complète (plus que la simplification du langage existant et la suppression du jargon)
• La réécriture des titres de sections
• La réorganisation de l'ordre des sections
• La modification du périmètre de l'article

Niveaux de révision

Lorsque vous approuvez un article, vous disposez de trois niveaux de révision différents au choix :

• Minor details that don't affect the instructions : Ce sont des changements qui ne modifient pas les instructions pour les utilisateurs. Les localisateurs ne seront pas informés de ces changements, même si vous les marquez « Prêt pour la localisation ».
• Content changes that don't require immediate translation : C'est le choix par défaut. Ce sont des changements significatifs (mises à jour et gros changements) qui n'invalident pas complètement la version précédente de l'article.
• Major content changes that will make older translations inaccurate : C'est pour les rares cas où un article est si mauvais que, sans ces changements, il va causer des problèmes majeurs pour les gens. Cela ajoute une mise en garde sur les articles localisés qui indique que le contenu peut être obsolète et fournit un lien vers la version anglaise.
  
  

Commentaires pour les rédacteurs

Lorsque vous approuvez un article, il est important de remercier le ou les rédacteurs pour sa ou leur contribution. Il est également agréable si vous pouvez leur fournir un retour d'expérience. Ont-ils amélioré leur écriture ? Ont-ils fait un travail particulièrement bon pour expliquer quelque chose de complexe ? Faites-le leur savoir !

Si une révision contient plus qu'une simple erreur, soit un gros changement pour l'un des articles les plus vus qui n'a pas été discuté, soit quelque chose dont vous pensez que ça n'est pas très utile, vous devriez ajourner l'approbation. Mais plutôt que d'être un simple rejet, un ajournement est une opportunité de travailler avec le rédacteur pour qu'il rédige une nouvelle révision acceptable. Veuillez donc remercier le rédacteur et donnez-lui ensuite des commentaires personnalisés et constructifs sur ce que vous ressentez qui doit changer pour que la révision soit acceptable. Assurez-vous de lui donner des liens vers toutes discussions d'articles ou directives pertinentes.

Prêt pour la localisation

Marquer une révision d'article comme « Prêt pour la localisation » nous permet de dire aux localisateurs que la version anglaise est terminée et qu'elle peut être traduite sans crainte que l'article ne change plusieurs fois avant sa complétion.

Lorsque vous approuvez une révision, si tous les changements nécessaires (notes de changements prévus, forum de discussion sur l'article) ont été faits et qu'aucun n'est actuellement prévu, allez de l'avant et marquez l'article comme prêt pour la localisation.

« Gel » des articles les plus vus

La localisation nécessite beaucoup de travail et est souvent réalisée par une seule personne. Seuls les 20 articles les plus vus ou assimilés sont localisés dans certaines langues. Nos articles les plus vus n'ont généralement pas besoin de modifications autres que les mises à jour pour une nouvelle version de Firefox. Puisque nous savons ce qui nous attend, nous essayons de faire en sorte que tous les changements nécessaires sont effectués quatre semaines avant une sortie de Firefox, de sorte que les localisateurs peuvent utiliser ces quatre semaines pour faire leur travail.

Par conséquent, nous ne devrions marquer les articles les plus vus comme prêts pour la localisation seulement quatre semaines avant une sortie. Toutes les mises à jour pour les six prochaines semaines NE devraient PAS être marquées prêtes pour la localisation. Bien sûr, s'il y a un changement qui est essentiel et qui doit être traduit, il nous faudra faire une exception. N'oubliez pas également que si vous utilisez le niveau de révision mineur, vous POUVEZ marquer l'article prêt pour la localisation, car les localisateurs ne sont pas avertis des changements induits.

Si vous ne marquez pas une révision comme prête pour la localisation lors de son approbation (comme dans le cas ci-dessus), vous pouvez la marquer prête en cliquant sur l'état dans la ligne correspondante de l'historique des révisions, puis en confirmant.

Comment est-ce que « Prêt pour la localisation » fonctionne ?

Afin d'éviter que quelqu'un ne traduise une ancienne révision d'article, lorsque vous cliquez sur « Translate Article », la version la plus récente qui a été marquée prête pour la localisation est affichée. Et une fois qu'une nouvelle révision d'un article a été approuvée, l'article n'est pas ajouté aux tableaux de bord des localisations comme ayant besoin d'une mise à jour à moins que la révision n'ait été marquée avec les deuxièmes ou troisièmes niveaux de révision ET que la case « Ready for localization » ait été cochée. Cela envoie également une notification par courriel à toutes les personnes surveillant les articles qui sont prêts à localiser.

Sujets d'actualité (hot topics)

Nous avons un thème spécial appelé « Hot Topics ». Ceux-ci sont listés et mis en évidence sur les pages d'accueil du produit. En général, nous ne voulons pas afficher plus de 3 - 5 articles dans cette liste. Ceux-ci sont déterminés au cas par cas en tenant compte de l'ampleur de la question, sa gravité et sa durée. Nous en discutons dans notre réunion hebdomadaire (en). En règle générale, nous laisserons un article sur la liste de sujets d'actualité pendant une semaine après que ce ne soit plus vraiment un gros problème pour laisser le temps aux gens de le voir.

Changements nécessaires

Lors de l'approbation d'une révision, vous devez décider ce qui, le cas échéant, doit encore être changé. Si tout ce qui était spécifié dans le « commentaire des modifications nécessaires » a été pris en compte, vous pouvez la décocher (ceci efface le commentaire) et approuver l'article. S'il y a encore des choses qui doivent être faites, assurez-vous que la case est cochée et mettez à jour le commentaire. De cette façon, nous pouvons facilement garder une trace du travail qui reste à faire sur ​​les articles.

Reconnaître les contributions

Parfois, les gens qui participent à une discussion sur un article apportent des contributions importantes à une révision, même si ce ne sont pas ceux qui ont réellement modifier le Wiki. Dans de tels cas, vous pouvez modifier la liste des contributeurs à un article (sur la page de l'historique de l'article) pour les inclure. Des points de bonus pour leur faire savoir que vous avez fait cela !

Spam et erreurs d'édition

Dans le cas de spam, vous devriez simplement supprimer la révision (cliquez sur le « X » sur la ligne correspondante dans la vue de l'historique). Dans le cas de soumissions erronées (aucun changement) et de demandes d'aide mal placées (la modification est essentiellement une question d'assistance), vous devriez l'ajourner et inclure ce message dans votre commentaire :
Hi.
It appears you may have been trying to get help with Firefox. If that is the case, please ask your question again here, https://support.mozilla.org/questions/new so that we can better help you.
Sorry for the inconvenience.

Une fois que vous avez fait cela, vous pouvez supprimer la révision.