Compte-rendu de la 35ème réunion de l’équipe Documentation du 17 mai 2024

La 35e réunion de l’équipe de la documentation de WordPress en français s’est tenue le vendredi 17 mai 2024 à 13h heure française, en visio.

Ordre du jour

  • Point avancement.
  • Point sur les mises à jour de la documentation.
  • News diverses.
  • Projet de transfert de la documentation sur GitHub et traduction.
  • Sujet remis à discussion : Comment documenter les nouveaux écrans listant les données ?

Personnes présentes

Point avancement

Depuis la dernière réunion du 11 avril 2024 :

  • +1 article traduit (266 sur 298 soit 89.3%)
  • +2 articles rédigés (21 sur 36 soit 58.3%) et 3 nouvelles idées d’articles

Le pourcentage global d’avancement est de 85.9% (valeur la plus élevée atteinte !).

  • Pas de nouvel article publié côté doc en anglais.
  • Un article est en attente d’une seconde relecture : Écran Compositions de l’éditeur de site

📌Idées d’articles : « Documenter le Playground » ou « WP CLI »…
Consultez le tableau de suivi > Articles FR et n’hésitez pas à rédiger/suggérer des articles. Indiquez votre pseudo ou prénom entre parenthèses à côté du titre.

Point sur les mises à jour de la documentation

  • Pas trop de nouveautés liées à 6.5.3.
  • Difficultés à identifier les mises à jour d’articles, car l’équipe EN ne travaille plus sur WP mais sur Google docs.
  • Le Notion a été mis à jour pour refléter l’avancement des mises à jour des articles.
  • Attention à ne pas prendre de l’avance sur des fonctionnalités à venir et sujettes à changements.

6.3

Il reste un seul article à mettre à jour pour la 6.3, mais il doit être mis aussi à jour pour la 6.5, on peut donc considérer les mises à jour de la 6.3 terminées.

6.4

40 mises à jour : 26 faites + 1 en cours + 13 à faire (dont 4 en commun avec 6.5) donc finalement 9 à faire au titre de la 6.4

6.5

28 mises à jour : 6 faites + 1 en cours + 21 à faire

News diverses

Projet de transfert de la documentation sur GitHub et traduction

C’est un projet en cours porté par l’équipe de la locale Espagnol pour que la documentation soit hébergée sur GitHub et qu’un répertoire par locale soit créé, il n’y a pas vraiment d’avancée ni de communication officielle. Il n’y a rien à faire de notre côté pour l’instant.

Voir les liens ci-dessous pour plus d’informations :

Sujet remis à discussion : Comment documenter les nouveaux écrans listant les données

Après avoir discuter du sujet lors de la dernière réunion.

Une piste serait de faire un article générique (titre à définir en français) qui décrirait de façon générique les écrans qui affichent des listes de publications, de modèles ou encore de compositions, et d’y renvoyer l’internaute depuis des écrans spécifiques. Il s’agit par exemple de l’écran Pages accessible depuis Pages > Gérer toutes les pages dans l’éditeur de site.

🚩 On opte pour patienter pour l’instant, en attendant que ces écrans soient plus aboutis dans Gutenberg.

La réunion se termine par une présentation de ces différents écrans qui n’affichent pas les mêmes éléments mais qui fonctionnent de la même manière.


La réunion se termine à 14h40 (quels bavards!).

La prochaine réunion aura lieu le jeudi 6 juin 2024.

#compte-rendu, #documentation-fr

Ordre du jour de la 35ème réunion de l’équipe Documentation du 17 mai 2024

La 35ème réunion de l’équipe documentation de WordPress en français aura lieu le vendredi 17 mai 2024 à 13h heure française, sur le slack.

À l’ordre du jour :

  • Point avancement.
  • Point sur les mises à jour de la documentation.
  • News diverses.
  • Projet de transfert de la documentation sur GitHub et traduction.
  • Sujet remis à discussion : Comment documenter les nouveaux écrans listant les données ?

Le lien d’invitation pour la visioconférence sera communiqué juste avant la réunion, sur le canal #documentation-fr du Slack WordPress-fr.

#ordre-du-jour

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

Ordre du jour de la 34ème réunion de l’équipe Documentation du 11 avril 2024

La 34ème réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 11 avril 2024 à 13h heure française, sur le canal #documentation du Slack WordPress-fr.

À l’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.

#ordre-du-jour

Compte-rendu de la 33ème réunion de l’équipe Documentation du 7 mars 2024

La 33ème réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 7 mars 2024 à 13h heure française, sur le canal #documentation-fr du slack WordPress Fr.

Ordre du jour

  • Point avancement.
  • Mises à jour pour la version 6.5.
  • Modification de l’orthographe du terme en-tête.
  • Refonte du site de la documentation.

Personnes présentes

Point avancement

Depuis le dernier point avancement du 8 février :

  • +4 articles traduits (261 sur 298 soit 87.6%) ;
  • aucun nouvel article rédigé (19 sur 33 soit 57.6%).

Le pourcentage global d’avancement est de 84.6%

Il n’y a pas de nouvel article publié sur la documentation en anglais, donc aucun article nouveau n’a été importé.

Concernant les mises à jour pour les versions 6.3 et 6.4, depuis le 8 février 2024 :

  • 3 articles ont été mis à jour ;
  • 1 est en cours de mise à jour ;
  • 14 restent à faire.

Mises à jour pour la version 6.5

Les issues pour la mise à jour de la documentation pour la version 6.5 n’ont pas encore été publiées dans le issue tracker de la documentation de WordPress. Dès qu’elles le sont, il faudra les reporter dans notre espace Notion.

Il est demandé aux membres de l’équipe de signaler les articles à modifier. Béryl nous indique les articles Bloc Groupe, Bloc Galerie, Créer une favicon. Jenny ajoute une étiquette 6.5 dans les cartes correspondantes sur Notion.

Modification de l’orthographe du terme en-tête.

Dans l’équipe de traduction, nous avons décidé de respecter la réforme de l’orthographe de 1990 pour le terme « en-tête » qui s’écrit donc « entête ». En conséquence pour que la documentation soit conforme à l’interface de WP, il faudra mettre à jour les articles où se terme apparaît.

Il y a 48 articles concernés par cette modification.

📌 On se propose de faire les modifications dans un intervalle court, voire en même temps sur tous les articles, lorsque la modification sera effective dans l’interface de WordPress.
Il n’y a pas d’urgence à faire ces modifications.

Refonte du site de la documentation

Comme le site fr.wordpress.org a été récemment migré vers le nouveau thème, on se pose la question de faire une demande pour migrer la documentation de WordPress en français, pour avoir un site similaire à wordpress.org/documentation.

Pour l’instant, aucune locale n’a encore fait de modification pour sa documentation, et on ne sait pas si c’est possible.

Jenny souhaitait avoir les avis des membres de l’équipe à ce sujet, pour décider si on fait une demande en ce sens.
Béryl nous communique un document dans lequel se trouve une liste de souhaits pour le design de la documentation.

La réunion touchant à sa fin, nous décidons d’en reparler ultérieurement.


La réunion se termine 14h09.

La prochaine réunion aura lieu le jeudi 11 avril 2024.

#compte-rendu, #documentation

Ordre du jour de la 33ème réunion de l’équipe Documentation du 7 mars 2024

La 33ème réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 7 mars 2024 à 13h heure française.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour pour la version 6.5.
  • Modification de l’orthographe du terme en-tête.
  • Refonte du site de la documentation.

La réunion se déroulera sur le canal #documentation-fr du Slack WordPress-fr à partir de 13h.

#documentation, #ordre-du-jour

Compte-rendu de la 30ᵉ réunion de l’équipe Documentation du 7 décembre 2023

La 30ᵉ réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 7 décembre 2023 à 13h heure française, sur le canal #documentation-fr du Slack WordPress-fr.

Ordre du jour

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.4.
  • Méthode pour la description des captures avec numéros (suite des échanges précédents).
  • Rythme et calendrier 2024 des réunions.
  • Questions diverses

Personnes présentes

Point avancement

Depuis la dernière réunion du 2 novembre 2023 :

  • 3 articles traduits (253 articles sur 298 soit 84.9%).
  • Pas de nouvel article rédigé.
  • 1 article importé (Twenty Twenty-Four).

Un pourcentage global d’avancement de 82.2%, bon résultat qui est la conséquence d’un rythme de 3/4 articles traduits depuis quelques mois.

À noter également : l’équipe Documentation en anglais est concentrée sur les mises à jour plutôt que sur de nouveaux articles pour le moment.

Mise à jour de la documentation pour la version 6.4

Toutes les issues définies par la team Doc en anglais pour la version 6.4 ont été reportées dans notre Notion.
Pas évident de trier les mises à jour selon leur statut car il y a chevauchement avec différentes versions.

Jenny a établi les statistiques suivantes pour se faire une idée :

Pour les modifications liées à la version 6.3 (56) :

  • 33 sont terminées (59%)
  • 5 en cours (9%)
  • 18 à faire (32%)

Pour les modifications liées à la version 6.4 (40) :

  • 9 sont terminées (23%)
  • 5 en cours (12%)
  • 26 à faire (65%)

Rappel du fonctionnement

Dans le tableau Notion sont indiquées les versions concernées. Quand un article est étiqueté pour plusieurs versions, il est recommandé de rédiger la mise à jour selon la dernière version, et donc d’incorporer aussi les versions précédentes.

Lorsqu’un article est mis à jour, les personnes s’inscrivent dans le tableau de suivi dans les colonnes correspondantes à leur intervention (auteur modifs ou relecture). Le tableau Notion est renseigné par Marie ou Jenny.

Méthode pour la description des captures avec numéros (suite des échanges précédents)

Rappel : sur certaines captures d’écran, il est parfois utile de mettre des pastilles numérotées dont les numéros sont repris dans le texte pour bien décrire l’élément de l’interface dont a fonctionnalité est détaillée.
Des applications comme Greenshot (Windows) ou Snip (Mac) aident à placer la numérotation sur les captures d’écran.

Le mois dernier nos discussions ont un peu dévié de « comment décrire les captures avec des pastilles numérotées ? » (au fil du texte vs sous forme de listes numérotées) à « faut-il généraliser ce procédé ? ».

Il est clair que l’annotation avec des pastilles numérotées n’est pas attendue des contributeurs et il n’est pas souhaitable de la généraliser car elle est très chronophage, et pose des problèmes d’accessibilité.

Recommandation pour la description des captures avec numéros :
Cette méthode n’est absolument pas à généraliser, elle demeure facultative et doit être réservée aux nouvelles interfaces ou à des manipulations complexes.
Cependant si cette méthode est utilisée la description se fait alors au fil du texte, avant ou après la capture avec le numéro placé entre parenthèses : il est ainsi plus facile de décrire l’emplacement de l’élément décrit.
D’autre part afin de s’assurer que les lecteurs d’écran ignorent ces numéros, il est proposé de placer des balises <span aria-hidden="true">(1)</span> autour de ces numéros.

Rythme et calendrier 2024 des réunions

Le rythme d’une réunion par mois est conservé pour le moment, de manière à permettre à un maximum de personnes de se joindre aux discussions et à l’équipe.
Le premier jeudi du mois est conservé comme rendez-vous mensuel.


La réunion se termine à 14 heures.

La prochaine réunion aura lieu le jeudi 11 janvier 2024 (exceptionnellement pas le premier du mois ;))

#compte-rendu

Ordre du jour de la 30ème réunion de l’équipe Documentation du 7 décembre 2023

La 30ème réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 7 décembre 2023 à 13h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.4.
  • Méthode pour la description des captures avec numéros (suite).
  • Rythme et calendrier 2024 des réunions.
  • Questions diverses…

La réunion se déroulera sur le canal #documentation-fr du Slack WordPress-fr à partir de 13h.

#ordre-du-jour

Ordre du jour de la 29ème réunion de l’équipe Documentation du 2 novembre 2023

La 29ème réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 2 novembre à 13h heure française, sur Slack.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation.
  • Méthode de description des captures.
  • Questions diverses.

La réunion se déroulera sur le canal #documentation-fr du Slack WordPress-fr à partir de 13h.

#documentation, #ordre-du-jour

Compte-rendu de la 28ème réunion de l’équipe Documentation du 12 octobre 2023

Ordre du jour

  • Point avancement.
  • Mise à jour de la documentation.
  • Bilan de la journée de contribution du 5 octobre 2023, à Biarritz.
  • Questions diverses.

Participants

Point avancement

Depuis la dernière réunion du 7 septembre 2023 :

  • +4 articles traduits (247 sur 297 soit 83.2%).
  • 1 article en attente de relecture.
  • Pas de nouvel article rédigé directement en français.

Le pourcentage global d’avancement est de 80.6%.

Bilan de la journée de contribution du 5 octobre 2023 à Biarritz

  • 4 articles traduits
  • 1 article en cours de traduction, presque finalisé

Bilan plutôt positif pour nous trois, la journée a été productive.

Nous avons apprécié d’avoir un écran pour présenter des slides et/ou faire des démos.

Jenny aurait voulu parler de Learn, mais n’en a pas eu le temps, peut être proposer une table Learn à un prochain CD ?

Il a manqué une conclusion en fin de journée (sorte de bilan).

Questions diverses

Marie demande s’il est envisageable de changer l’heure de la réunion qui tombe en pleine pause déjeuner.

📌Après échange, on va plutôt essayer de faire les réunions sur slack, toujours de 13h à 14h.

Si besoin, on peut faire ponctuellement une réunion visio.


La réunion se termine à 13h50.

La prochaine réunion aura lieu le jeudi 2 novembre 2023 à 13 heures sur le slack.

#compte-rendu, #documentation-fr