Compte rendu de la 9ème réunion Documentation du 15 novembre 2021

La neuvième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 15 novembre 2021 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Point sur les articles à importer.
  • Réorganisation des catégories des articles de la documentation.
  • Documentation du FSE.

Personnes présentes

Avancement

Depuis la dernière réunion du 11 octobre 2021 :

  • 11 articles traduits (164 sur 237 soit 69.2%)
  • 2 articles rédigés (18 sur 29 soit 62.1%)
  • Le pourcentage global d’avancement est de 68.4%. On approche tranquillement des 70%.

Trois nouvelles personnes ont rejoint l’équipe : Loïc Antignac (@webaxones), Cécile Angays (@ciloo) et Patrick Olivaud (@pasglop).

Articles à importer

Dans la documentation en français, 35 articles sont manquants par rapport à la documentation en anglais.

28 articles concernent les blocs de contenus embarqués. Comme nous avons pris la décision de créer plutôt un article unique concernant les contenus embarqués, il n’est pas utile de les importer.

Il reste alors 7 articles à importer :

Réorganisation des catégories des articles de la documentation

Il s’agit de réorganiser les catégories des articles de la documentation qui comporte des doublons et des catégories vides, ce chantier a été initié lors de la 6ème réunion de documentation.

La suppression des catégories en doublons (mise à jour simultanée du tableau Liste des catégories) a été réalisée mais cela ne change pas grand chose à la colonne latérale gauche listant les catégories.

Côté documentation en anglais, la liste des catégories est affichée à l’aide d’un menu (construit manuellement) dans un widget, alors que nous nous utilisons le widget Catégories dans lequel nous ne pouvons faire aucun tri.

En dehors de l’aspect affichage, il y aurait matière à diminuer le nombre de catégories. Côté documentation en anglais : 27 catégories, côté documentation en français : 64.

Enfin, l’aspect référencement des catégories est abordé mais il n’y a pas de problème à supprimer des catégories car les pages d’archives de catégories ne semblent pas référencées.

Nous nous donnons rendez-vous ce vendredi 19 novembre à 15h pour poursuivre le travail de suppression et réorganisation des catégories.

Documentation du Full Site Editing (FSE)

La version 5.9 de WordPress sera disponible le 14 décembre 2021, cette version majeure intégrera le FSE (Full Site Editing), qui apporte de nouveaux écrans et concepts à WordPress.

Ces nouveautés doivent être documentées, et nous proposons de commencer dès à présent à rédiger du contenu destiné aux utilisateurs et utilisatrices.

Aucun contenu n’existe pour l’instant côté documentation EN, il faudra prévoir de comparer nos travaux aux leurs afin de vérifier si nous n’avons rien oublié.

Se pose la question des slugs d’articles, en effet ils doivent être identiques en FR et en EN pour que les liens relatifs soient fonctionnels. Nous décidons de générer des slugs en anglais pour nos articles, puis, lorsqu’un article anglais sera publié, nous pourrons adapter notre slug si besoin. Une redirection sera alors mise en place automatiquement pour la première modification de slug, ainsi nous éviterons les erreurs 404 (page non trouvée).

Voici une liste (en anglais) des éléments qui sont à documenter : https://github.com/orgs/WordPress/projects/11/views/4

Pour chaque élément, une issue GitHub est rattachée, elle détaille l’élément à documenter ou à mettre à jour :

Si vous souhaitez participer à la documentation du FSE, manifestez-vous sur le canal #documentation-fr du Slack WordPress-FR

Pour finir, lorsque vous créerez un articles, n’oubliez pas de mettre à jour le tableau Articles FR.

La prochaine réunion aura lieu le lundi 13 décembre 2021.