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 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 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

Ordre du jour de la 28ème réunion de l’équipe Documentation du 12 octobre 2023

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

À l’ordre du jour :

  • Point avancement.
  • Bilan de la journée de contribution du 5 octobre.
  • Temps ouvert aux participants – Questions diverses

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 27ème réunion de l’équipe Documentation du 7 septembre 2023

La vingt septième réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 7 septembre 2023 à 13h heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Mise à jour de la documentation.
  • Passage à GitHub pour la documentation officielle en anglais.
  • Organisation de la journée de contribution.
  • Réunion d’octobre depuis Biarritz ?
  • Question libres.
  • Information : restructuration du handbook.

Personnes présentes

Point avancement

Depuis la dernière réunion du 4 mai 2023 :

  • +5 articles traduits (243 sur 297 soit 81.8%), 1 en mai, 1 en juillet et 3 en août.
  • +1 article rédigé (19 sur 33 soit 57.6%) en août
  • +15 articles importés (1 en mai, 4 en juin, 2 en juillet, et 8 en août)

Le pourcentage global d’avancement est de 79.4% sans tenir compte du Codex, 74.5% en incluant le Codex.

Mise à jour de la documentation

On est à jour pour les mises à jour de 6.1, partiellement pour les versions 6.2 et 6.3 (qui vient de sortir). Les mises à jour des versions 6.2 et 6.3 peuvent être effectuées en même temps, cela simplifie la tâche.

Si vous souhaitez participer à la mise à jour de la documentation, consultez la liste de Mise à jour des articles pour savoir quels articles nécessitent des modifications. En cliquant sur une carte pour l’ouvrir, les modifications à effectuer sont indiquées, dans le cas contraire, consultez les issues GitHub. N’hésitez pas à poser vos questions dans le canal #documentation du slack.

Passage à GitHub pour la documentation officielle en anglais

La documentation US (« officielle ») passe sur GitHub : les articles de documentation seront rédigés sur Github et importés automatiquement sur le site de documentation wordpress.org/documentation.

Les locales, donc nous, ne somme pas concernés pour l’instant.

Organisation journée de contribution

Une journée de contribution à WP est organisée la veille du WordCamp Biarritz par l’association WPFR, soit le 5 octobre 2023. Une table Documentation sera présente.

Jenny et Marie (à minima) l’animeront, si vous souhaitez vous joindre à nous, manifestez-vous :).

Réunion d’octobre depuis Biarritz ?

Non, on aura pas le temps lors de la journée de contribution.

On décale la réunion au 12 octobre, on en profitera pour faire un compte rendu de la journée de contribution.

Questions libres

Question de Cécile : je reprends la contribution à la doc, y a t’il eu des changements importants, et quelles sont les priorités ?

Réponse : pas de changement majeur. Prioriser les articles sur les blocs et les nouvelles fonctionnalités en général (command palette, éditeur de site…) mais avant tout s’attaquer aux articles qui nous plaisent (même si ils sont anciens).

Information : restructuration du handbook FR

Le handbook a été restructuré durant l’été, pour accueillir trois grandes sections :

  • Traduction
  • Documentation
  • Learn

Consulter le handbook

Il peut maintenant accueillir plus facilement de nouvelles sections pour d’autres équipes de contribution à WP.


La réunion se termine à 14 heures.

La prochaine réunion aura lieu le jeudi 12 octobre 2023.


Merci à Marie pour la prise de notes pendant la réunion qui facilite grandement la rédaction de ce compte-rendu.

#compte-rendu, #documentation-fr

Ordre du jour de la 27ème réunion de l’équipe Documentation du 7 septembre 2023

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

À l’ordre du jour :

  • Point avancement.
  • Mises à jour de la documentation (pour les versions 6.1, 6.2 et 6.3).
  • Préparation de la journée de contribution.
  • Prochaine réunion depuis Biarritz ?
  • Temps ouvert aux participants.

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 25ème réunion de l’équipe Documentation du 6 avril 2023

La vingt cinquième réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 6 avril 2023 à 13h heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Journée de contribution du 20 avril 2023.
  • Sommaire des articles sur les blocs.
  • Accès à la documentation sur les blocs à partir de leur nom en anglais

Personnes présentes

Point avancement

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

  • +9 articles traduits (233 sur 282 soit 82.6%).
  • aucun nouvel article rédigé.
  • +1 article importé.

Le pourcentage global d’avancement est de 80.2%.

Concernant les mises à jour liées à la version 6.1 :

  • sur les 32 avec priorité forte : 19 sont terminées, 9 sont en cours et 4 sont à faire.
  • sur les 29 avec priorité moyenne : 23 sont terminées, 5 sont en cours et 1 reste à faire.

Concernant les mises à jour liées à la version 6.2 :

  • Pour l’instant 56 articles ont été répertoriés comme étant à modifier.
  • Parmi ces 56, 3 sont d’ores et déjà à jour depuis le 28 mars 2023, puisque nous avons effectué les modifications liées aux version 6.1 et 6.2, simultanément.

Journée de contribution du 20 avril 2023

Il y aura une table dédiée à la contribution à la documentation. La répartition, entre les différentes tables, des personnes inscrites à cette journée est assez homogène. On attend donc environ 8 personnes à la table documentation.

Marie présentera le fonctionnement de l’équipe documentation et le processus de traduction/rédaction des articles. Jenny sera présente (à distance – sur le slack et éventuellement en visio) pour aider les participants.

Les contenus proposés pour cette journée de contribution sont :

  • Les contenus de Learn WP définis comme prioritaires par l’équipe Training, listés dans le tableau de suivi.
  • Les articles sur les blocs, auxquels il faut appliquer la « mutualisation des contenus ».
  • Éventuellement, la rédaction d’articles.

Sommaire des articles sur les blocs

Le nombre d’articles décrivant les blocs devient conséquent (il y en a plus de 50), aussi le menu s’allonge et cela nuit à la clarté de la page d’accueil de la documentation. Comme il existe un article nommé « Les blocs » qui les présente tous par catégorie et dans le même ordre que dans l’éditeur de WordPress, et qui contient des liens vers chacun des articles décrivant un bloc, il nous paraît opportun d’utiliser cet article comme « sommaire ».

Pour que les internautes soient incités à utiliser cet article pour accéder à un article dédié à un bloc en particulier, il faut que son titre soit plus explicite, par exemple : « Liste des blocs » ou « Liste complète des blocs ».

📌Notre choix se porte sur « Liste complète des blocs » car plus explicite sur le contenu attendu de l’article.
L’article « Les blocs » sera donc renommé, et les éléments de menu correspondant aux articles dédiés aux blocs seront supprimés.

Accès à la documentation sur les blocs à partir de leur nom en anglais

Il s’agit de la suggestion suivante de Loïc :

Je pensais une chose : moi j’utilise jamais la doc en français pour Gut.
Je pourrais le faire parce qu’elle est vraiment bien faite et notamment pour les blocs qui sont très nombreux, mais il y a quelque-chose qui me bloque à chaque fois, et ça n’est pas une affaire de goût mais bien de praticité : la concordance des noms FR/EN des blocs.
Il m’est arrivé quelques fois de me poser une question sur un bloc donc je découvrais/redécouvrais l’existence via une lecture du code ou via un article de blog (eux toujours ou presque en anglais), et je me disais : tiens je suis sûr que sur la doc FR y’aura la réponse sur tel détail qui m’intéresse, mais je ne savais pas quel était le nom en français. Alors oui pas pour les classiques dont on peut deviner le nom en français mais pour d’autres.
Donc je me disais : est-ce que dans le sommaire, pour les blocs uniquement, est-ce qu’il ne serait pas possible de mettre leurs noms anglais entre parenthèse ?

Cette suggestion est compréhensible mais ouvre la voix à beaucoup de questions de cohérence. Car si nous commençons à mettre les termes en anglais (tels qu’ils sont dans l’interface) à côté de leur traduction en français dans la documentation pour les blocs, alors cela surchargera le texte et nous perdrons en lisibilité, et il nous faudrait le faire pour d’autres éléments d’interface comme par exemple les menus du tableau de bord.

📌Pour l’instant, il n’est donc pas envisagé d’apposer la traduction anglophone des termes utilisés dans les titres des articles.


La réunion se termine à 14 heures.

La prochaine réunion aura lieu le jeudi 4 mai 2023.

#compte-rendu, #documentation-fr