Mise à jour du contenu des articles

WordPress est un outil en constante évolution, la mise à jour de sa documentation est donc incontournable, surtout si l’on veut atteindre l’objectif d’être utile aux utilisateurs et utilisatrices.

À chaque nouvelle version de WordPress, des fonctionnalités sont ajoutées, d’autres sont modifiées ou encore remplacées. S’il est assez fastidieux de suivre ces évolutions, il existe néanmoins des sources qui permettent de le faire, grâce à l’équipe qui gère la documentation officielle en anglais.

Ainsi pour chaque version de WordPress, un tableau de bord de projet concernant les documentations relatives à WordPress, à savoir : documentation utilisateur, documentation développeur, les notes de développement et le guide des changements techniques, est créé. Voici par exemples ceux des versions 6.0 et 6.1.

Autre source pour mettre à jour la documentation utilisateur : le documentation-issue-tracker qui permet, en triant les issues par version et/ou par priorité, de connaître les modifications à apporter.

Pour nous organiser, deux documents ont été créés :

  • Un kanban sous Notion nommé Modification des articles qui reprend les « issues » sélectionnées.
  • Une feuille nommée « MAJ Articles » permettant de suivre ces mises à jour d’articles a été créé dans le tableau de suivi.

Méthodologie pour effectuer les mises à jour

Étape 1 : définir les articles à modifier et les modifications à effectuer

La liste des articles à modifier est établie à partir de la liste des « issues » en ne tenant compte que des « issues » classées en « priorité haute » dans un premier temps.

Ensuite, il faut définir les modifications à effectuer dans l’article. Lorsque celles-ci sont définies, alors l’état « En cours » est affecté à l’article dans la liste des modifications à effectuer, et l’article est ajouté dans le tableau de suivi.

Étape 2 : réalisation des modifications

Lorsqu’une personne décide d’effectuer des modifications sur un article de la liste proposée dans le tableau de suivi, il lui faut indiquer son pseudo wp.org dans la colonne « Auteur modifs », puis modifier la valeur à « En cours de modification » dans la colonne « Statut ».

Puis, il faut accéder à l’article pour l’éditer et y effectuer une première modification, puis cliquer sur le bouton Select an action situé à côté du bouton Mettre à jour, puis cliquer sur Save for later dans le menu déroulant.

Capture d’écran montrant comment créer une publication de type Update

Dans la colonne latérale des réglages de l’article, dans la section Save for later, sélectionnez une date assez éloignée pour laisser le temps aux relecteurs de valider les modifications, puis cliquez sur le bouton Save update. Cela a pour effet de créer une copie de l’article dans une publication complètement déconnectée de l’article original.

Le message suivant s’affiche confirmant la création d’un article de type Update :

  • Si vous cliquez sur Continue editing your update, vous restez dans l’éditeur (logiquement c’est cette option que vous devez choisir).
  • Si vous cliquez sur Edit original article, vous retournez sur l’article original.
  • Enfin, si vous cliquez sur View all article updates, vous affichez l‘écran Updates (aussi accessible via le menu Articles, puis Updates).
Capture d’écran montrant le menu Updates sous le menu Articles
Capture d’écran montrant l’écran Updates

Dans l’éditeur, vous disposez donc maintenant d’une copie de l’article original avec une première modification. Poursuivez le travail de mise à jour du contenu de l’article.

Ajoutez en fin d’article la composition « Journal des modifications », disponible dans la liste des compositions accessible via l’Outil d’insertion de bloc puis Compositions puis My patterns et modifier la ligne qui s’y trouve avec les bonnes informations, ou, si le journal est déjà présent, ajoutez-y une ligne avec la date prévue pour la publication, par exemple :

Capture d’écran montrant un exemple de mention des modifications effectuées sur un article

Soyez précis dans votre description des modifications effectuées car celle-ci servira de base à la personne qui réalisera la relecture.

Lorsque vous avez terminé vos modifications (et de temps en temps) cliquez sur le bouton Update afin d’enregistrer vos modifications. Notez que ce bouton Update (à la place de Mettre à jour) vous signale que vous êtes bien sur une publication de type Update.

Étape 3 : demander la relecture

Avant de quitter l’éditeur, copiez l’url de votre article mis à jour (votre update), puis la coller dans le tableau de suivi dans la colonne « URL Update », ce qui facilitera l’accès pour la personne qui effectuera la relecture.

Sélectionnez ensuite le statut « En attente de relecture » puis faites un court message dans le canal #documentation-fr du Slack WordPressFR pour demander la relecture.

Étape 4 : relecture

Dans le tableau de suivi, la personne qui effectue la relecture modifie le statut de l’article à « En cours de relecture » et indique son pseudo wp.org dans la colonne « Relecteur », puis accède à l’article modifié via le lien de la colonne « URL Update ».

La relecture nécessite de prendre connaissance des modifications réalisées qui sont listées dans le journal des modifications situé en fin d’article, et de valider celles-ci en ayant vérifié qu’elles sont conformes à l’interface et/ou au fonctionnement de WordPress pour la dernière version en date ou la version pour laquelle les modifications ont été réalisées.

Si certaines modifications ne sont pas correctes ou sont à discuter, il faut alors changer le statut de l’article mis à jour à la valeur « A revoir » dans le tableau de suivi et en informer la personne qui a fait les modifications.

Si les modifications sont correctes, le relecteur ou la relectrice peut choisir de laisser WordPress publier automatiquement à la date planifiée, ou publier immédiatement.

S’il ou elle publie immédiatement, il faudra au prélable modifier avec la date du jour, les dates indiquées en bas de l’article de manière à ce que la date de dernière mise à jour et la date de la dernière modification dans le journal soient identiques, comme ci-dessous :

Dans tous les cas, il faut ensuite :

  1. Laisser WordPress publier l’article automatiquement à la date planifiée (non recommandé) en cliquant sur le bouton Update avant de quitter l’éditeur (si des modifications ont été apportées) ou publier immédiatement en cliquant sur le bouton Select an action puis sur l’élément de menu Publish now (voir capture ci-dessous).
Capture d’écran montrant comment publier immédiatement

Lorsque l’article de type Update est publié, il remplace l’article original.

  1. Passer le statut à « Publié » dans le tableau de suivi et modifiez l’état à « Terminé » dans la liste des modifications à effectuer dans l’espace de travail sous Notion.

Le relecteur ou la relectrice partage l’avancement dans le canal #documentation-fr du slack.

s
recherche
c
rédiger un nouvel article
r
répondre
e
modifier
t
aller en haut
j
aller à l’article ou au commentaire suivant
k
aller au précédent article ou commentaire
o
change la visibilité du commentaire
esc
Annuler la modification de l'article ou du commentaire