Découvrez la base de connaissances de l’assistance de Mozilla (SUMO) et son fonctionnement.

La base de connaissances est un Wiki avec des super pouvoirs

• Balises Wiki spéciales – Bien que nous utilisions les balises MediaWiki (comme Wikipédia) pour la plupart des choses, notre Wiki est conçu spécifiquement pour l’assistance de Mozilla et utilise des balises personnalisées (appelées {for}) afin que nous puissions montrer des instructions aux personnes utilisant Windows, par exemple, et d’autres à celles utilisant un Mac.
• Système de vérification – Parce que nous voulons être sûrs que les gens ont des informations correctes et à jour, les modifications apportées à nos articles doivent être vérifiées et approuvées avant qu’elles ne soient mises en ligne.
• Traductions – La plupart de nos utilisateurs parlent une langue autre que l’anglais. Nous avons un système complet de traduction vers d’autres langues des articles de notre base de connaissances en anglais.

Public et périmètre de la base de connaissances

Comme les logiciels de Mozilla sont utilisés par des millions de personnes avec différents niveaux de compétence, la base de connaissances doit être écrite pour un large public plutôt que pour un très familier avec les techniques et la terminologie informatiques. Nous couvrons principalement les fonctionnalités (comme les onglets, les marque-pages et la synchronisation) et la correction des problèmes (comme les plantages ou les problèmes de chargement de sites web). Nous ne couvrons pas toutes les fonctionnalités, tous les paramétrages ou problèmes. Nous regardons plutôt ce que les utilisateurs et utilisatrices nous disent (dans les discussions des articles, dans les forums d’assistance et en étudiant le nombre de visites des articles) et utilisons notre expérience et notre jugement pour décider exactement de ce que nous traitons.

Quels sujets ne couvrons-nous pas dans la base de connaissances ?

• Les astuces ou bidouillages pour modifier un produit.
• Les fonctionnalités avancées et destinées aux développeurs et développeuses comme la console d’erreurs et la console web.

Organisation de notre travail

Comment gérons-nous nos priorités ?

Nous travaillons principalement sur les articles en fonction de leur popularité. Cela représente généralement les priorités de nos utilisateurs et utilisatrices. Actuellement, les vingt articles les plus vus comptent pour moitié de toutes les visites. Améliorer nos articles les plus vus peut potentiellement aider autant de personnes que l’amélioration des cent articles les moins vus. Nous gardons une trace des changements à réaliser dans ce tableau de bord. Il est trié en fonction du rang des articles afin que vous puissiez aisément voir ceux sur lesquels il faudrait travailler en premier.

Exceptions :
Bien évidemment, la popularité n’est pas la seule priorité. Ces exceptions ont également besoin d’être prises en compte.

• Nouveaux problèmes – Occasionnellement, de nouveaux problèmes sont signalés dans notre forum d’assistance qu’il est préférable de traiter en mettant à jour un article de la base de connaissances. Par exemple, un problème affectant les personnes utilisant le plugin Flash (la plupart de ceux et celles qui utilisent Firefox) serait plus important à mettre à jour qu’une fonctionnalité existante dans une version à venir de Firefox.
• Demande anticipée – Occasionnellement, nous mettrons à jour un article en anticipation d’une nouvelle fonctionnalité ou d’une fonctionnalité modifiée. L’article actuel peut ne pas avoir un rang particulièrement élevé, mais nous sommes raisonnablement sûrs, basé sur l’expérience et les plans marketing, que ces articles deviendront populaires.
• Documentation pour mobile – Parce que les produits de Mozilla pour appareils mobiles tels que Firefox pour Android et Firefox pour iOS ont comparativement peu d’utilisateurs, leurs articles ne peuvent « concourir » avec les articles pour Firefox pour ordinateur. Les articles pour ces produits devraient être considérés dans le contexte de la demande relative de documentation de fonctionnalités et problèmes.
• Articles liés – Ce sont les articles vers lesquels un lien figure dans les produits ou sur mozilla.org.

Où parlons-nous des articles ?

Nous avons généralement deux types de conversations sur les articles de la base de connaissances :

• Articles individuels – Chaque article a son propre onglet de discussion. Les utilisateurs et utilisatrices enregistrés peuvent y publier des retours sur les articles. Nous pouvons y discuter des révisions dont l’article a besoin, des mérites relatifs de chaque révision et des problèmes liés à l’article.
  
• La base de connaissances en anglais comme un tout – Nous discutons des idées et problèmes avec la stratégie globale de la base de connaissances, des politiques et des logiciels dans le forum des articles (en anglais).

Comment puis-je rester au courant de ce qui se passe ?

• Blog de l’assistance de Mozilla (SUMO) (en anglais) : Les dernières mises à jour et derniers développements y sont discutés.
• Actualités et ressources du contributeur ou de la contributrice : C’est une autre bonne source d’information – elle est mise à jour chaque semaine environ.
• Forum de discussion de la communauté SUMO (en anglais) : C’est là où les contributeurs discutent entre eux.
• Forum des articles de la base de connaissances (en anglais) : C’est l’endroit où nous discutons des sujets généraux concernant la base de connaissances.
• Forum de la traduction (en anglais): C’est là où nous parlons de la localisation de SUMO.

Améliorer les articles en anglais

L’amélioration des articles de la base de connaissances en anglais occupe probablement 90 % de notre temps. Il y a toujours quelque chose qui peut être amélioré. Voici trois principales façons d’améliorer un article :

• Garder les articles à jour – Les mises à jour majeures des produits et services de Mozilla apportent toujours de nouvelles fonctionnalités et des changements dans la manière dont les existantes fonctionnent. Il est toujours mieux que nos instructions correspondent à la manière dont les choses fonctionnent dans le produit.
• Relire – Certains d’entre vous ont des pouvoirs spéciaux pour mettre en évidence les erreurs que les correcteurs orthographiques ont manquées (combien en avez-vous notées dans cet article jusqu’à maintenant ?). Nous avons besoin de votre aide.
  • Corrigez les fautes d’orthographe, de grammaire et de ponctuation.
  • Corrigez les problèmes de style et de formatage. Consultez Comment écrire les articles de la base de connaissances en anglais, Comment utiliser les balises « for » et Comment utiliser les modèles pour des lignes directrices.
• Rendre les articles plus faciles à comprendre
  • Trouvez un meilleur moyen d’expliquer quelque chose qui est trop complexe ou pas très claire.
  • Ajoutez des captures d’écran pour aider les gens à comprendre à quoi se réfère l’article. La plupart des gens ne savent probablement pas la différence entre la barre d’adresse, la barre de recherche, la « barre de fer » ou tout autre barre.
  • Ajoutez des captures vidéo d’écran. C’est bien mieux de montrer à quelqu’un comment faire une chose plutôt que de lui décrire.

Quel est le processus pour modifier un article en anglais ?

Au minimum, tout ce que vous avez à faire est de cliquer sur Edit Article, d’apporter quelques changements et de les soumettre à vérification. Le processus complet ressemble à ceci :

1. Rendez-vous sur la section des modifications planifiées du tableau de bord des contributeurs.
2. À partir des descriptifs de modification à réaliser, choisissez un article. Cliquez sur Editing Tools et jetez un œil à la discussion afin d’avoir des informations pertinentes relatives aux modifications programmées.
3. Modifiez l’article. Consultez How to write knowledge base articles pour les astuces de style.
   • Utilisez le bouton Preview Content pour vérifier vos changements.
4. Cliquez sur le bouton Submit for Review pour enregistrer vos changements. Votre modification sera listée dans la section des modifications non vérifiées du tableau de bord des contributeurs.

Si cela prend trop longtemps à vérifier, vous pouvez contacter jsavage sur le canal IRC #sumo ou par courriel.

Si le vérificateur n’approuve pas l’article, il indiquera ses raisons et retours dans un fil de la page de discussion de l’article. Parfois, il créera une nouvelle révision basée sur la vôtre et ajoutera ou changera des choses.

Vous (ou quelqu’un d’autre) peut créer une autre révision et faire plus de changements. Cela prend généralement plusieurs itérations pour que les choses deviennent correctes.

Créer un nouvel article en anglais

Si vous pensez qu’il y a un article que nous avons besoin d’ajouter à la base de connaissances, voici comment faire.

1. Créez un nouvel article et remplissez le formulaire en utilisant la source d’un autre article comme guide.
2. Rédigez le contenu de l’article.
3. Vérifiez votre travail en utilisant le bouton Preview Content
4. Cliquez sur le bouton Submit for Review et décrivez dans le commentaire la raison pour laquelle rédiger l’article.
   • Faire ceci ajoute l’article au tableau de bord de la base de connaissances pour faire savoir à tous que l’article est en attente de modification ou de vérification.
   • L’article ne sera pas rendu public tant qu’il n’aura pas été vérifié et approuvé.

Style

Nous voulons que l’aide de Mozilla soit utilisable par tous les utilisateurs et toutes les utilisatrices. Cela signifie que nous écrivons pour un public large plutôt qu’un public très familier avec les techniques et la terminologie informatiques.

• La personne pour qui vous écrivez ne sait pas comment changer les préférences ou ajouter un bouton de barre d’outils sans des instructions pas à pas.
• Supposez que les personnes n’ont changé aucun des paramètres par défaut du produit ou du système d’exploitation.
• Style d’écriture conversationnel – Utilisez un style informel et actif semblable à la manière dont vous parleriez en personne à quelqu’un.
• Images et vidéos – L’utilisation des images et vidéos en parallèle du texte pour expliquer les choses est un moyen facile d’inclure les multiples styles d’apprentissage et de répétition.

Pour davantage d’informations, consultez Comment écrire les articles de la base de connaissances en anglais.

Balises

Notre Wiki utilise une syntaxe MediaWiki avec des choses en plus pour styliser les boutons, touches, menus, etc. Consultez Tableau de balisage pour une liste et des exemples.

{for}

Comment utiliser les balises « for » contient des procédures et des exemples pour afficher et masquer les instructions pour des versions différentes de Firefox et différents systèmes d’exploitation.

Modèles

Nous avons une liste de modèles que nous utilisons dans les articles afin que les mêmes séries d’instructions ne soient pas réécrites, localisées et synchronisées dans de nombreux articles. Comment utiliser les modèles explique la manière dont cela fonctionne.

Captures d’écran et captures vidéo d’écran

Nous devons nous assurer que les articles sont écrits pour être compréhensibles sans images ou vidéos. Bien que les images et vidéos soient importantes et augmentent grandement l’utilité d’un article, elles ne peuvent être obligatoires. Les localisateurs et localisatrices ne doivent pas hésiter à les utiliser ou les supprimer comme bon leur semble.

Priorité sur la version pour ordinateur

1. Windows – avec environ 90 % de nos utilisateurs et utilisatrices sous Windows, il n’y a pas à réfléchir. À partir de maintenant, nous devons faire des captures d’écran de Windows 7 ou supérieur si on ne peut en faire qu’une.
2. Mac – la version actuelle est macOS 10.14 (Mojave).
3. Linux – utilisez Ubuntu pour les captures d’écran.

Mobile

1. Android – 4.0 + (4.0, 4.1, 4.2, 4.3, etc.).

Ajouter ou supprimer des articles en anglais

Proposer de nouveaux articles en anglais

Notre base de connaissances est la réponse la plus efficace aux questions que se posent des centaines de millions d’utilisateurs et utilisatrices de Firefox. Mais les articles ont tous un coût, car chacun doit être écrit, localisé et maintenu. Avec beaucoup de fonctionnalités et de problèmes déjà documentés, notre temps à tous et toutes est mieux dépensé à améliorer les articles existants. Avant de commencer à créer de nouveaux articles, réfléchissez aux choses suivantes :

Avons-nous réellement besoin de cet article ?
Voici les raisons principales d’ajout d’un nouvel article à la base de connaissances, même s’il est souvent plus logique de mettre à jour un article existant.

• Nouvelles fonctionnalités – Fonctionnalités visibles susceptibles de générer beaucoup d’intérêt et de questions de la part des utilisateurs et utilisatrices. Il peut s’agir d’un aspect inhérent à la fonctionnalité, du résultat de liens marketing ou inclus dans les produits, ou d’une combinaison des deux.
• Nouveaux problèmes – Problèmes remontés dans de nombreux fils de discussion avec beaucoup de votes dans le forum d’assistance.
• Impact élevé – Problèmes critiques devant être rapidement et temporairement documentés (p.ex. Pogo.com et d'autres pages Java ne fonctionnent pas).

Archiver les articles

Nous archiverons périodiquement des articles de la base de connaissances pour se concentrer sur les sujets les plus pressants pour les utilisateurs et utilisatrices. Puisque nous sortons une nouvelle version des produits Mozilla toutes les six semaines, les problèmes et sujets pour lesquels les utilisateurs et utilisatrices ont besoin de documentation changent à un rythme plus rapide. Il y a beaucoup d’articles, comme Les marque-pages dans Firefox ou Comment définir la page d’accueil, qui resteront pendant longtemps, mais il y en aura d’autres qui deviendront obsolètes ou plus une préoccupation pour les utilisateurs et utilisatrices.

Comment cela fonctionne :
Les contributeurs ou contributrices avec des droits de vérification peuvent marquer un article comme obsolète en modifiant la section de description d’un article. Cela supprimera l’article de tous les tableaux de bord, notamment les tableaux de bord de localisation, et des recherches standards. Vous pouvez toujours voir l’article en utilisant la recherche avancée, et bien sûr, les liens vers l’article seront préservés. Néanmoins, il y aura un avertissement en haut de l’article indiquant qu’il n’est plus maintenu et donc possiblement plus à jour.

Archiver un article n’est pas à sens unique. Une fois qu’un article est archivé, nous surveillerons les statistiques pour nous assurer qu’il n’a pas reçu de nombreuses visites. Si nous nous sommes trompés, un simple clic dans une case permet de faire réapparaître l’article dans les tableaux de bord.

Éléments à considérer avant d’archiver un article :

• Peu de vues – Généralement, les articles avec environ moins de mille cinq cents visites par mois.
• Peu de retours récents – Problèmes qui ont relativement peu de fils de discussion récents avec votes dans le forum d’assistance.
• Peu d’impact – La suppression de l’article est peu susceptible de causer ou d’aggraver un problème sérieux.
• Changements dans les produits et services – Cas où un problème a été corrigé ou un changement dans le comportement a rendu quelque chose obsolète.

Directives pour la vérification des articles en anglais

Pour connaître les directives pour vérifier les articles de la base de connaissances, voir les directives pour la vérification des articles en anglais.