Ce modèle décrit les normes pour la rédaction d'articles bien informés. Utilisez les articles de la base de connaissances d'Apple comme exemple : https://support.apple.com/en-ca/HT207935
Titre
Le titre de l'article doit refléter le contenu de l'article pour une reconnaissance facile et pour faciliter la recherche.
Exemples : « Comment supprimer une chanson ? », « Bienvenue sur Anytune iPhone/iPad »
Des lignes directrices
- Évitez de créer des articles en double. Recherchez attentivement avant de créer.
- Commencez par "Titre 2" pour les titres. Le titre de l'article est Heading 1 et il ne devrait y en avoir qu'un.
- Mettez en majuscule les noms de produits et les noms de boutons de texte :
Appuyez sur le bouton Modifier. Ne pas mettre les commandes en gras. - Utilisez l'image du tableau du bouton (svg) d'une taille de 22 pixels de haut lorsque le bouton utilise une icône :
Appuyez sur Restaurer - Utilisez des guillemets pour sélectionner les options :
3. Choisissez "Tuned Song" et "Email" - Pour suivre une hiérarchie, utilisez :
Allez dans Anytune Menu > Fichiers > Config Exporter > Exporter vers un fichier... - Utilisez des listes numérotées pour les étapes d'une procédure.
Les étapes se terminent par une période. - Les titres des procédures sont H@ et se terminent par deux points. Exemple : « Titre de la procédure : »
- Lorsque les étapes sont différentes pour les versions du produit, créez plusieurs sections avec un titre de description à 3 titres
- Utilisez des puces pour les listes.
- Maintenir le contexte du client
- Souvenez-vous du public
- Ne pas référencer un client
- S'abstenir d'abréviations et d'acronymes
- Assurez-vous que tous les liens fonctionnent
Étiquettes
Incluez des étiquettes appropriées avec les articles. Les étiquettes influencent la pertinence de la recherche d'articles et les résultats des robots de réponse. Ils peuvent également être utilisés pour créer des listes d'articles.
Utilisez un seul mot dans la mesure du possible et n'utilisez pas de variantes du même mot. Utilisez les étiquettes avec parcimonie.
Exemples : macOS, importation, bluetooth, ReFrame
Modèle
Résumé de ce que cet article vous dira.
Utiliser la rubrique 3 pour le processus et pour distinguer les plateformes
- Étapes du processus
- Appuyez sur le
Bouton d'aide
- Choisissez "E-mail"
- Appuyez sur Modifier
Sur Mac, le processus est
Remarque : Fournissez des notes dans <p class="anytune-note">note</p>
Avertissement : Fournissez des notes dans <p class="anytune-warning">note</p>
Soulignez en mettant en évidence avec <p class="anytune-highlight">note</p>
En savoir plus (H3)
Dites à l'utilisateur où se trouvent plus d'informations par des liens .
Comment corriger les problèmes
Lorsque l'article décrit comment résoudre un problème, incluez ces sections
- Problème : Décrivez le problème et essayez d'utiliser les mots du client.
- Environnement : décrivez la configuration et la configuration auxquelles ce correctif s'applique (facultatif)
- Résolution : ce sont les étapes pour résoudre
- Cause : quel scénario a causé ou peut avoir causé le problème
- Libellés : incluez des mots qui se rapportent à l'article en question pour vous aider
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.