Compte rendu de la 15ème réunion de l’équipe Documentation du 9 mai 2022

La quinzième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 9 mai 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Organisation du Translation Day spécial Documentation.
  • Préparer la mise à jour de la documentation pour la version 6.0.

Personnes présentes

Point avancement

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

  • +4 articles publiés (197 sur 255 soit 77.3%)
  • +1 article importé
  • Pas d’article rédigé directement en français.

Le pourcentage global d’avancement est de 75.4%.

Organisation du Translation Day spécial Documentation

Lors de la dernière réunion, nous validions l’idée d’organiser un Translation Day spécial Documentation.

Nous proposions un évènement mi-présentiel mi-distanciel, en juin ou en septembre. Les personnes qui le peuvent pourraient suivre l’évènement en présentiel dans leurs groupes de meetups locaux, mais également en distanciel, et tous les groupes seraient connectés entre eux en visio-conférence.

Depuis, Jenny a contacté les équipes d’organisation des meetups de Toulouse, Nantes, Lille, Montpellier, Lyon et Nice afin de leur demander s’ils seraient en capacité d’organiser un tel évènement.
Pour l’instant, elle a reçu des réponses positives des équipes de Nantes, Lille et Toulouse, mais pour septembre s’il a lieu en présentiel, plutôt que juin.

Nous pensons qu’il est possible d’organiser un premier évènement uniquement visio-conférence au mois de juin et posons la date du vendredi 17 juin, de 12h à 15h.

Le but de cet évènement sera surtout de montrer que la documentation existe, décrire les process et outils utilisés et l’organisation de l’équipe, répondre aux questions.

Ce sera l’occasion de préparer des supports et du contenu pour un évènement en présentiel et distanciel en septembre, à fournir aux équipes des meetups locaux. Il serait pertinent que les organisateurs et organisatrices des meetups puissent participer à cet évènement distanciel de juin, s’ils le peuvent.

Si vous souhaiter participer à la préparation de supports et/ou ressources, signalez-vous sur le canal #documentation-fr du Slack WordPress francophone.

Pour finir, nous proposons d’appeler cet évènement le « Documentation Day » plutôt que « Translation Day Documentation » étant donné que nous travaillons désormais d’avantage sur la documentation que sur de la traduction en tant que telle.

Préparer la mise à jour de la documentation pour la version 6.0

La prochaine version majeure de WordPress, la 6.0, prévue pour le 24 mai 2022 apporte son lot de modifications dans le tableau de bord et l’éditeur de blocs, et nous allons devoir mettre à jour la documentation en conséquence.

Nous disposons de plusieurs sources de données pouvant nous aider à repérer les changements à apporter :

Il nous faut également trouver une méthode et un outil pour lister et organiser les modifications à faire. Nous avons parlé d’utiliser Notion et/ou un tableau partagé.

Nous continuons de réfléchir à la solution la plus adaptée, et vos suggestions sont les bienvenues.


La réunion se termine à 13H00.

La prochaine réunion aura lieu le 14 juin 2022 à midi, attention exceptionnellement la réunion aura lieu un mardi et non un lundi.

#compte-rendu

Ordre du jour de la 15ème réunion de l’équipe Documentation du 9 mai 2022

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

La quinzième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 9 mai 2022 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Organisation du Translation Day spécial Documentation.
  • Préparer la mise à jour de la documentation pour la version 6.0.

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 14ème réunion Documentation du 11 avril 2022

La quatorzième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 11 avril 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Nouvelles entrées du glossaire.
  • Application des modifications du HelpHub officiel ?
  • Programmer un Translation Day spécial Documentation ?

Personnes présentes

Avancement

Depuis la dernière réunion du 14 mars 2022 :

  • +5 articles traduits (193 sur 254 soit un pourcentage d’avancement de 76%).
  • +11 articles importés.
  • Pas d’article rédigé directement en français.
  • Le pourcentage global d’avancement est de 74.3%.

Sujets abordés

Nouvelles entrées du glossaire

Suite aux modifications apportées à l’article Glossaire lors de la journée de contribution Yoast, de nouvelles entrées ont été ajoutées. Il s’agit pour la plus grande partie d’entrées qui concernent les blocs, les thèmes basés sur des blocs et le FSE. Nous avions décidé à la précédente réunion d’intégrer ces nouvelles entrées.

Jenny a commencé de traduire ces nouvelles entrées et souhaiterait un coup de main. Les nouvelles entrées sont donc disponibles dans un brouillon d’article dédié. Si vous faites des propositions dans cet article, pensez à mettre votre nom dans le bloc contribution tout en bas de l’article.
Lorsque les entrées seront toutes traduites et validées, elles seront intégrées à l’article Glossaire.

Au fil de la discussion sur ce point JB découvre la liste suivante qu’il souhaiterait maintenir à l’avenir, reste à définir à quel emplacement.

Application des modifications du HelpHub officiel ?

Jenny signale que de nombreuses modifications sont en cours sur le HelpHub officiel en anglais : modifications concernant les catégories ainsi que les titres de certains articles qui vont probablement être modifiés (sans modification du slug).

Les questions posées ici sont, d’une part :

  • Répercutons-nous toutes les modifications ou seulement celles concernant les catégories ?
  • Ou répercutons-nous seulement les modifications qui nous semblent pertinentes ?

et d’autre part :

  • Répercutons-nous les modifications au fur et à mesure pour éviter de prendre du retard ?
  • Ou attendons-nous que les modifications soient terminées pour les répercuter ?

📌 Comme nous nous sommes quelque peu affranchis du HelpHub officiel en anglais (en rédigeant nos propres contenus, en effectuant des mutualisations de contenus,…), et que rien ne nous oblige à faire du HelpHub en français une réplique du HelpHub officiel, nous optons pour une répercussion des modifications au cas par cas en tenant compte de leur pertinence et nous décidons d’attendre que ces modifications soient terminées sur le HelpHub officiel en anglais.

Programmer un Translation Day spécial Documentation ?

À l’unanimité, l’idée nous semble bonne.

Nous décidons de nous laisser du temps pour l’organisation et de fixer cette journée après la mi-juin. Ce qui permettra d’en faire la promotion lors du WordCamp Europe de Porto.

📌 Nous réfléchissons donc à une date après le 15 juin 2022, et nous déciderons de cette date à la prochaine réunion du 9 mai. Dans le choix de la date, il faudra prendre en compte le jour qui nous paraît le mieux adapté (jour de semaine ou samedi).

Marie propose de faire un évènement mi-présentiel, mi-distanciel, en ayant des petits groupes un peu partout en France en présentiel, en liaison avec la visio-conférence de l’évènement en distanciel. Cette proposition nous semble sympathique même si elle demande plus d’organisation et l’implication des organisateurs et organisatrices de meetups localement ou du moins l’implication de personnes pour animer les groupes locaux.

📌 Il faudrait donc poser la question plus largement pour trouver des personnes pour animer les groupes locaux.

🗓 Pour l’article d’annonce de l’évènement, il faudra être prêts un peu avant le WordCamp Europe soit avant le 2 juin.

Le sujet sera donc réabordé plus précisément à la prochaine réunion où nous déciderons d’une date et réfléchirons au contenu de cet évènement.

Réflexions sur l’accès à la documentation

Les articles de la documentation n’étant pas très bien placés dans les résultats des moteurs de recherche, l’accès à la documentation en français reste limité. Par ailleurs, la recherche à l’intérieur de la documentation est peu efficace.

Face à ce constat, Marie demande s’il serait envisageable de créer un site donnant accès aux contenus de la documentation et sur lequel on pourrait installer un moteur de recherche efficace. La réponse est oui, mais cela pose d’autres questions : qui maintient le site, avec quel budget ?

Nous n’avons bien sûr pas tranché sur cette question, et si vous avez des suggestions concernant cette idée, elles sont les bienvenues !


La réunion se termine à 13H00.

La prochaine réunion aura lieu le 9 mai 2022 à midi.

#compte-rendu, #documentation-fr

Ordre du jour de la 14ème réunion Documentation du 11 avril 2022

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

La quatorzième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 11 avril 2022 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Nouvelles entrées du glossaire.
  • Application des modifications du HelpHub officiel ?
  • Programmer un Translation Day spécial Documentation ?

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

Ordre du jour de la 13ème réunion Documentation du 14 mars 2022

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

La treizième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 14 mars 2022 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement

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 12ème réunion Documentation du 14 février 2022

La douzième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 14 février 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement
  • Point sur les articles à importer
  • Évolutions de la documentation officielle

Personnes présentes

Avancement

Depuis la dernière réunion du 17 janvier 2022 :

  • 5 articles traduits (soit 188 articles traduits sur 243, 77.4%).
  • Aucun article rédigé (soit 18 articles rédigés sur 29, 62.1%)
  • Le pourcentage global d’avancement est de 75.7%.

Sujets abordés

Point sur les articles à importer

A priori, il n’y a pas de nouvel article à importer.

Évolutions de la documentation officielle

Des modifications mineures ont été apportées à certains articles le 4 février lors de la journée de contribution Yoast.

📌Il serait donc nécessaire de voir les changements apportés aux articles modifiés à cette date, afin d’éventuellement reporter ces changements.

📌Pour suivre les évolutions de la documentation en anglais : https://github.com/WordPress/Documentation-Issue-Tracker/projects/3


La réunion se termine à 12H15.

La prochaine réunion aura lieu le 14 mars 2022 à midi.

#compte-rendu, #documentation-fr

Ordre du jour de la 12ème réunion Documentation du 14 février 2022

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

La douzième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 14 février 2022 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Point sur les articles à importer.

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 11ème réunion Documentation du 17 janvier 2022

La onzième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 17 janvier 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement
  • La documentation et WordPress 5.9
  • La recherche dans la documentation
  • Ajout d’un menu FSE

Personnes présentes

Avancement

Depuis la dernière réunion du 13 décembre 2021 :

  • 10 articles traduits (soit 183 articles traduits sur 240, 76.3%).
  • Aucun article rédigé (soit 18 articles rédigés sur 29, 62.1%)
  • Le pourcentage global d’avancement est de 74.7%.

Le nombre total d’articles a connu quelques changements dûs à l’importation de 12 nouveaux articles et à la suppression d’articles que nous avons décidé de ne pas traduire (au nombre de 8). D’ailleurs, un nouveau statut « Ne pas traduire » a été ajouté dans le tableau de suivi.

Sujets abordés

La documentation et WordPress 5.9

Les articles concernant les nouvelles fonctionnalités de WordPress 5.9 publiés dans la version anglaise ont été importés, et sont déjà en partie traduits.
Les articles contenant le nom de menu « Éditeur de thème » ou « Éditeur d’extension » ont été mis à jour avec la nouvelle dénomination de ces menus, en utilisant la fonctionnalité des mises à jour planifiées, disponible sur le site de la documentation. La plannification de la mise à jour de ces articles a été réglée au 25 janvier 2022.

Il y aura aussi les articles « Histoire de WordPress », « Versions » et « Versions supportées » à mettre à jour, ainsi que l’article « Bloc Galerie » (en cours de traduction).

La recherche dans la documentation

Sur les sites des locales, tels que fr.wordpress.org/support, le formulaire de recherche interroge uniquement les forums de la locale. Comme les forums français ne sont pas hébergés sur WordPress.org, une recherche via ce formulaire aboutit à aucun résultat. Aussi nous avions enlevé ce formulaire qui est inutile.

Pour permettre la recherche dans la documentation, il serait utile de demander à localiser le moteur de recherche Google Search pour les sites des locales via un ticket dans meta.trac. Google Search étant le moteur de recherche utilisé sur WordPress Support.

Lors de l’atelier sur la catégorisation des articles, Gabrielle nous indiquait qu’elle utilisait l’outil de recherche situé en haut à droite du site de la documentation.

Cet outil de recherche renvoie des réponses correctes en affichant le contenu des articles trouvés mais la mise en page des articles n’est absolument pas ergonomique. Si l’affichage était correct, cela permettrait déja de disposer d’un outil de recherche plus performant.

Ce problème d’affichage des résultats pourrait être corrigé encréant un template search.php, puis en faisant un ticket pour demander son implémentation. JB essaie d’y travailler prochainement.

📌Il faudra donc penser à faire ce ticket dès que le template sera créé.

Ajout d’un menu FSE

Le menu « FSE » permettra de présenter les articles décrivant les fonctionnalités d’édition complète de site. Il est décidé qu’il se nommera « Édition complète de site » avec une description comportant le terme « FSE ». Ce menu est déjà créé, il suffira donc de le déplacer dans les widgets actifs et de lui ajouter l’icône « dashicons-layout » et une description.

📌La mise en place de ce menu est prévue dès que les articles à y placer seront publiés, à côté du menu « Éditeur de blocs ».


La réunion se termine à 13H.

La prochaine réunion aura lieu le 14 février 2022 à midi.

Compte-rendu de la 10ème réunion Documentation du 13 décembre 2021

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

Ordre du jour

  • Point avancement.
  • Bug concernant l’affichage de la table des matières.
  • Poursuite du travail sur les catégories.
  • Point sur les articles cités dans le tableau de bord de WordPress.
  • Suivi des articles provenant de HelpHub dans Notion.

Personnes présentes

Avancement

Depuis la dernière réunion du 15 novembre 2021 :

  • 9 articles traduits (soit 173 articles traduits sur 238, 72.7%).
  • Aucun article rédigé (soit 18 articles rédigés sur 29, 62.1%)
  • Le pourcentage global d’avancement est de 71.5%. On a donc dépassé les 70% !

Un très léger ralentissement par rapport à la période précédente, mais le rythme de publication est satisfaisant. Merci à tous, que vous fassiez de la traduction, de la rédaction, ou de la relecture, voire les 3 à la fois !

Sujets abordés

Bug concernant l’affichage de la table des matières

Depuis la fin octobre, la table des matières ne s’affiche plus lorsqu’on publie un article pour la première fois ou lorsqu’on met à jour un article déjà publié.

Un ticket avait été rédigé sur le GitHub de la documentation de WP qui est resté sans réponse, de même qu’un message dans le canal #docs sur le slack Making WordPress. La question était de savoir où il fallait poster ce ticket, il s’avère qu’il fallait plutôt le poster sur https://meta.trac.wordpress.org/.

Il semble que ce bug est lié au fait que l’extension qui gère la table des matières interprète mal les identifiants placés par WordPress sur les titres.

📌À l’heure où est rédigé ce compte-rendu, le ticket a été posté sur meta.trac (si ça vous intéresse de voir de quoi il s’agit) et même patché par JB (@audrasjb).

Poursuite du travail sur les catégories

Pour les catégories, un premier travail de suppression a été fait par Marie (@chaton666 – qui a identifié les doublons) et par Jenny (@jdy68 – qui a basculé les articles dans une des deux catégories, puis supprimé la catégorie vide), ce premier travail avait permis de réduire un peu le nombre de catégories (à 64). Ensuite, nous nous sommes réunis à trois (Marie, JB et Jenny) pour un atelier (voir CR de la réunion du 15 novembre 2021) dont l’objectif était de réorganiser les catégories et de supprimer les catégories inutiles. Au final, nous avons abouti à une liste de 35 catégories.

En faisant ce travail de réorganisation, il nous a semblé que certains articles n’étaient pas forcément dans la ou les catégorie(s) les plus adaptée(s), aussi une « vérification » article par article des catégories qui leurs sont associées nous paraît judicieuse.

Pour faire ce travail, les participants et participantes à la réunion s’accordent sur le format de l’atelier, pour plusieurs raisons : cela évite de faire des listes chacun de son côté avant une mise en commun, et cela permet de prendre des décisions au fur et à mesure sans faire trop d’allers-retours entre nous.

Nous proposerons donc un atelier début janvier. Cet atelier sera ouvert à toute personne que le sujet intéresse, en essayant de réunir des personnes avec des profils différents (développement, administration, gestion éditoriale, création de sites, etc.) pour ne pas regarder les contenus des articles de manière trop subjective et croiser les points de vue.

📌Si cet atelier vous intéresse, faites vous connaître sur le canal #documentation-fr du slack WordPress-Fr. Nous ferons un appel début janvier pour trouver une date/heure pour cet atelier.

Point sur les articles cités dans le tableau de bord de WordPress

Il s’agit des articles de documentation qui sont mis en lien dans les onglets d’aide des écrans du tableau de bord de WordPress, ou dans les écrans eux-mêmes, sur lesquels nous avions mis une priorité pour leur traduction. Il en reste un ou deux à traduire. Lorsqu’ils seront tous traduits, nous pourrons alors modifier les liens dans l’interface.

Suivi des articles provenant de HelpHub dans Notion

Un tableau de suivi des articles provenant du HelpHub en anglais a été mis en place sur l’espace de travail Documentation-WP de Notion. Dans ce tableau sont listés les articles de HelpHub publiés sur HelpHub EN, puis les différentes colonnes décrivent leur statut (publié, brouillon, non importé, à importer) et une colonne spécifie s’ils ont été mis à jour côté EN. Ce tableau permet donc de synchroniser la documentation FR avec la version EN, en choisissant les articles à importer ou à mettre à jour.

Il est envisagé de donner un accès en lecture aux différentes pages concernant la gestion éditoriale de la documentation en français sur cet espace de travail Notion afin que chacun puisse suivre ce qui se fait sur la documentation par un autre moyen que le tableau de suivi.

Liens vers des extensions payantes ou vers des blogs personnels

JB (@audrasjb) nous parle de l’article sur le multilingue dans WP, et nous explique qu’il y a un lien vers WPML (qui ne propose pas de version gratuite). Il se pose la question de comment gérer ce genre de liens. Puis en discutant, il est décidé de supprimer ce lien et de faire un ticket pour demander sa suppression dans la version source.

📌Rappel : il faut veiller à ne pas faire de liens vers des sites personnels, ou des articles de blogs, ou encore des extensions/thèmes ne proposant pas de version gratuite sur wp.org.
Quand vous voyez de tels liens dans un article, pensez à nous les remonter.


Pour les réunions, si vous souhaitez proposer des sujets ou si vous avez des idées à partager, des questions, des demandes ou des remarques à nous communiquer, n’hésitez pas à les proposer sur la page des Sujets des réunions mensuelles. N’hésitez pas à vous joindre aux réunions, même si vous n’avez jamais participé, les réunions sont ouvertes à toute personne qui s’intéresse à la documentation de WordPress !


La réunion se termine à 13h10.

La prochaine réunion aura lieu le 10 ou le 17 janvier 2022 à midi.

#compte-rendu

Ordre du jour de la 10ème réunion Documentation du 13 décembre 2021

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

La dixième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 13 décembre 2021 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Bug concernant l’affichage de la table des matières.
  • Poursuite du travail sur les catégories.
  • Suivi des articles provenant de HelpHub dans Notion.
  • Point sur les articles cités dans le tableau de bord de WordPress.

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