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

Compte-rendu de la 19ème réunion de l’équipe Documentation du 10 octobre 2022

La dix-neuvième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 10 octobre 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Mise à jour de la documentation pour WP 6.1.
  • Test du flux de travail proposé pour la traduction des contenus de Learn WP.

Personnes présentes

Point avancement

Depuis la dernière réunion du 12 septembre 2022 :

  • +2 articles traduits (213 sur 267, soit 79.8%).
  • +1 articles importé.
  • Pas de nouvel article rédigé directement en français, ni d’article issu du Codex.
  • 1 article en attente de relecture.

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

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

📊 À cette date, il reste 39 articles à traduire, ils concernent les sujets suivants :

  • Les blocs (en particulier les blocs utilisés dans l’éditeur de site) : 15 ;
  • L’éditeur de blocs : 7 ;
  • L’éditeur classique : 1 ;
  • Sujets plutôt orientés développement : 7 ;
  • La création de contenus, les commentaires, les rétroliens : 4 ;
  • Le multisite : 3 ;
  • La FAQ Travailler avec WordPress et comment trouver de l’aide.

N’hésitez pas à vous assignez un article qui vous intéresse. Dans le tableau de suivi, les titres des articles ont été colorisés pour reprendre cette classification, vous avez la signification des codes couleurs en remarque dans la cellule « Original Title ».

Mise à jour de la documentation pour WP 6.1.

À la réunion précédente, la liste des modifications à apporter aux diverses documentations (en particulier la documentation utilisateur et les handbooks de developer.wordpress.org), nous avez été fourni par JB. À partir de cette liste, un processus a été défini :

  1. Identifier les mises à jour à effectuer (un kanban a été créé dans cet objectif sous Notion).
  2. Différencier mises à jour d’articles existants et créations d’articles.
  3. Établir les priorités.
  4. Utiliser la fonctionnalité de mise à jour planifiée (Updates), ce qui permet d’une part, de pouvoir faire les modifications en plusieurs sessions (tout comme lorsqu’on traduit ou rédige), et d’autre part, d’effectuer une relecture avant publication. Cette fonctionnalité sera documentée dans le Guide du Traducteur. Ne pas oublier de compléter le journal des modifications de l’article.
  5. Relecture et validation des articles modifiés, puis publication.
  6. Report des modifications effectuées dans la table Modifications sous Notion.

JB nous fournit un autre lien plus adapté contenant toutes les « issues » ouvertes concernant la documentation utilisateur (au nombre de 81) avec en plus un classement en termes de priorité.

🚩 Nous allons donc, dans un premier temps, nous concentrer sur les « issues » étiquetées « high priority ».

Test du flux de travail proposé pour la traduction des contenus de Learn WP.

Nous proposons de suivre les flux de travail intiés par l’équipe de Learn WordPress tout en notant les points qui nous posent problème afin de pouvoir faire nos retours sur ces processus.

Il nous faut donc choisir quelques contenus et en proposer une version française.

🚩 Si la traduction de Learn WordPress vous intéresse, on en discute ensemble dans le canal #documentation-fr du slack WordPress-FR. Le choix des ressources à traduire sera bien évidemment fait avec les personnes intéressées.


La réunion se termine à 13H.

La prochaine réunion est prévue le 14 novembre 2022 à midi.

#compte-rendu

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

La dix-neuvième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 10 octobre 2022 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation pour WP 6.1.
  • Test du flux de travail proposé pour la traduction des contenus de Learn WP.

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