Projet WordPress

Cette page contient les détails d'un projet de rédaction technique accepté pour Google Season of Docs.

Résumé du projet

Organisation Open Source:
WordPress
Rédacteur technique:
dmivelli
Nom du projet:
Améliorer la visibilité des articles dans la documentation HelpHub de WordPress
Durée du projet:
Durée standard (3 mois)

Project description

Executive Summary

La popularité de WordPress ne cesse de croître. Début juillet 2020, WordPress 5.4 (la dernière version publiée le 21 mars 2020) a été téléchargé près de 51 millions de fois. La langue la plus couramment utilisée est l'anglais (71%), suivi de l'espagnol (4,7) et de l'indonésien (2,4).

Une documentation technique de qualité est à la base de tout système d'aide. Des rédacteurs techniques expérimentés apportent leurs connaissances aux utilisateurs. Les utilisateurs cherchent à effectuer une action qui leur est utile ou qui leur est demandée à ce moment-là. Les rédacteurs techniques de qualité savent qu'une documentation précise et bien rédigée est essentielle, et qu'ils doivent savoir se mettre à la place de l'utilisateur. Toutefois, ce qui compte le plus pour un rédacteur technique, comme la qualité éditoriale et de production, peut être moins important pour les utilisateurs que la rapidité d'exécution et la visibilité. À quoi sert un sujet d'aide bien écrit si l'utilisateur ne le trouve pas ?

Depuis ses débuts en 2003, la croissance de WordPress dans l'univers Open Source a attiré des développeurs, des utilisateurs et des contributeurs. Les catégories d'articles et les balises d'origine doivent être mises à jour et modernisées pour suivre la croissance et l'évolution des besoins de la communauté WordPress.

Lorsque les chemins des utilisateurs vers la documentation demandée sont déroutants ou interrompus, leur recherche échoue, ils perdent confiance dans le produit et risquent de l'abandonner complètement.

Il existe une solution. Voici quelques méthodes pour améliorer la visibilité et prendre en charge le chemin utilisateur vers la documentation attendue:

  1. Définir le style des titres des catégories
  2. Évaluez les titres des catégories et assurez-vous qu'ils traitent correctement des sujets (proposez des mises à jour, si nécessaire).
  3. Consulter les articles et vous assurer que les catégorisations sont correctes
  4. Définir des sous-catégories pour chaque article
  5. Assurez-vous qu'aucun résultat de recherche ne redirige les utilisateurs vers les forums d'assistance
  6. Signaler les sujets en double ou obsolètes à supprimer

La communauté WordPress a accompli un travail remarquable et partage les réussites de ces 17 dernières années. Mettre à jour la catégorisation et s'assurer que le parcours utilisateur est précis va continuer à stimuler la croissance, le succès et la fidélité des utilisateurs qui créent près de 70 millions de nouveaux posts et 77 millions de nouveaux commentaires chaque mois.

Introduction

L'auteur Joseph Campbell a inventé le terme "Hero's Journey". Dans la fiction, il s'agit du concept structurel selon lequel le protagoniste voyage dans le monde, fait face à des défis et les surmonte, et revient se transformer.

Dans le domaine de la documentation technique, l'utilisateur s'embarque également dans un parcours qui le redirige vers les rubriques d'aide dans le but d'apprendre, d'obtenir des réponses et de résoudre des problèmes. Lorsque l'utilisateur peut accomplir cela, tout se passe bien dans son monde. Lorsque les utilisateurs ne trouvent pas de réponse, ils partent frustrés et découragés.

Mais pourquoi cela se produit-il ? Ce n'est pas parce que les scénaristes s'en trompent, s'en inquiètent pas ou n'ont pas le savoir-faire. Souvent, c’est que le rédacteur technique n’a pas tenu compte du parcours utilisateur. Les rédacteurs peuvent s'immerger dans la création de contenu de qualité, mais ne tiennent pas compte de la façon dont l'utilisateur accédera au sujet. Se concentrer sur le parcours utilisateur est essentiel. Nous devons tenir compte de ce qu'ils veulent savoir et de la manière dont ils veulent y parvenir.

J'ai discuté avec Estela Rueda, consultante WordPress et conceptrice UX, qui m'a fourni des informations sur l'histoire. Actuellement, certains titres ne décrivent pas correctement le contenu des articles. Les catégories sont utilisées comme des tags et, comme elles ont été créées il y a 15 ans, certaines sont obsolètes. Les tags ne sont pas cohérents. Cela crée des obstacles pour les utilisateurs qui cherchent des réponses.

État actuel

L'assistance WordPress se divise en neuf catégories principales (Premiers pas, Installation de WordPress, Utilisation de base, Administration basique, Personnalisation, Maintenance, Sécurité, Rubriques avancées, Dépannage). Chaque catégorie contient plusieurs sous-catégories ou sous-thèmes qui mènent à des articles avec de nombreuses possibilités sur chaque page de destination.

L'avantage d'avoir des contributeurs WordPress enthousiastes et collaboratifs est que de nombreux sujets sont disponibles. Cependant, les points de vue et les points de vue sont nombreux, mais le taggage et les catégories sont incohérents.

Ces thèmes doivent être modernisés pour que les catégories répondent aux besoins actuels des utilisateurs de WordPress. Avec plus de 200 articles, les problèmes liés aux balises et aux catégories sont devenus pertinents.

Analyse du plan

L'objectif principal est d'examiner et de reclasser les articles afin d'améliorer votre visibilité. Je propose les étapes suivantes:

  1. Travailler avec la mentor Estela Rueda pour consolider le processus

    • Il s'agit d'une étape importante pour s'assurer que les détails sont confirmés et convenus
    • Per Estela, nous suivrons toutes les modifications proposées dans une feuille de calcul. D'après l'expérience d'Estela, il est préférable de recueillir, puis de proposer des recommandations.

  2. Définir le style des titres des catégories

    • Je suggère une structure uniforme et cohérente pour les catégories au présent plutôt que sous la forme gérond (installation ou installation), car la forme gérondique (-ing) peut créer des difficultés pour les utilisateurs de l'anglais en tant que deuxième langue (ESL), et l'ing n'ajoute aucune valeur à l'utilisateur
    • Certaines catégories sont des sujets d'un ou deux mots (par exemple, "Maintenance", "Sécurité", "Administration de base") et d'autres sont des expressions génériques (Premiers pas avec WordPress, Personnalisation). Il est judicieux d'aborder la cohérence de la structure.
    • J'ai cherché comment d'autres organisations configurent leur aide en ligne et j'en parlerai avec mon mentor pour voir ce qui pourrait être utile.

  3. Évaluer les titres des catégories (et proposer des mises à jour)

    • Ils doivent être reconnaissables du point de vue de l’audience cible de WordPress et répondre à ses besoins actuels.
    • Vérifier leur cohérence et leur conformité avec les normes du guide de style WordPress
    • S'assurer que les titres transmettent/expliquent l'intention
    • Les titres doivent préciser les actions préalables requises ou les états de l'utilisateur/de l'appareil.

  4. Consulter des articles/thèmes

    • Les thèmes répondent-ils correctement aux besoins des utilisateurs de l'audience cible de WordPress ?
    • Les sujets définissent-ils le contexte approprié ou font-ils partie d'une séquence plus importante ?
    • Les étapes distinguent-elles les différents acteurs de la tâche (utilisateur, système/appareil, qui fait quoi) ?
    • Les acteurs sont-ils clairement identifiables ?
    • Les étapes divisent-elles les processus complexes en morceaux exploitables ?

  5. Définir et taguer des sous-catégories

    • Reportez-vous aux histoires d’utilisateurs et continuez à les ajouter à la feuille de calcul pour référence ultérieure
    • Continuez à compléter la liste des sous-catégories et détaillez leur chemin

  6. Assurez-vous qu'aucun résultat de recherche ne redirige les utilisateurs vers les forums d'assistance

  7. Notez les sujets en double ou obsolètes à supprimer ; ce travail d’investigation aidera à informer et à simplifier le parcours utilisateur

Chronologie

Jusqu'au 16 août 2020

  • Continuer à examiner la documentation WordPress
  • Familiarisez-vous avec le style de documentation WordPress
  • Rechercher les bonnes pratiques concernant les parcours client dans les rubriques d'aide

17 août – 13 septembre

  • Familiarisez-vous avec Estela et la communauté WordPress
  • Collaborer avec Estela pour affiner les étapes du projet et suggérer des étapes de réalisation
  • Créer un calendrier pour inclure des jalons et des tâches hebdomadaires
  • Définissez la cadence d'un contrôle de situation avec Estela (afin de remédier aux obstacles en temps opportun).

14 septembre – 30 novembre

  • Lancement et développement du projet avec Estela/mentors

2-5 décembre

  • Envoyer le rapport final du produit de travail

Du 3 au 10 décembre

  • Envoyer une évaluation de la réussite du projet et de son expérience de travail avec les mentors et l'équipe WordPress

Conclusion

WordPress est le système de gestion de contenu (CMS) le plus populaire. D'après W3techs, WordPress est le CMS de prédilection pour 37,7% des sites Web, soit 63,6% des parts de marché des CMS.

Avec un tel degré de popularité, une documentation précise et facile à suivre est indispensable pour séduire l'utilisateur de WordPress.

En tenant compte du parcours utilisateur et des questions qui guident les parcours utilisateur possibles, WordPress peut moderniser les catégories d'aide et les balises pour répondre efficacement aux questions et résoudre les problèmes. De cette façon, WordPress continuera d'attirer des clients satisfaits pour les années à venir.