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. Voici quelques directives pour la vérification des articles.

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.

L'aperçu du tableau de bord de la base de connaissances liste les articles par ordre de visites au cours des 30 derniers jours. La colonne « Status » (état) indique les articles qui nécessitent une vérification. Toutes les révisions d'articles, pas seulement celles des articles les plus consultés, doivent être vérifiées en temps opportun. Si une révision ne peut être approuvée, elle doit être ajournée avec une explication (voir ci-dessous). Le responsable du contenu de la base de connaissances de SUMO est chargé de garantir des vérifications en temps opportun.

La liste des modifications non vérifiées est une autre façon de voir quels articles nécessitent une vérification, ainsi que les révisions qui sont en attente de vérification depuis le plus longtemps. Vous pouvez trier la liste « All Products » (tous les produits) par « Most Recent » (plus récentes) ou choisir un produit spécifique dans la liste déroulante.

Articles les plus vus

Nos articles les plus consultés avec plus de 100 000 visites par mois (dont environ 20 articles pour ordinateur) représentent environ 50 à 55 % de toutes les visites de la base de connaissances. Nos articles Android les plus consultés sont ceux qui comptent plus de 5 000 visites par mois.

Il est essentiel que ces articles comportent les dernières informations.

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 — n'approuvez pas votre propre révision s'il s'agit d'un gros changement. Veuillez suivre les directives d'approbation d'articles ci-dessous. Si nécessaire, veuillez lancer une discussion dans le fil de discussion de l'article.

Autres articles

Les articles avec moins de 100 000 visites par mois pour ordinateur (ou ceux avec moins de 5 000 visites pour Android) représentent la grande majorité de notre base de connaissances (plus de 600 articles ; 45-50 % des visites). Ils couvrent des problèmes moins courants et des produits plus récents. Veuillez suivre les directives d'approbation d'articles ci-dessous.

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), ou s'il s'agit d'une réponse préenregistrée, 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 100 000 visites par mois pour ordinateur ou 5 000 pour Android. 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.
• Une fois qu'un nouvel article a été approuvé mais qu'il est en ligne depuis moins d'un mois, envisagez de consulter la vue sur 7 jours.

Articles spéciaux

• Les modèles (templates) incluent du contenu utilisé dans plusieurs articles et doivent être considérés comme des articles de premier plan. Tous les modèles, y compris ceux qui nécessitent une vérification, sont listés ici. Consultez Comment utiliser les modèles pour des directives supplémentaires.
• Les réponses préenregistrées (canned responses) sont bien plus importantes dans le forum d'assistance que ne le suggèrent les chiffres de consultation. Traitez les nouvelles réponses du forum, ou tout ce qui va au-delà d'une correction ou d'une clarification mineure, comme un gros changement. Toutes les réponses du forum, y compris celles qui nécessitent une vérification, sont listées sur cette page. Consultez Create or improve common forum responses pour des directives supplémentaires.

Directives de vérification et d'approbation des articles

La création de contenu de premier ordre sur SUMO joue un rôle crucial pour instaurer la confiance avec nos utilisateurs et utilisatrices et établir notre crédibilité. Pour garantir que tout le contenu répond à des normes élevées de qualité, d'exactitude et de cohérence, nous avons mis en place une exigence de vérification pour tout le contenu de la base de connaissances, quel que soit son auteur ou autrice.

Chaque fois qu'une révision est apportée au contenu de la base de connaissances, elle doit subir au moins un cycle de vérification. Cette vérification peut être effectuée soit par un membre du personnel, soit par un contributeur ou une contributrice pair, en fonction du produit spécifique. Même le contenu créé par les membres de notre personnel doit passer par ce processus de vérification, bien que l'approbation elle-même puisse avoir lieu en dehors de SUMO pour les membres du personnel.

Pour plus de clarté, nous avons fourni ci-dessous des informations indiquant quels produits nécessitent une approbation exclusive du personnel et lesquels peuvent être approuvés par des cocontributeurs et cocontributrices.

En adhérant à ces pratiques de vérification et d'approbation, nous pouvons nous assurer que le contenu sur SUMO maintient un haut niveau de qualité et d'exactitude, fournissant à nos utilisateurs et utilisatrices des informations fiables et précieuses.

Directives de vérification du contenu

Tous les membres du personnel interne sont tenus de faire vérifier leur contenu en-US par au moins une autre partie. Les exemples de vérificateurs de contenu peuvent inclure des responsables du support produit, des chefs de produit, des services juridiques, marketing, relations publiques ou des contributeurs et contributrices de la communauté.

Les vérifications de contenu peuvent avoir lieu au sein de SUMO ou dans un Google Doc. Si votre contenu a été vérifié en dehors de SUMO, ajoutez simplement une note dans votre révision SUMO, en mentionnant l'équipe ou les personnes qui l'ont approuvé. Voir un exemple ci-dessous.

Veuillez ne pas auto-approuver vos propres révisions (en-US uniquement), sauf si vous corrigez une erreur dans un contenu précédemment approuvé ou si vous modifiez des détails mineurs qui n'affectent pas les instructions. Veuillez attendre qu'un autre contributeur, une autre contributrice ou un membre du personnel vérifie les autres modifications de contenu (voir niveaux de révision, ci-dessous).

Les révisions récentes pour en-US et les modifications non vérifiées seront examinées au moins trois fois par semaine par le personnel et les contributeurs et contributrices. Les révisions en attente doivent être approuvées ou ajournées sans qu'il soit nécessaire d'être contacté. S'il n'y a pas de raison critique pour une approbation immédiate, un délai raisonnable (sept jours ou plus) doit s'écouler avant qu'un rédacteur ou une rédactrice ne contacte le personnel ou un autre vérificateur ou une autre vérificatrice, si l'approbation du personnel n'est pas nécessaire.

Il peut y avoir des exceptions où certains contenus nécessitent une vérification et une approbation par le personnel. Dans ces situations, l'auteur ou l'autrice indiquera dans les notes de révision que la « vérification par le personnel est requise ». Si vous proposez une révision à l'un de ces articles, assurez-vous de le signaler à l'attention d'un rédacteur ou d'une rédactrice du personnel (via un message direct sur SUMO ou Slack), afin qu'il ou elle puisse fournir la vérification et l'approbation nécessaires.

En travaillant ensemble et en impliquant d'autres personnes dans le processus de vérification et d'approbation, nous pouvons maintenir les normes de qualité les plus élevées et nous assurer que notre contenu est de premier ordre. Merci de votre coopération, et continuons à créer des révisions incroyables pour nos utilisateurs et utilisatrices !

Matrice des exigences de vérification

* Sauf indication contraire de l'auteur ou de l'autrice comme « Approbation par le personnel requise » dans les notes de révision.

Articles avec des exigences spéciales

Produits sur abonnement/premium

Veuillez ne pas auto-approuver vos révisions ou approuver les révisions d'autres contributeurs ou contributrices (en-US uniquement). Cela inclut les réponses préenregistrées et les modèles pour les produits sur abonnement/premium. Si vous proposez une révision, veuillez la signaler à un rédacteur ou une rédactrice du personnel pour approbation (via message direct/privé sur SUMO, Matrix ou Slack).

En travaillant ensemble et en veillant à ce que les rédacteurs et rédactrices du personnel soient impliqués dans le processus d'approbation du contenu des produits premium, nous pouvons continuer à rendre notre contenu le meilleur possible pour nos clients et clientes.

Matrice des exigences de vérification

Conformité aux directives de vérification

Créer un contenu cohérent, précis et pertinent est important, mais ce n'est pas la seule étape du processus. Pour nous assurer que notre contenu maintient sa qualité au fil du temps, nous avons besoin que toutes les personnes impliquées comprennent et suivent les processus de vérification et d'approbation. Notre personnel surveillera dans quelle mesure nous suivons les nouvelles directives pour s'assurer que tout reste sur la bonne voie.

Pour conserver votre permission de vérification de la base de connaissances :

• Adhérez aux directives de vérification ci-dessus.
• Adhérez aux Règles de participation à la communauté Mozilla.
• Vérifiez au moins trois (3) révisions d'articles par mois.

Votre permission de vérification de la base de connaissances en tant que vérificateur ou vérificatrice peut être révoquée si vous auto-approuvez du contenu en-US ou si vous ne vérifiez aucune révision d'article pendant une période prolongée de 60 jours ou plus. Les vérificateurs et vérificatrices seront contactés par le personnel pour déterminer s'il existe des raisons valables de non-conformité, avant que toute mesure ne soit prise pour révoquer la permission de vérification. En adoptant cette approche, nous encourageons le travail d'équipe, garantissons le meilleur contenu possible et créons un environnement où l'expertise de chacun et chacune contribue à notre succès.

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 :

• Détails mineurs qui n'affectent pas les instructions : ce sont des changements qui ne modifient pas les instructions pour les utilisateurs et utilisatrices. Les équipes de localisation ne seront pas informées de ces changements.
• Modifications de contenu qui ne nécessitent pas une traduction immédiate : 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.
• Modifications majeures de contenu qui rendront les anciennes traductions inexactes : 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, est un gros changement à un article de premier plan qui n'a pas été discuté, ou est quelque chose que vous ne jugez pas utile, vous devriez ajourner l'approbation. Plutôt qu'un simple rejet, cependant, un ajournement est votre opportunité de travailler avec le rédacteur ou la rédactrice pour rendre cette révision prête à être approuvée. Alors, veuillez remercier le rédacteur ou la rédactrice, puis donnez des commentaires spécifiques et constructifs sur ce qui, selon vous, doit changer pour que la révision soit acceptable. En plus du champ de commentaire lors de l'ajournement d'une révision, vous pouvez également ajouter un fil de discussion au forum de discussion de l'article avec des informations plus détaillées et renvoyer le rédacteur ou la rédactrice au forum de discussion de l'article. Assurez-vous de lui donner des liens vers toutes discussions d'articles ou directives pertinentes.

Vérification de plusieurs révisions

Approuver la dernière révision ne signifie pas que vous approuvez les révisions antérieures qui sont en attente de vérification. Lorsqu'il y a plusieurs révisions en attente d'approbation, assurez-vous de vérifier toutes les révisions avant de prendre la décision d'en approuver une. Vous ne pouvez pas vérifier les anciennes révisions lorsqu'une révision plus récente a été approuvée. Vous verrez qu'elles sont toujours en attente d'approbation, mais il ne sera pas possible de les vérifier.

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 (pour la version actuelle ou la prochaine), marquez l'article comme prêt pour la localisation.

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 avant une sortie de Firefox, de sorte que les localisateurs peuvent utiliser ce temps supplémentaire pour faire leur travail.

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 comme prête à tout moment en cliquant sur l'entrée d'état « Not ready for localization » (non prête pour la localisation) (un symbole X) sous la colonne R de l'historique des révisions de l'article et en confirmant.

Les révisions qui ont été marquées RFL (prêtes pour la localisation) ont un symbole de coche.

Comment fonctionne « Prêt pour la localisation » (RFL) ?

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. 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.

Contenu de la prochaine version

Les articles avec du contenu de la prochaine version sont soit de nouveaux articles, soit des modifications de contenu d'articles existants, qui couvrent les fonctionnalités introduites dans la prochaine version. Les directives suivantes s'appliquent aux articles avec du contenu lié à la version :

Chronologie de l'édition de la base de connaissances basée sur les versions

4 semaines avant la prochaine version

• Planification et rédaction du contenu pour la prochaine version ; pas encore de travail pour les équipes de localisation pour la prochaine version
• Tout le contenu existant est ouvert à l'édition et à la localisation comme d'habitude ; veuillez vous concentrer sur la localisation du contenu le plus récent/populaire

3 semaines avant la prochaine version

• Le contenu de la prochaine version est terminé à la fin de cette semaine ; pas encore de travail pour les équipes de localisation pour la prochaine version
• Tout le contenu existant est ouvert à l'édition et à la localisation comme d'habitude ; veuillez vous concentrer sur la localisation du contenu le plus récent/populaire

1-2 semaines avant la prochaine version

• Les modifications de contenu de la prochaine version ont été effectuées en en-US/anglais, et les équipes de localisation doivent se concentrer sur la traduction de ce contenu
• Tout autre contenu existant est dépriorisé, mais peut être édité et localisé comme d'habitude

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 !

Pour ajouter un contributeur ou une contributrice, allez à la page Show History (afficher l'historique) d'un article. Faites défiler sous les révisions et cliquez sur le lien « Edit contributors » (modifier les contributeurs), tapez le nom du contributeur ou de la contributrice, puis cliquez sur Add Contributor.

Spam et erreurs d'édition

Dans le cas de spam, vous devriez simplement supprimer la révision en cliquant sur l'icône de corbeille dans l'historique des révisions de l'article et en confirmant. 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.