Méngale Njàngat yi

Comment écrire les articles de la base de connaissances en anglais

Njàngat 180774:

Njàngatu 180774 bu Mozinet ci

Njàngat 307699:

Njàngatu 307699 bu SumoBot ci

Baat yi ëpp solo:

Tënkub njuréefi seet:

Guide général pour écrire les articles de la base de connaissances en anglais
Ce guide des articles d'assistance de Mozilla inclut le choix d'un bon titre, la rédaction d'un résumé pour la recherche, l'organisation de votre article et un guide de style.

Ëmbiit:

Il y a beaucoup de choses en concurrence à soupeser quand vous écrivez ou modifiez un article. Vous voulez être, tout à la fois, complet et concis, factuel et intéressant. Ce n’est certainement pas la chose la plus facile au monde à faire. Voici des directives pour aider à rendre ce jugement un peu plus facile. Comme c’est également un wiki, nous pouvons toujours réviser quelque chose si nous nous sommes trompés. __TOC__ ==Écrire pour un public général et non technique == Nous voulons que l’aide de Firefox soit utilisable par tous les utilisateurs de Firefox. Cela signifie que nous écrivons pour un public général plutôt que pour un familier avec les techniques et la terminologie informatique. Supposez que la personne pour laquelle vous écrivez ne connaisse pas la manière de changer les préférences ou d’ajouter un bouton de barres d'outils sans des instructions pas-à-pas. Nous devrions également supposer qu’ils n’ont changé aucun des réglages par défaut de Firefox ou du système d’exploitation. ==Choisir un bon titre== Le titre de l’article ainsi que son résumé sont les seules choses dont l'utilisateur dispose pour juger de sa pertinence au regard de sa question. Nous appelons cela la « confiance utilisateur ». Elle impacte directement le taux de clic. » Même si nous servons le bon article en haut de la liste des résultats de recherche, l’utilisateur a besoin de connecter mentalement la requête et les résultats que nous affichons afin qu’il clique sur l’article. Un titre d’article devrait essayer de décrire de quoi l'article traite. Il faut que les quelques premiers mots soient aussi compréhensibles que possible et comprennent les mots-clés importants. Cela permettra aux utilisateurs de savoir de quoi traite l’article et de cliquer dessus en toute confiance. De plus, un titre devrait suivre ces lignes directrices : * Longueur du titre : La page des résultats de recherche de Google affiche jusqu’à 70 caractères. Votre titre peut être plus long que cela si nécessaire mais assurez-vous que les mots-clés importants sont dans les 70 premiers caractères. * Essayez de varier la manière dont vous nommer les articles. N’utilisez pas les mêmes verbes ou phrases dans tous les titres. * Essayez de ne pas utiliser le gérondif (mots se terminant par ''ing''). * N’utilisez pas de virgule dans le titre de l'article, car cela empêche la création d'un lien wiki vers cet article ([https://bugzilla.mozilla.org/show_bug.cgi?id=749835 bogue 749835]). Souvenez-vous que toute l’explication ne doit pas être dans le titre. Vous pouvez utiliser le résumé pour donner à l’utilisateur des informations supplémentaires sur ce qui est dans l’article. == Corriger l’identifiant == Quand vous créez un titre, SUMO crée également automatiquement un identifiant (la fin de l'URL de l'article). Il est limité à 50 caractères. Les espaces sont rendues par des tirets. L’identifiant devrait être cohérent avec le titre, mais, étant donné la contrainte de longueur limitée, n’a pas besoin d'être le même. Vérifiez bien la fin de l’identifiant autogénéré. Parfois, un mot est coupé ou l’identifiant se termine par un tiret. Veuillez corriger ce genre de choses. == Catégories, produits et sujets == Pour la majeure partie, un article appartient soit à la catégorie « Comment faire », soit à celle de « Résolution de problèmes ». De temps en temps, nous écrivons des articles « Comment contribuer » (comme celui-ci) ou quelque chose dans une des autres catégories. Les articles concernent également au moins un produit. Ils appartiennent aussi à un « sujet » principal et, optionnellement, à un « sous-sujet ». == Mots-clés == Le champ des mots-clés dans un article peut être utilisé pour améliorer les résultats de recherche sur SUMO. Il ne devrait néanmoins être utilisé que sous certaines conditions bien particulières, sa mauvaise utilisation pouvant biaiser la recherche. Nous avons rarement besoin d’utiliser les mots-clés. Pour en savoir plus, consultez l’article [[When and how to use keywords to improve an article's search ranking]]. == Écrire un bon résumé de recherche == Le résumé de l’article ainsi que son titre sont les seules choses dont l’utilisateur dispose pour juger de sa pertinence au regard de sa question. Nous appelons cela la « confiance utilisateur ». Elle impacte directement le taux de clics. Même si nous servons le bon article en haut de la liste des résultats de recherche, l’utilisateur a besoin de connecter mentalement la requête et les résultats que nous affichons afin qu’il clique sur l'article. Un résumé d’un article sur « Comment faire » devrait comprendre les sujets couverts dans l’article. Un article de résolution de problème devrait quant à lui inclure les symptômes. De plus, un résumé devrait suivre ces lignes directrices : * Court et au fait. Souvenez-vous des petites annonces. Rédigez-le comme cela. La plupart des moteurs de recherche coupent tout ce qui dépasse 160 caractères. * N’utilisez pas de balise wiki. * N’utilisez pas « This article explains » dans tous les résumés. Variez autant que possible. Voici d'autres phrases à considérer : ** We’ll show you ** We’ll explain ** This page explains ** This article describes ** We’ll spell out ==Rendre votre écriture intéressante== L’aide de Firefox est un répertoire d’informations techniques sur l'utilisation du navigateur web Firefox. La documentation liste les fonctions des différentes fonctionnalités de Firefox, les procédures de diagnostic des problèmes et les instructions pour la résolution des problèmes courants. On peut accéder à la documentation en utilisant la fonction de recherche sur chaque page ou vous pouvez juste jeter votre ordinateur dans la pièce où des licornes utiliseront leurs pouvoirs arc-en-ciel pour devenir des bougies magiques qui, une fois consumées, vous feront devenir un ninja informaticien de niveau 70. Vous êtes réveillé maintenant ? Bien. Ce paragraphe semble un peu ennuyeux, au moins jusqu’à ce que les licornes apparaissent. L’utilisation de l’humour et des émotions (SURPRISE !) sont des techniques qu’il est possible d’utiliser pour captiver l'attention des gens. Ces techniques, listées ci-dessous, ont toutes pour but de rendre votre cerveau attentif en recréant ce que cette interaction pourrait être si cela vous arrivait en personne. Quand nous faisons cela, les informations sont plus faciles à comprendre et à se souvenir. *'''Style d’écriture conversationnel''' – Utilisez un style informel et actif semblable à la manière dont vous parleriez en personne à quelqu’un. *'''Humour et émotion''' – L’utilisation de l'humour est bien, mais c'est quelque chose de dur ou impossible à localiser. Les émotions comme la surprise et « je ne savais pas cela ! » pourraient être plus facile à intégrer. *'''Multiples styles d’apprentissage''' – Comme à l’école, les gens apprennent différemment. Ainsi, tout le monde tire profit de voir le même contenu exprimé de multiples façons. *'''Répétition''' – Quand vous expliquez quelque chose de différentes manières avec différents médias, vous êtes évidemment en train de le répéter, ce qui est un autre bon moyen d’aider les gens à se souvenir de ce qui est important. *'''Images et vidéos''' – L’utilisation des images et vidéos pour expliquer les choses en même temps que du texte n’est pas la seule façon d’aider en personne, c’est un moyen facile d'inclure les multiples styles d'apprentissage et la répétition. *'''Activités''' – Il est bon de donner aux gens quelque chose d’utile à faire, particulièrement dans un tutoriel. C’est une chose de lire des instructions et de comprendre le processus, mais c’est souvent efficace de rappeler aux gens de tester les choses. L’article [[How to set the home page]] est un bon exemple de l'utilisation de ces techniques. ==Écrire une bonne introduction== Avec le titre et la table des matières, l’introduction est ce que les gens utilisent pour déterminer rapidement s’ils sont au bon endroit. *Pour un tutoriel ou un article sur comment faire : donnez un bref résumé des choses qui peuvent être apprises. *Pour un article de référence : donnez une brève explication de la fonctionnalité. *Pour un article de résolution des problèmes : donnez un bref résumé du problème et de ses symptômes. Une bonne introduction peut généralement servir de bon résumé. Souvent, vous pouvez juste la copier dans le champ « Résumé des résultats de recherche » et vous avez fini. ==Organiser en pratique l'article== L’idée générale ici est d’essayer de construire des compétences de la plus simple à la plus complexe en essayant de garder les informations nécessaires à la plupart des gens en haut. Donc une solution simple et courante viendrait généralement avant une solution complexe ou en cas limite. ==Utiliser des titres de paragraphe descriptifs== Nos articles sont généralement compréhensibles. Il est donc important d’utiliser des titres de paragraphe descriptifs pour aider les gens à trouver la partie de l'article dont ils ont besoin. Jetez un œil à votre table des matières. Est-ce que, couplé avec l'introduction, cela vous donne un bon aperçu du but de l’article ? ==Rendre les instructions pas-à-pas faciles à suivre== La chose principale à garder à l’esprit lors de l’écriture d'instructions pas-à-pas est d’être attentif à l’inclusion de toutes les actions nécessaires pour la réalisation de la tâche. Si, par exemple, vous devez cliquer sur « OK » après la sélection d'une préférence afin d’aller à l’étape suivante, assurez-vous de mettre « cliquez sur OK » dans l'étape. Des choses supplémentaires sont à considérer : *Il y a toujours plusieurs façons d’arriver à un résultat. Nous devrions toujours choisir la façon la plus conviviale : utilisation de l’interface utilisateur graphique et des menus quand c’est possible. *Utilisez des phrases complètes en décrivant la manière d’accéder à l’interface utilisateur. *Incluez les résultats attendus en donnant les instructions (par exemple, cliquez sur OK et la fenêtre se ferme.) Voici un exemple extrait de l’article [[How to set the home page]] avec des explications entre parenthèses. <br><br>'''Définir un unique site web comme page d'accueil''' <br> (Le titre – ce que les étapes vont accomplir) « Si vous aimez que les choses soient simples, voici un moyen de définir votre page d’accueil en trois étapes faciles »<br> (Contexte – montre une vue d’ensemble – pourquoi nous faisons cela) # Rendez-vous sur la page que vous désirez comme page d’accueil. # Cliquez sur l’icône à gauche de la barre de navigation et faites le glisser vers le bouton « Accueil », puis relâchez le clic souris. # Cliquez sur « Oui » pour confirmer. <br>'''Faites un essai :''' Cliquez sur le bouton « Accueil » et votre nouvelle page d'accueil se charge dans l’onglet en cours. Ce n’est pas plus compliqué que cela ! <br> (Activité – donne une mission au lecteur et décrit le résultat attendu) == Les liens courts sont facultatifs == Nous avons un [https://support.mozilla.org/en-US/kb/templatesharearticle modèle pour ajouter un lien court mzl.la] en bas d’un article, ceci afin de faciliter l’ajout de liens d’article dans les messages de l’''Army of Awesome''. '''Si vous en ajoutez un à un article, assurez-vous que l’URL de l'article ne comprend pas la chaîne de la langue ou n’importe quel autre paramètre supplémentaire à la fin.''' Par exemple, si vous chargez [https://support.mozilla.org/en-US/kb/update-firefox-latest-version Update Firefox to the latest version], cela peut donner : <code>https://support.mozilla.org/en-US/kb/update-firefox-latest-version#os=win7&browser=fx20</code> Vous devez changer cela avant de le raccourcir : <code>https://support.mozilla.org/kb/update-firefox-latest-version</code> '''Pour créer un lien mzl.la :''' #Collez le lien vers un article dans le champ de rétrécissement sur https://bitly.com. #Modifiez le lien comme décrit ci-dessus. #Cliquez sur le bouton {button Shorten} #Cliquez sur le bouton {button Copy} sur la page générée. == Guide de style SUMO == Comme nous en avons parlé plus tôt, nous devrions utiliser un style conversationnel et actif comme si vous parliez en personne avec quelqu’un. Donc vous devriez éviter de dire des choses comme « si les marque-pages d’un utilisateur sont perdus… » et dire plutôt « Si vous avez perdu vos marque-pages… » Voici d'autres problèmes courants de style que vous pouvez rencontrer en écrivant des articles d'assistance : '''Toujours utiliser les termes de la manière dont ils apparaissent dans l'interface de Firefox.''' Par exemple : *Plugins n’a pas de trait d'union. *Add-ons a un trait d’union. *Home page en deux mots. '''Termes informatiques généraux :''' *Internet a une majuscule. *Website en un seul mot. *Log in et log out sont des verbes, par exemple, « Log in to the website. » *Login et logout sont des noms (généralement utilisés comme des adjectifs), par exemple, « Click the login button. » *Utilisez email au lieu d'e-mail. *Le pluriel de CD-ROM est CD-ROMs. '''Les liens vers mozilla.org ne devraient pas contenir la langue :''' *Utilisez http://www.mozilla.org/firefox au lieu de http://www.mozilla.org/en-US/firefox '''Mettez la première lettre en majuscule des éléments suivants :''' *Les noms propres *Le premier mot d'une phrase complète *Les lettres des abréviations et acronymes sauf s'ils sont normalement en minuscules *Le premier mot dans les listes numérotées et à puces *Le nom d’une touche sur le clavier *Le premier mot d’une phrase complète suivant les deux-points *Le premier mot d’un titre de paragraphe ou d'article '''Dans un souci de clarté, n'utilisez pas [http://theoatmeal.com/comics/ie i.e. et e.g.].''' '''Nous avons des styles visuels spéciaux pour un nombre d'éléments qui peuvent être réalisés en ajoutant la balise wiki autour de l'élément (consultez l’article [[Markup cheat sheet]] pour les styles les plus courants).''' '''Nous avons une balise wiki spéciale – <nowiki>{</nowiki>for<nowiki>}</nowiki> – qui vous permet de cibler les informations pour les versions spécifiques de Firefox ou de systèmes d’exploitation.''' Par exemple, vous affichez un jeu d'instructions aux gens exécutant Windows et un autre aux gens utilisant Mac OS X (consultez l’article [[How to use For]] pour les détails).
En tant que personne contribuant à la base de connaissances, vous utilisez des mots pour aider un demi-milliard de personnes. C’est une tâche considérable. Les utilisateurs et utilisatrices consultent la base de connaissances depuis le monde entier et s’attendent à des solutions faciles, mais nous voulons aussi les enchanter par notre ton. Comment faire ? Voici quelques éléments que nous avons trouvés lors de nos recherches. {note}'''Nous adorons les suggestions !''' Si vous avez d’autres suggestions, publiez-les sur [/en-US/kb/writing-guide-knowledge-base-articles/discuss le forum de discussion de cet article].{/note} __TOC__ ==Ton== Écrivez en gardant la marque à l’esprit. Mozilla, c’est le choix de l’utilisateur ou de l’utilisatrice. Nous croyons en la liberté et la flexibilité. Nous attachons de l’importance à la vie privée et à la sécurité. Nous sommes une organisation à but non lucratif animée par une communauté de bénévoles du monde entier qui partagent des valeurs communes. Il n’est pas nécessaire de marteler cette histoire chaque fois que vous écrivez un article. C’est juste quelque chose à garder à l’esprit lorsque vous décrivez des fonctionnalités. ==Style d’écriture== Écrivez pour un public général et non technique. Nous voulons que nos articles soient utilisables par tout le monde, pas seulement par les utilisateurs et utilisatrices avancées. Cela signifie que nous écrivons pour un public général plutôt que pour un public très familier avec les techniques et la terminologie informatiques. Supposez que la personne pour qui vous écrivez ne sait pas comment modifier les préférences ou ajouter un bouton à la barre d’outils sans instructions pas à pas. Nous devons également supposer qu’elle n’a modifié aucun des paramètres par défaut de l’application ou du système d’exploitation. Pour résumer, vous devriez suivre ces lignes directrices : #'''Soyez bref.''' Les gens viennent à la base de connaissances en cherchant des solutions rapides. Ils ne se soucient peut-être pas du fonctionnement interne de l’outil – ils veulent juste savoir ce qu’'''ils''' doivent faire pour le réparer. N’hésitez pas à supprimer des mots. Voyez tout ce que vous pouvez exprimer avec moins de mots. C’est comme de la poésie ! #'''Soyez clair.''' Évitez le jargon. Soyez précis. Utilisez dans le titre et dans l’article des mots que la personne qui lit utiliserait. Si votre neveu de 13 ans ne le comprend pas, écrivez-le pour qu’il le comprenne. Consultez la section suivante pour un guide plus complet. #'''Soyez amical, amusant et empathique (en bref : soyez humain).''' D’accord, les utilisateurs et utilisatrices ne s’attendent pas à s’amuser en consultant l’assistance. C’est ce qui rend cela puissant. Égayez la journée de la personne qui vous lit avec un peu d’humour. Mais veillez à ne pas sacrifier la clarté en utilisant des métaphores ou des expressions amusantes. Si vous ne savez pas comment trouver cet équilibre, écrivez simplement des instructions directes et utilisez ce ton dans l’introduction ou la conclusion. #'''Racontez une histoire.''' Ayez un début, un milieu et une fin. Mais n’écrivez pas un roman (voir la ligne directrice n° 1). #*'''Début :''' cela donne au lecteur ou à la lectrice un peu de contexte. De quoi parle cet article et pourquoi devrais-je m’y intéresser ? Soyez bref. #*'''Milieu :''' les instructions vont ici. Cela devrait répondre à « Comment puis-je faire cela ? » #*'''Fin :''' y a-t-il des étapes suivantes à l’article ou à la fonctionnalité ? Dites à la personne qui lit où elle doit aller ensuite si elle veut en savoir plus. Lisez la section suivante pour des lignes directrices plus complètes. ==Style d’écriture (exhaustif)== *'''Style d’écriture conversationnel''' – Utilisez un style informel et actif semblable à la manière dont vous parleriez en personne à quelqu’un. *'''Humour et émotion''' – L’utilisation de l’humour est une bonne chose, mais il est parfois difficile, voire impossible, de le localiser. Les émotions comme la surprise et « Je ne savais pas ça/Eurêka ! » pourraient être plus faciles à inclure. *'''Multiples styles d’apprentissage''' – Comme à l’école, les gens apprennent différemment. Ainsi, tout le monde tire profit de voir le même contenu exprimé de multiples façons. *'''Répétition''' – Quand vous expliquez quelque chose de différentes manières avec différents médias, vous êtes évidemment en train de le répéter, ce qui est un autre bon moyen d’aider les gens à se souvenir de ce qui est important. *'''Images et vidéo''' – Utiliser des images et des vidéos avec du texte est non seulement ce qui se rapproche le plus d’une aide en personne, mais c’est aussi un moyen facile d’inclure plusieurs styles d’apprentissage et la répétition. Trop d’images, cependant, peuvent rendre la localisation d’un article plus difficile, alors essayez de n’ajouter des images que lorsque c’est utile pour une étape ou un concept. Par exemple, pour une étape qui consiste à cliquer sur un bouton, vous pourriez dire « Cliquez sur {button OK} » au lieu d’ajouter une capture d’écran de la boîte de dialogue de ce bouton. *'''Activités''' – Particulièrement dans un tutoriel, il est bon de donner aux gens quelque chose d’utile à accomplir. C’est une chose de lire des instructions et de comprendre le processus, mais il est souvent utile de rappeler aux gens d’essayer les choses et de leur en donner les moyens. ==Types d’articles== L’utilisation de types de contenu cohérents pour nos articles de la base de connaissances présente de nombreux avantages, notamment une navigation plus facile et une clarté et une organisation améliorées, en plus de nous aider à créer du contenu plus efficacement. Nous sommes en train de passer à une catégorisation des articles externes de la base de connaissances en quatre types, chacun ayant un objectif spécifique : *'''À propos''' : ces articles répondent aux questions « Qu’est-ce que… », en fournissant des informations essentielles pour aider les lecteurs et lectrices à comprendre un sujet. *'''Tutoriel''' : ces articles se concentrent sur les réponses aux questions « Comment… ? », en guidant les lecteurs et lectrices à travers les étapes nécessaires pour atteindre un objectif ou une procédure spécifique. *'''Dépannage''' : ces articles aident les utilisateurs et utilisatrices à identifier, diagnostiquer et résoudre les problèmes courants qu’ils peuvent rencontrer avec un produit, un service ou une fonctionnalité en répondant aux questions « Comment… ? » liées à la résolution de problèmes. *'''FAQ''' : ces articles contiennent des réponses concises aux questions fréquemment posées sur un seul sujet, qui peuvent ne pas trouver leur place dans d’autres articles individuels de la base de connaissances, fournissant une référence rapide pour les demandes courantes. ==Commencer par un titre efficace et descriptif== Un titre bien conçu est plus qu’une simple étiquette ; c’est le premier point de contact d’un utilisateur ou d’une utilisatrice avec votre article de la base de connaissances. Un bon titre doit non seulement attirer l’attention de la personne qui lit, mais aussi servir d’aperçu concis et informatif du contenu de l’article. Lors de la création de titres pour SUMO, tenez compte des points suivants : *'''Clarté et description :''' correspondez à ce dont parle l’article et à ce que la personne recherche. Soyez concis, mais centré sur l’utilisateur ou l’utilisatrice. *'''Inclusion de mots-clés :''' incorporez des mots-clés pertinents pour améliorer la visibilité dans les moteurs de recherche et aider les gens à trouver votre article. *'''Concision :''' gardez des titres brefs tout en fournissant des informations adéquates. Les titres plus courts sont often plus conviviaux. Essayez de garder des titres d’environ 60 caractères *'''Orienté vers l’action :''' utilisez des verbes d’action le cas échéant pour indiquer ce que les utilisateurs et utilisatrices peuvent faire pour résoudre un problème ou atteindre un objectif. Évitez d’utiliser des gérondifs (mots se terminant par « ing » en anglais) dans les titres pour vous assurer qu’ils restent orientés vers l’action. Évitez d’utiliser des titres contenant « Comment… » ==Rédiger une bonne introduction== Avec le titre et la table des matières, l’introduction est ce qui aidera l’utilisateur ou l’utilisatrice à déterminer s’il ou si elle est au bon endroit. *'''Pour un article de type « À propos » :''' fournissez un aperçu textuel ou une définition du concept et concentrez-vous sur la raison pour laquelle la personne qui lit devrait s’y intéresser. *'''Pour un article de type « Tutoriel » :''' fournissez un aperçu textuel ou une définition de la tâche et concentrez-vous sur l’importance ou les avantages de la tâche. *'''Pour un article de type « Dépannage » :''' décrivez le problème spécifique ou les symptômes que les utilisateurs et utilisatrices peuvent rencontrer. Rédigez dans un langage clair et concis, en évitant le jargon technique autant que possible. Gardez à l’esprit qu’une bonne introduction peut généralement servir de bon résumé de recherche. Souvent, vous pouvez simplement la copier dans le champ « Résumé pour les résultats de recherche » et c’est tout. ==Organiser l’article efficacement== L’idée générale ici est d’essayer de construire des compétences de la plus simple à la plus complexe tout en essayant de garder les informations nécessaires à la plupart des gens en haut. Donc une solution simple et courante viendrait généralement avant une solution complexe ou un cas limite. ==Rendre les instructions pas à pas faciles à suivre== La chose principale à garder à l’esprit lors de la rédaction d’instructions pas à pas est de veiller à inclure toutes les actions nécessaires pour accomplir la tâche. Si, par exemple, vous devez cliquer sur {button OK} après avoir sélectionné une préférence pour passer à l’étape suivante, veillez à inclure le clic sur « OK » dans cette étape. Quelques points supplémentaires à prendre en compte : *Il y a toujours plusieurs façons d’arriver à un résultat. Nous devrions toujours choisir la façon la plus conviviale en utilisant l'[https://wikipedia.org/wiki/Graphical_user_interface interface utilisateur graphique] et les menus lorsque c’est possible. *Utilisez des phrases complètes pour décrire comment accéder à l’interface utilisateur. *Incluez les résultats attendus lorsque vous donnez des instructions (par exemple, ''Cliquez sur « OK » et la fenêtre se fermera.''). ==Lisibilité== Le texte doit être lisible. Pour ce faire, vous devez : * Diviser un article en petits blocs logiques/sémantiques avec des sous-titres. * Utiliser des listes numérotées ou à puces. * Rédiger des phrases courtes ou relativement courtes. * Éviter d’écrire de longs paragraphes. Il n’y a pas de limite à la quantité de texte. Plus il y a de matière, mieux c’est ; cependant, vous ne devez pas l’étoffer artificially. Fournissez uniquement des informations utiles, précieuses et nécessaires. ==Comment créer des liens vers la documentation externe de logiciels tiers== Lors de la création ou de la mise à jour d’articles qui impliquent des actions dans des logiciels tiers, tels que des systèmes d’exploitation ou des applications externes, il est crucial de fournir aux utilisateurs et utilisatrices des informations précises et fiables. Cependant, l’inclusion d’étapes directes pour ces logiciels dans nos articles peut présenter des défis : *'''Informations rapidement obsolètes :''' les mises à jour de logiciels tiers peuvent rendre nos instructions obsolètes, ce qui peut dérouter ou induire en erreur nos utilisateurs et utilisatrices. *'''Gourmand en ressources :''' le suivi et la mise à jour continus des étapes pour plusieurs plateformes externes nécessiteraient des efforts et des ressources considérables, ce qui n’est peut-être pas réalisable. ===Bonnes pratiques=== Pour garantir que nos utilisateurs et utilisatrices reçoivent les informations les plus fiables et les plus à jour sans surcharger nos ressources, suivez ces bonnes pratiques : *'''Lien vers les ressources officielles :''' chaque fois que les instructions impliquent un logiciel tiers, trouvez la documentation officielle ou les articles d’aide fournis par le fabricant du logiciel. Créez un lien vers ces ressources au lieu d’écrire les étapes directement dans nos articles. *'''Fournir un contexte :''' expliquez brièvement pourquoi vous dirigez la personne vers une page externe (par exemple : « Pour les étapes les plus récentes et les plus précises pour ajuster les paramètres de votre système, veuillez vous référer à la page d’assistance officielle de <nowiki>[nom du logiciel]</nowiki> »). *'''Vérifier les liens périodiquement :''' bien que nous visions à réduire la maintenance des instructions de tiers, il est toujours important de vérifier périodiquement que les liens externes sont toujours valides. Si vous remarquez qu’un lien est devenu obsolète ou brisé, recherchez un lien mis à jour vers la documentation officielle et soumettez une révision. *'''Avis de non-responsabilité sur le contenu externe''' Lorsque vous dirigez des personnes vers un lien externe, indiquez clairement qu’elles quitteront SUMO et que nous ne sommes pas responsables du contenu des sites externes. Un simple avertissement ou une note peut suffire (par exemple « Suivre ce lien vous redirigera vers un site web externe qui n’est pas exploité par Mozilla. »). ===Exemple=== Imaginez que vous rédigez un article sur la configuration d’une fonctionnalité de Firefox qui repose sur la modification des paramètres au niveau du système sur un Mac. Au lieu de décrire les étapes directement dans l’article, vous pourriez écrire : <blockquote> « ''Pour connaître les dernières étapes de réglage des préférences de votre système sous macOS, veuillez consulter la documentation d’assistance officielle d’Apple en visitant [https://support.apple.com/guide/mac-help/change-system-settings-mh15217/mac ce guide]. Veuillez noter que suivre ce lien vous dirigera vers un site web externe qui n’est pas exploité par Mozilla.'' » </blockquote> Cela garantit que vous suivez les instructions les plus récentes directement depuis la source. ==Lignes directrices techniques== * Pour apprendre à créer un nouvel article, consultez [[Create a new Knowledge Base article]]. * Pour apprendre à modifier un article existant, consultez [[Edit a Knowledge Base article]]. * Consultez [[About the Knowledge Base]] pour un aperçu du fonctionnement de la base de connaissances. * Consultez [[Improve the Knowledge Base]] pour une liste complète de la documentation sur les articles. ==Titre== * Longueur du titre : la page de résultats de recherche de Google affiche jusqu’à 60 caractères. Votre titre peut être plus long si nécessaire, mais assurez-vous que vos mots-clés importants sont inclus dans les 60 premiers caractères. * Casse : utilisez la casse de phrase. Le premier mot du titre doit être en majuscule, ainsi que les [https://wikipedia.org/wiki/Proper_noun noms propres] et les noms, et non chaque mot principal. Utilisez le [https://reviewediting.wordpress.com/2012/07/10/titles-sentence-style-or-headline-style/ style « phrase », pas le style « titre »] (il en va de même pour les titres de section). Consultez la section [[#w_style-guide-and-copy-rules|Guide de style et règles de rédaction]] ci-dessous pour d’autres règles sur la capitalisation. * N’utilisez pas le signe deux-points dans le titre de l’article, car cela empêche la création d’un lien wiki vers cet article ([https://bugzilla.mozilla.org/show_bug.cgi?id=749835 bogue 749835]). Assurez-vous également de ne pas avoir d’espaces supplémentaires dans le titre de l’article, ce qui empêchera également les liens wiki de fonctionner. * Essayez de varier la façon dont vous nommez les articles. N’utilisez pas les mêmes mots ou phrases dans chaque titre. Par exemple, ne commencez pas toujours les articles par « Comment » et évitez d’utiliser des noms de tâches en « ing » comme « Setting the home page ». * N’oubliez pas que toute l’explication ne doit pas figurer dans le titre. Vous pouvez utiliser le résumé pour donner à la personne qui lit des informations supplémentaires sur le contenu de l’article. ==Slug== Lorsque vous créez un nouvel article et saisissez un titre, SUMO crée automatically un ''slug'' (la partie après <code>kb/</code> à la fin de l'[https://wikipedia.org/wiki/Uniform_resource_locator URL] de l’article). Une personne chargée de la relecture peut modifier le titre d’un article existant, mais le slug reste le même, sauf s’il est modifié manuellement (c’est voulu). Le slug est limité à 50 caractères. Les espaces sont remplacés par des tirets. Le slug doit être cohérent avec le titre, mais compte tenu de la contrainte d’espace plus stricte, il n’a pas besoin d’être le même. ===Corriger le slug=== Veillez à vérifier la fin du slug généré automatiquement. Parfois, un mot est coupé ou il se termine par un tiret. Veuillez corriger ce genre de choses. ===Mettre à jour le slug d’un article existant=== Lorsque vous mettez à jour le titre d’un article existant, ne modifiez pas le slug actuel, sauf si le nouveau titre représente un changement important qui ne correspond plus au slug existant. Garder le slug cohérent permet d’éviter les liens brisés et de préserver la valeur SEO. ==Catégories, produits et sujets== Pour la plupart, un article appartient soit à la catégorie ''Tutoriel'', soit à la catégorie ''Dépannage''. Occasionnellement, nous écrivons des articles dans l’une des autres catégories, comme les articles « Comment contribuir » (comme celui-ci). La page d’historique de l’article indique la catégorie. Les articles sont également « pertinents pour » au moins un produit. Ils appartiennent également à un « sujet » principal et, éventuellement, à un « sous-sujet ». {note}'''Note :''' veuillez noter que la catégorie ''Administration'' masque les articles des recherches publiques tout en autorisant l’accès par URL. Utilisez cette catégorie lors de la configuration de contenu qui doit rester masqué temporairement. Par exemple, cela peut être utile pour les articles liés à une prochaine version de Firefox, qui nécessitent une localisation mais ne doivent pas être découvrables dans les recherches publiques pour le moment. Les articles peuvent être déplacés vers une autre catégorie chaque fois que nécessaire en modifiant les métadonnées de l’article, comme expliqué [[Edit a Knowledge Base article#w_edit-description-reviewers-only|ici]].{/note} ==Mots-clés== Le champ des mots-clés dans un article peut être utilisé pour améliorer les résultats de recherche sur SUMO. Il ne devrait néanmoins être utilisé que sous certaines conditions bien particulières, sa mauvaise utilisation pouvant biaiser la recherche. Nous avons rarement besoin d’utiliser les mots-clés. Pour en savoir plus, consultez l’article [[When and how to use keywords to improve an article's search ranking]]. ==Rédiger un bon résumé de recherche== Le résumé de l’article, ainsi que le titre, aide les utilisateurs et utilisatrices à juger si un article répondra à leur question. Nous appelons cela la « confiance de l’utilisateur » et cela a un impact direct sur les taux de clics. Même si nous proposons le bon article en haut de la liste des résultats de recherche, la personne doit faire le lien mental entre la requête de recherche et les résultats que nous affichons pour qu’elle clique sur l’article. Un résumé pour un article de tutoriel doit inclure les sujets traités dans l’article. Un article de dépannage doit essayer d’inclure les symptômes. De plus, un résumé doit suivre ces lignes directrices : * Court et direct. Vous vous souvenez des petites annonces ? Rédigez-le comme ça. Les moteurs de recherche peuvent couper tout ce qui dépasse 140 caractères. Si vous utilisez un résumé plus long, gardez les informations importantes au début. '''''Note :''' le logiciel de la base de connaissances affichera 20 caractères restants lorsque le résumé atteindra 140 caractères, car la limite de recherche interne est de 160.'' * N’utilisez pas de balisage wiki. * N’utilisez pas « Cet article explique » dans chaque résumé. Variez lorsque c’est possible. Voici d’autres phrases à envisager : ** Nous vous montrerons ** Nous vous expliquerons ** Cette page explique ** Cet article décrit ** Apprenez comment ==Nombre d’étapes== Lorsque vous guidez les utilisateurs et utilisatrices à travers un processus, envisagez d’utiliser des listes ordonnées (listes numérotées). C’est généralement une bonne pratique d’essayer de garder le nombre total d’étapes entre six et sept. ==Structure parallèle== Utilisez la même formulation ou le même modèle de mots pour chaque étape que vous écrivez. La structure parallèle est importante dans les articles de la base de connaissances, car elle rend les choses claires et faciles à suivre. Lorsque des éléments similaires ont un format cohérent, les utilisateurs et utilisatrices peuvent comprendre et accomplir les tâches plus facilement. Cette structure simplifie les instructions, réduit les erreurs et garantit que les informations sont transmises efficacement. Par exemple : # Trouvez '''Vider l’historique lors de la fermeture de Firefox'''. Si cette case est cochée : ## Cliquez sur le bouton {button Settings…}. ## Assurez-vous que '''Historique des formulaires et de la recherche''' n’est '''pas''' coché. ## Cliquez sur {button OK}. ==Repères directionnels== Les repères directionnels sont des références ou des indicateurs qui guident les utilisateurs et utilisatrices vers l’emplacement ou la position spécifique dans une interface utilisateur où ils doivent effectuer une action particulière. Ces repères aident les gens à naviguer et à interagir plus efficacement avec les logiciels, les applications ou les sites web. Ils comprennent généralement des phrases comme « Dans le coin supérieur droit », « Dans le menu de gauche » ou « Sous la barre de recherche », qui donnent aux utilisateurs et utilisatrices une idée claire de l’endroit où trouver et effectuer des actions. Dans les instructions de vos articles de la base de connaissances, veillez à fournir des repères directionnels '''avant''' l’action. Par exemple, au lieu de dire ''Cliquez sur le bouton'', utilisez ''Dans le coin supérieur droit, cliquez sur le bouton''. Ce format aide les utilisateurs et utilisatrices à localiser et à effectuer facilement des actions dans l’interface. =Guide de style et règles de rédaction= Comme nous l’avons dit précédemment, vous devez utiliser un style actif et conversationnel lorsque vous écrivez. Évitez de dire des choses comme « Si les marque-pages d’un utilisateur ont été perdus » et dites plutôt « Si vous avez perdu vos marque-pages ». Voici d’autres problèmes courants de style et de rédaction que vous pouvez rencontrer lors de la rédaction d’articles d’assistance : '''Utilisez toujours les termes tels qu’ils apparaissent dans l’interface de Mozilla.''' Par exemple : *''Plugins'' n’a pas de trait d’union. *''Add-ons'' a un trait d’union. *''Home page'' est en deux mots. '''Termes informatiques généraux :''' *[https://wikipedia.org/wiki/Website Website] (site web) est en un seul mot. [https://wikipedia.org/wiki/Web_page Web page] (page web) est en deux mots. *''Log in'' et ''log out'' sont des verbes. Exemple : « Log in to the website. » Il en va de même pour ''sign in'' et ''sign out''. N’utilisez pas « log into » ou « sign into ».<!-- https://design.firefox.com/photon/copy/word-list.html#s --> *''Login'' et ''logout'' sont des noms (généralement utilisés comme adjectifs). Exemple : « Click the login button. » *Utilisez ''email'' au lieu d’''e-mail''. *Le pluriel de CD-ROM est CD-ROMs. '''Les liens vers mozilla.org ne doivent pas contenir la locale :''' *Utilisez https://www.mozilla.org/ au lieu de https://www.mozilla.org/en-US/ '''Lorsque vous incorporez des liens dans des phrases :''' *Évitez d’utiliser « cliquez ici » ou « ici » comme texte de lien. **'''À faire :''' allez dans les paramètres de votre compte pour annuler votre abonnement. **'''À ne pas faire :''' cliquez ici pour annuler votre abonnement. '''Mettez en majuscule les éléments suivants :''' *Les [https://wikipedia.org/wiki/Proper_noun noms propres] et les noms, y compris les noms de marque, de produit et de fonctionnalité *Le premier mot d’une phrase complète *Les lettres des abréviations et des acronymes, sauf s’ils sont normalement en minuscules *Le premier mot des listes numérotées ou à puces *Le nom d’une touche du clavier *Le premier mot d’une phrase complète suivant un deux-points *Le premier mot d’un titre de section ou d’article '''Mozilla accounts:''' *Le « a » de Mozilla accounts est toujours en minuscule, sauf dans les éléments de navigation où il est inclus avec d’autres éléments de navigation qui utilisent la casse de titre. *Utilisez toujours « sign in » et « sign out ». *Sous forme de verbe, utilisez « sign in to your account » (et non « sign into ») pour être grammaticalement correct. *Vous pouvez également utiliser « Sign in with Mozilla ». *« Sign » doit toujours être utilisé comme un verbe. Si vous l’utilisez comme un nom, utilisez « login ». *Utilisez « sign up » comme appel à l’action pour créer un nouveau compte. Pour plus de détails sur la façon de faire référence aux comptes Mozilla dans les articles de la base de connaissances, consultez [[Editorial guidelines for Mozilla accounts]]. '''N’utilisez pas [https://theoatmeal.com/comics/ie « i.e. » et « e.g. »]'''. Ces abréviations latines peuvent dérouter les gens. Par souci de clarté, utilisez « c’est-à-dire » ou « autrement dit » au lieu de i.e. lorsque vous voulez expliquer quelque chose d’une manière différente. Utilisez « par exemple » ou « comme » au lieu de e.g. lorsque vous voulez donner des exemples. '''N’utilisez pas de [https://en.wikipedia.org/wiki/Serial_comma virgules de série] dans une liste d’éléments.''' Par exemple, utilisez « Extensions, thèmes et plugins » (sans la virgule de série), et non « Extensions, thèmes, et plugins ». '''Utilisez des sigles''' qui sont considérés comme étant généralement compris. Par exemple : *HTTP *USB *URL Les '''nombres''' apparaissant dans la version d’un produit, les codes d’erreur, les touches et les boutons ne seront pas écrits en toutes lettres. '''Rédigez les instructions à la voix active.''' La voix active et le temps présent simplifient les instructions, les rendant plus faciles à suivre et encourageant une action rapide. Exemple : « Redémarrez Firefox pour mettre à jour » '''et non''' « Firefox doit être redémarré ». '''Épelez les barres obliques inverses (\\) et les barres obliques (/)''' pour les chemins et les recherches afin d’éviter toute confusion. Exemple : « Certains chemins d’accès aux images contiennent des barres obliques inverses (\\\\) ». '''Raccourcis clavier''' Mettez en majuscule la première lettre d’un raccourci clavier ou d’une combinaison de raccourcis : {key Ctrl+Shift+C} ou {key Command+Shift+C}. '''N’utilisez pas d'[https://courses.lumenlearning.com/englishforbusiness/chapter/4-8-slang-and-idioms/ argot et d’expressions idiomatiques]'''. Tous nos articles sont traduits dans de nombreuses langues différentes, ils sont donc lus et traduits par des personnes dont l’anglais n’est pas la langue maternelle. L’argot et les expressions idiomatiques peuvent être ambigus, ce qui peut dérouter les lecteurs et lectrices et rendre la traduction plus difficile. '''Nous avons des styles visuels spéciaux pour un certain nombre d’éléments qui peuvent être obtenus en ajoutant le balisage wiki approprié autour de l’élément.''' Consultez [[Markup cheat sheet]] pour les styles les plus courants. '''Nous avons un balisage wiki spécial – <nowiki>{</nowiki>for<nowiki>}</nowiki> – qui vous permet de cibler des informations pour des versions spécifiques de Firefox ou des systèmes d’exploitation spécifiques.''' Par exemple, vous affichez un ensemble d’instructions pour les personnes exécutant Windows et un autre pour les personnes utilisant macOS X (voir [[How to use "For" tags]] pour plus de détails).

Dellu ci Jaar-jaar bi