Compte-rendu de la 34ᵉ réunion de l’équipe Documentation du 11 avril 2024

La 34e réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 11 avril 2024 à 13h heure française, sur slack, avec un appel d’équipe pour pouvoir partager un écran.

Ordre du jour

  • Point avancement.
  • Vérification des mises à jour des versions 6.3 et 6.4.
  • Liste des mises à jour pour la version 6.5.
  • Comment documenter les nouveaux écrans listant les données.
  • Questions diverses.

Personnes présentes

Point avancement

Depuis la dernière réunion du 7 mars 2024 :

  • +4 articles traduits (265 sur 298 soit 88.9%)
  • +1 article rédigé en attente de relecture (19 sur 33 soit 57.6%)

Le pourcentage global d’avancement est de 85.2%

✔ Le taux d’avancement de 90% est presque atteint, les articles en cours de traduction lorsqu’ils seront publiés permettront probablement d’atteindre ce cap !

Vérification des mises à jour des versions 6.3 et 6.4

Pour la version 6.3

  • 31 articles sont à jour – soit 91%
  • 2 sont en cours de mise à jour
  • 1 article (Bloc Galerie) n’a pas été mis à jour (voir ce qu’il faut modifier pour la 6.3)

Pour la version 6.4

  • 16 articles sont à jour – soit 48.5%
  • 4 sont en cours de mise à jour
  • 13 articles restent à mettre à jour – le détail des issues n’a pas été vu

Liste des mises à jour pour la version 6.5

Pour la version 6.5

  • 4 articles sont à jour – soit 16%
  • 2 articles sont en cours de mise à jour
  • 19 articles sont à mettre à jour – le détail des issues n’a pas été vu

Comment documenter les nouveaux écrans listant les données

Le sujet concerne le fait que, dans l’éditeur de site, de nouveaux écrans sont disponibles pour lister les modèles, les éléments de modèles, les pages et les compositions.

Comment documenter ces nouveaux écrans dans les articles :

  • Écran Pages de l’éditeur de site (pour les pages)
  • Écran Compositions de l’éditeur de site (pour les compositions)
  • L’éditeur de modèles (pour les modèles et éléments de modèles)

ou

  • on crée un article pour l’ensemble de ces écrans (afin de ne détailler qu’une seule fois les fonctionnalités communes)

ou encore

  • on crée un article par écran ?

L’approche la plus plébiscitée est une approche centralisée (mutualisée) comme pour les réglages et outils communs des blocs. Mais aucune décision n’a été prise à ce sujet.

Jenny propose qu’en attendant que les écrans Pages et Articles (du tableau de bord) soient déplacés dans l’éditeur de site, on ne les documente pas dans des articles dédiés, mais seulement dans les articles de l’éditeur de site, tout en ajoutant un article sur les fonctionnalités communes à ces écrans (vue liste/grille, modifications groupées, pagination,…). Et que le jour où ces écrans sont uniquement dans l’éditeur de site, on mette à jour les articles qui leur correspondent avec la description de la nouvelle interface.

Mais Marie rappelle que les écrans Pages et Articles du tableau de bord ne vont pas disparaître rapidement, voire jamais pour des questions de rétrocompatibilité avec les thèmes classiques. Aussi l’approche de Jenny pose problème.

🚩Les membres de l’équipe sont invité·e·s à réfléchir à cette question, pour être en mesure de prendre une décision prochainement.

Questions diverses

Le Translation Day envisagé par l’équipe Traduction est abordé. Il aura probablement lieu avant l’été.

Laurent souligne qu’il serait intéressant de profiter de l’évènement pour faire savoir qu’il existe aussi un travail de traduction dans l’équipe documentation.

Tout le monde est convaincu qu’il est effectivement utile de faire connaître ce travail de traduction pour amener peut-être des personnes à s’intéresser à la documentation.

Par contre, il ne semble pas trop opportun de faire de l’initiation à la contribution à la documentation pendant l’évènement d’une part parce que ce n’est pas l’objet de l’évènement et d’autre part, au vu de la relative complexité d’intégrer de nouvelles personnes dans l’équipe (création d’un compte éditeur + droits sur le tableau de suivi), car souvent les personnes qui participent pendant un évènement de ce genre ne reviennent pas contribuer. Exemple des personnes qui ont été intégrées à l’équipe lors du Documentation Day du 17 juin 2022 et qui ne se sont plus manifestées après.


La réunion se termine à 14h05.

La prochaine réunion aura lieu le jeudi 2 mai 2024.

#compte-rendu, #documentation