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

Ordre du jour de la 25ème réunion de l’équipe Documentation du 6 avril 2023

La vingt-quatrième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 6 avril 2023 à 13h heure française, en visioconférence.

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

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

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

Ordre du jour

  • Point avancement.
  • Suivre la publication de nouveaux contenus sur le HelpHub officiel.
  • Mise à jour de la documentation pour WordPress 6.2.

Personnes présentes

Point avancement

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

  • +8 articles traduits (224 sur 281 soit 79.7%)
  • aucun nouvel article rédigé
  • +1 article importé (Bloc Submenu)

Le pourcentage global d’avancement est de 77.6%

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

  • sur les 33 avec priorité Forte : 16 sont terminées, 7 sont en cours et 10 sont à faire
  • sur les 31 avec priorité Moyenne : aucune n’est en cours ni terminée

Mise à jour de la documentation pour WordPress 6.2

La création de la liste des mises à jour des articles pour WP 6.2 a avancé, mais est loin d’être terminée.

Pour suivre les modifications de HelpHub EN pour 6.2, deux liens sur GitHub :

N’hésitez pas à vous manifester si vous souhaitez participer à la mise à jour de la documentation pour la prochaine version majeure de WordPress. La liste des articles est à retrouver sur Notion : https://ash-circle-45b.notion.site/Modifications-des-articles-21063d5de77046fdb1fcf49f0897b6a0

🚩 À noter que lorsqu’on met à jour un article pour une version pas encore sortie (par exemple la 6.2), on positionne la date de publication au plus tôt au jour prévu de la sortie de la version.

Nous évoquons une nouvelle fonctionnalité : la déclaration des familles de police en locale (dans le theme.json) VS la Google API : ça n’a pas sa place dans la documentation mais mériterait une communication (article).

Suivre la publication de nouveaux contenus sur le HelpHub officiel

Il est toujours assez compliqué pour l’équipe FR d’être au courant des nouveaux contenus publiés sur le HelpHub officiel.

Jenny a demandé à l’équipe comment on pouvait être alertés de la publication de nouveaux contenus.

Suggestion est faite que les responsables de locales soient pingués sur le slack Make, la question doit être posée à l’équipe Meta. Nous espérons avoir des nouvelles prochainement.

Changement d’URL support > documentation

L’URL du HelpHub officiel est récemment passé de wordpress.org/support à wordpress.org/documentation

De notre côté sur la documentation en français, le changement n’est pas fait, cela viendra plus tard et pour l’instant on continue d’utiliser « support » dans les URL.

Participation au Contributor Day du WordCamp Paris 2023

Le WordCamp Paris fait son retour le 21 avril 2023 !

Cet évènement autour de WordPress sera précédé, le 20 avril, par un Contributor Day organisé par l’association WPFR.
Toute ou partie de l’équipe de la documentation de WordPress en français sera présente pour vous faire découvrir et vous initier à la contribution de la documentation.

N’hésitez donc pas à vous inscrire gratuitement à cette journée.


La réunion se termine à 14 heures.

La prochaine réunion aura lieu le jeudi 6 avril 2023.

#compte-rendu, #documentation-fr

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

La vingt-quatrième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 2 mars 2023 à 13h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Suivre la publication de nouveaux contenus sur le HelpHub officiel.
  • Mise à jour de la documentation pour WordPress 6.2.

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 23ème réunion de l’équipe Documentation du 2 février 2023

La vingt-troisième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 2 février 2023 à 13h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Nouvel espace de travail Notion.
  • Priorisation entre traduction/rédaction et mise à jour.

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

La vingt et deuxième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 5 janvier 2023 à 13h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Processus de mise à jour des articles lors des sorties de version.
  • Motivation de l’équipe.

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 21ème réunion de l’équipe Documentation du 1er décembre 2022

La vingt et unième réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 1er décembre 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.1.
  • Traduction d’un article du blog developer.wordpress.org.

Personnes présentes

Point avancement

Depuis la dernière réunion du 10 novembre 2022 :

  • +1 nouvel article traduit (214 sur 270)
  • +1 article importé.
  • Aucun nouvel article rédigé, ni importé du codex.

Le pourcentage global d’avancement est de 77.3% (sans tenir compte du Codex).

Pour les pages du Codex, l’avancement global est toujours de 48.6%.

Mise à jour de la documentation pour la version 6.1

En ce qui concerne les articles à mettre à jour pour la veresion 6.1 :

  • Il est rappelé l’existence d’une liste des articles à modifier ou créer, créée selon les issues GitHub conernant la mise à jour de la documentation et stockée dans l’espace de travail Notion.
  • La page du Handbook concernant la procédure à suivre pour mettre à jour les articles est en cours de rédaction.

🚩 À noter que la liste des modifications devrait être complétée avec les nouvelles issues GitHub, et que la rédaction de la page du handbook doit aussi être poursuivie.

Traduction d’un article du blog developer.wordpress.org.

Sur le slack, JB (@audrasjb) avait suggéré qu’il serait intéressant de traduire cet article du blog developer.wordpress.org : A PHP developer’s guide to getting started with block development.

L’équipe discute donc de l’intérêt de l’article puis s’interroge sur l’emplacement de la traduction de cet article (espace documentation ou dans les actualités de fr.wordpress.org), ainsi que sur l’intérêt de traduire d’autres articles de ce blog.

🚩 Au final, l’équipe décide de traduire l’article cité ci-dessus, sans avoir pour l’instant statuer sur l’emplacement qui lui sera attribué. Elle se met aussi d’accord sur le fait que les traductions des articles de ce blog se feront au coup par coup, sans chercher à être exhaustif.

📃 Un document Framapad a été créé afin de traduire l’article. Jean Michel Silone et Laurent Millet se sont déclarés volontaires pour traduire cet article, n’hésitez pas à les rejoindre si cet traduction d’article vous intéresse.

Nouveau design pour DevHub

JB (@audrasjb) nous informe qu’un nouveau design est en cours de création pour la documentation destinée au développeurs et développeuses. Celui-ci est consultable sur Figma.

🚩 À noter que la refonte du design de HelpHub devrait suivre cette refonte de DevHub.

Statistiques de visites de la documentation

Nous évoquons ce sujet car nous ne disposons pas des statistiques de visites des différents articles de HelpHub ce qui nous semble pourtant être une source d’information cruciale pour la gestion éditoriale de la documentation.

JB (@audrasjb) vérifie qu’aucun module de stats n’est activé ou activable, et ouvre un ticket pour demander la mise en place de cet outil.

👍 N’hésitez pas à commenter ce ticket…


La réunion se termine à 14H.

La prochaine réunion est prévue le jeudi 5 janvier à 13 heures.

#compte-rendu, #documentation-fr

Ordre du jour de la 21ème réunion de l’équipe Documentation du 1er décembre 2022

La vingt et unième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 1 décembre 2022 à 13h heure française, en visioconférence.

Le jour et l’horaire de la réunion mensuelle ont été modifiés pour permettre à un plus grand nombre de membres de l’équipe de participer aux réunions. Dorénavant, les réunions auront donc lieu le 1er jeudi du mois à 13 heures.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.1.
  • Traduction d’un article du blog developer.wordpress.org.

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 20ème réunion de l’équipe Documentation du 10 novembre 2022

La vingtième réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 10 novembre 2022 à treize heures (heure française), en visioconférence.

Ordre du jour

  • Point avancement.
  • Espace de travail sous Notion.
  • Mise à jour de la documentation pour la version 6.1.

Personnes présentes

Point avancement

Depuis la dernière réunion du 10 octobre 2022 :

  • Pas de nouvel article traduit, ni rédigé, ni importé du codex.
  • 1 article en attente de relecture (publié depuis).
  • +2 articles importés.

Le pourcentage global d’avancement est de 77.3% (sans tenir compte du Codex).

Pour les pages du Codex, l’avancement global est toujours de 48.6%.

Contenu de l’article Réglages communs des blocs.

Ce sujet n’était pas à l’ordre du jour mais il est évoqué dans le point fait sur l’actualité de la documentation officielle de WordPress. L’équipe de la documentation officielle a, en effet, mis en place des articles qui présentent des fonctionnalités communes à tous les blocs ou à un très grand nombre de blocs, soit les réglages de typographie, couleur, bordure, mise en page, dimensions, styles. Ce que nous avons déjà réalisé lors de la mise en place de la mutualisation des contenus pour les articles concernant les blocs, dans l’article Réglages communs des blocs.

La discussion se porte sur : découpons-nous l’article « Réglages communs des blocs » en plusieurs articles (comme dans la version officielle en anglais) ou complétons-nous l’article « Réglages communs des blocs » avec les éléments manquants (à savoir mise en page et bordure) ?

Les avantages d’un seul article :

  • De n’avoir rien à modifier dans les articles concernant les blocs qui contiennent tous déjà un lien vers cet article des réglages communs.
  • Les lecteurs et lectrices de la documentation peuvent prendre connaissance d’autres réglages communs juste en les voyant dans le sommaire.
  • Pas de création de nouveaux articles.
  • Conservation du référencement.

Les inconvénients d’un seul article :

  • Article au contenu assez long.
  • Le renvoi vers l’article des réglages communs peut être effectué uniquement pour un seul type de réglages, ce qui peut entraîner une certaine confusion concernant les réglages des blocs pour les utilisateurs/utilisatrices de la documentation.

Les avantages de plusieurs articles :

  • Clarté pour les utilisateurs et utilisatrices.
  • Synchronisation entre le HelpHub officiel et HelpHub FR simplifiée.

Les inconvénients de plusieurs articles :

  • Il faut effectuer le découpage en plusieurs articles et créer de nouveaux articles.
  • Il faut ajouter les liens vers les articles dans chaque article concernant un bloc selon les réglages que le bloc propose (demande donc à vérifier les réglages présents pour chaque bloc).
  • Perte du référencement.

🚩 L’équipe opte pour une mise à jour de l’article « Réglages communs des blocs » car c’est cette option qui implique le moins de travail à effectuer.

Espace de travail sous Notion.

L’association WPFR est ok pour financer un outil pour le travail collaboratif de l’équipe de documentation. Pour l’instant, un espace de travail Notion contient les informations concernant les réunions, le calendrier de publication, les tableaux d’avancement, ect. D’autres outils auto-hébergés ont été rapidement testés afin de voir si on pouvait utiliser un autre outil que Notion.

Nous discutons sur ces outils auto-hébergés : le travail lié à l’installation-maintenance d’un tel outil est évoqué comme étant un frein car gourmand en temps, tout comme la recherche de l’outil lui-même, ainsi que le temps nécessaire à sa prise en main.

🚩 L’équipe choisit donc de conserver l’outil Notion afin de ne pas engendrer de travail supplémentaire lié à la gestion du travail de l’équipe.
L’espace actuel va être migré dans un nouvel espace car il n’est pas correctement rattaché à l’abonnement de l’association WPFR.

Mise à jour de la documentation pour WP 6.1

La liste des issues concernant la version 6.1 avait été reportée dans un tableau/kanban sous Notion, cette liste a été complétée, et des éléments ont été ajoutés pour chaque item de la liste :

  • Un lien vers issue GitHub (afin de ne pas recopier les actions à mener qui sont déjà détaillées dans l’issue GitHub – même si ces actions doivent être adaptées au cas par cas à la version française puisque les contenus des articles ne sont pas à 100% synchronisés).
  • Des étiquettes Versions WP ont aussi été ajoutées quand des modifications existent pour les versions 5.9 et 6.0 de WordPress.
  • Des étiquettes Type (MAJ, Création d’article, Sans Objet) ont été ajoutées afin de pouvoir visualiser l’action globale à mener pour l’article.

🚩 Cette liste devra être mise à jour, au fur et à mesure de l’avancement, mais aussi avec les nouvelles issues déclarées dans GitHub.

Par ailleurs une page de documentation concernant la procédure de mise à jour des articles va étré rédigée dans le handbook, lorsqu’elle sera publiée, un lien sera ajouté dans le canal #documentation-fr du slack WordPressFR


La réunion se termine à 14H.

La prochaine réunion est prévue le 1er décembre 2022 à 13h.

#compte-rendu

Ordre du jour de la 20ème réunion de l’équipe Documentation du 10 novembre 2022

La vingtième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 10 novembre 2022 à 13h heure française, en visioconférence.

Le jour et l’horaire de la réunion mensuelle ont été modifiés pour permettre à un plus grand nombre de membres de l’équipe de participer aux réunions. Dorénavant, les réunions auront donc lieu le 1er jeudi du mois à 13 heures. La tenue de la réunion ce jeudi 10 novembre (deuxième jeudi du mois) est donc exceptionnelle.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.1.
  • Espace de travail sous Notion.

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