Primerjaj revizije

Guide général pour écrire les articles de la base de connaissances

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__ ==Pour qui écrivons-nous les articles ?== 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== Quand nous choisissons un titre pour un article, nous voulons essayer de faire correspondre ce que les gens recherchent à la question qu'ils pourraient vous poser en personne. Voici des exemples de types de titres que vous devriez choisir : *Pour un tutoriel ou un article sur comment faire : comment je parviens à ce résultat ? (p.ex., Comment définir la page d'accueil ?) *Pour un article de référence : Qu'est-ce que le (Que sont les) « nom(s) de la fonctionnalité » ? (p.ex, Que sont les onglets épinglés ?) *Pour un article de résolution des problèmes : C'est le problème que je suis en train d'avoir (p.ex, Firefox met plusieurs minutes à démarrer) ==Techniques pour 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ù les unicornes utiliseront leurs pouvoirs arc-en-ciel pour devenir des bougies magiques qui, une fois consumées, vous fera devenir un ninja d'ordinateur de niveau 70. Êtes-vous réveillé maintenant ? Bien. Ce paragraphe semble un peu ennuyeux, au moins jusqu'à ce les unicornes apparaissent. L'utilisation de l'humour et des émotions (SURPRISE !) sont des techniques que nous pouvons utiliser pour captiver l'attention des gens. Ces techniques, que j'ai 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. ==Comment organiser 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. ==Comment 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, c'est à dire l'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 (c.-à-d., 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) == Guide de style SUMO == Comme nous en avons parler 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 : *Plugin n'a pas de trait d'union. *Popup n'a pas de trait d'union. '''Termes informatique généraux :''' *Internet a sa première lettre en majuscule. *Web a sa première lettre en majuscule. *Utiliser courrier électronique ou courriel plutôt qu'e-mail. * Les pluriels des acronymes ne prennent pas de s. '''Les liens vers mozilla.com ne devraient pas contenir la langue :''' *Utilisez http://www.mozilla.com/firefox au lieu de http://www.mozilla.com/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'un titre de paragraphe ou d'article '''Titres et sections''' Notre Wiki est affiché en utilisant HTML5 qui utilise l'élément <nowiki><section></nowiki>. Vous pouvez utiliser l'élément <nowiki><section></nowiki> autour d'un contenu lié. Ce que cela signifie pour les titres est que chaque section peut avoir son propre résumé au début avec un titre de niveau h1. '''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 [[Markup chart]] pour une liste complète).''' *{note}Note{/note} *{warning}Avertissement{/warning} *<code>Code</code> *{filepath Noms de fichier} et {filepath chemin/fichier} *Raccourcis clavier comme {key Ctrl+T} *Menus – {menu Firefox} *{button Boutons} '''Nous avons une balise Wiki spéciale (appelée "showfor") 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 [https://wiki.mozilla.org/Support/Kitsune/KB/WikiSyntax ce document en anglais] pour plus d'informations).