Projet WordPress

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

Résumé du projet

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

Project description

Synthèse

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ée près de 51 millions de fois. L'anglais est la langue la plus utilisée (71 %), suivi de l'espagnol (4,7 %) et de l'indonésien (2,4 %).

Une documentation technique de qualité est l'épine dorsale de tout système d'aide. Les rédacteurs techniques expérimentés transforment leurs connaissances en contenus destinés aux utilisateurs. Les utilisateurs cherchent à effectuer une action qui leur est utile ou requise à ce moment-là. Un bon rédacteur technique comprend que la documentation claire et précise, ainsi que la capacité à se mettre à la place de l'utilisateur, sont essentielles. 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é et la visibilité. À quoi sert un article d'aide bien rédigé si l'utilisateur ne peut pas le trouver ?

Depuis ses débuts en 2003, la croissance de WordPress dans le domaine de l'Open Source a attiré des développeurs, des utilisateurs et des contributeurs. Les catégories et balises d'articles 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 d'accès des utilisateurs à la documentation demandée sont confus ou interrompus, leur recherche échoue, ils perdent confiance dans le produit et peuvent l'abandonner complètement.

Il y a une solution. Voici des moyens d'améliorer la visibilité et d'aider l'utilisateur à accéder à la documentation attendue:

  1. Décider et définir le style des titres de catégorie
  2. Évaluer les titres des catégories et s'assurer qu'ils correspondent correctement aux sujets (proposer des modifications, si nécessaire)
  3. Examinez les articles et assurez-vous que les catégories 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 des forums d'assistance.
  6. Noter les sujets en double ou obsolètes à supprimer

La communauté WordPress a accompli un travail remarquable et partage les réalisations de ces 17 dernières années. En actualisant la catégorisation et en veillant à ce que le parcours utilisateur soit précis, nous continuerons de favoriser 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 de "parcours du héros". Dans la fiction, il fait référence au concept structurel selon lequel le protagoniste se lance dans un voyage dans le monde, fait face à des défis et les surmonte, puis revient transformé.

Dans le domaine de la documentation technique, l'utilisateur se lance également dans un parcours qui l'oriente vers les rubriques d'aide dans le but d'apprendre, d'obtenir des réponses et de résoudre les problèmes. Lorsque l'utilisateur peut le faire, tout va bien dans son monde. Lorsque les utilisateurs ne trouvent pas de réponses, ils quittent votre site avec frustration et découragement.

Mais, pourquoi cela se produit-il ? Ce n'est pas parce que les scénaristes prennent des raccourcis, ne s'en soucient pas ou ne disposent pas du 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 contenus de qualité, mais ne tiennent pas compte de la façon dont l'utilisateur accédera au sujet. Il est essentiel de se concentrer sur le parcours utilisateur. 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 donné quelques informations sur l'histoire de cette fonctionnalité. Actuellement, certains titres ne décrivent pas correctement le contenu de l'article. Les catégories sont utilisées comme balises. Comme elles ont été créées il y a 15 ans, certaines sont obsolètes. Le taggage n'est pas cohérent. Cela crée des obstacles pour les utilisateurs qui cherchent des réponses.

État actuel

L'assistance WordPress est divisée en neuf catégories principales (Premiers pas, Installation de WordPress, Utilisation de base, Administration de base, Personnalisation, Maintenance, Sécurité, Thèmes avancés, Dépannage). Chaque catégorie contient plusieurs sous-catégories ou sous-thèmes qui mènent à des articles, et il est possible d'en trouver d'autres sur chaque page de destination.

L'avantage d'avoir des contributeurs WordPress enthousiastes et collaboratifs est que de nombreux sujets sont disponibles. Cependant, avec de nombreuses voix et points de vue, le taggage et les catégories ne sont pas cohérents.

Ces sujets doivent être modernisés pour s'assurer 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égorisations sont devenus pertinents.

Analyse du plan

L'objectif principal est d'examiner et de reclasser les articles afin d'améliorer leur visibilité dans les résultats de recherche. Je vous propose les étapes suivantes:

  1. Collaborez 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 acceptés.
    • Comme indiqué par Estela, nous allons suivre toutes les mises à jour proposées dans une feuille de calcul (l'expérience d'Estela a montré qu'il est préférable de rassembler les informations, puis de proposer des recommandations)

  2. Définir le style des titres de catégorie

    • Je suggère une structure uniforme et cohérente pour les catégories au présent au lieu de la forme gerund (installation ou installation), car le formulaire gerund (-ing) peut créer des difficultés pour les utilisateurs de l'anglais comme deuxième langue (ESL) et ce -ing n'apporte aucune valeur à l'utilisateur
    • Certaines catégories sont des sujets composés d'un ou deux mots (comme "Maintenance", "Sécurité" et "Administration de base"), tandis que d'autres sont des expressions verbales (comme "Premiers pas avec WordPress" et "Personnalisation"). Il est donc logique de discuter de la cohérence de la structure.
    • J'ai étudié la façon dont d'autres organisations configurent leur aide en ligne et je vais en discuter avec mon mentor pour voir ce qui pourrait être utile.

  3. Évaluer les titres de catégorie (et proposer des modifications)

    • Ils doivent être reconnaissables du point de vue de l'audience cible de WordPress et répondre à ses besoins actuels.
    • Vérifiez qu'ils sont cohérents et respectent les normes du guide de style WordPress.
    • Assurez-vous que les titres transmettent/expliquent l'intent
    • Les titres doivent préciser les actions préalables requises ou les états de l'utilisateur/de l'appareil

  4. Examiner les articles/thèmes

    • Les thèmes répondent-ils précisément 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 vaste ?
    • Les étapes distinguent-elles les différents acteurs de la tâche (utilisateur, système/appareil, qui fait quoi) ?
    • Les acteurs sont-ils clairement distingués ?
    • Les étapes décomposent-elles des processus complexes en fragments exploitables ?

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

    • Reportez-vous aux histoires d'utilisateurs et continuez à ajouter des éléments à la feuille de calcul pour référence ultérieure.
    • Continuez à ajouter des sous-catégories à la liste et à détailler leur chemin d'accès.

  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. Cette analyse vous aidera à optimiser et à simplifier les parcours utilisateur.

Chronologie

Jusqu'au 16 août 2020

  • Poursuivre la consultation de 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

  • Découvrez Estela et la communauté WordPress, et collaborez avec eux
  • Collaborer avec Estela pour affiner les étapes du projet et suggérer des jalons à atteindre
  • Créer un calendrier incluant des jalons et des tâches hebdomadaires
  • Définissez une fréquence de suivi de l'avancement avec Estela (pour résoudre rapidement les problèmes bloquants).

14 septembre – 30 novembre

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

2-5 décembre

  • Envoyer le rapport final sur le produit

3 au 10 décembre

  • Envoyer une évaluation du succès du projet et de l'expérience 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 privilégié par 37,7% des sites Web, ce qui représente 63,6% des parts de marché des CMS.

Avec un tel niveau de popularité, une documentation précise et facile à suivre est indispensable pour gagner le cœur des utilisateurs de WordPress.

En tenant compte du parcours utilisateur et des questions qui guident les chemins possibles, WordPress peut moderniser les catégories d'aide et le taggage pour répondre efficacement aux questions et résoudre les problèmes. WordPress continuera ainsi d'attirer des clients satisfaits pendant des années.