Compte-rendu de la 18ème réunion de l’équipe Documentation du 12 septembre 2022

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

Ordre du jour

Personnes présentes

Point avancement

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

  • +9 articles traduits (212 sur 266, soit 79.6%).
  • +8 articles importés.
  • 1 article en attente de relecture.
  • Pas d’article rédigé directement en français.

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

Pour les pages du Codex, l’avancement global est pour l’instant de 48.6% :

  • +1 page du Codex transférée (et mise à jour) sur HelpHub.

Réorganisation du menu Éditeur de blocs

Le menu Éditeur de blocs dans la page d’accueil de la documentation contient tous les articles concernant les blocs proposés dans l’éditeur de WordPress, aussi la liste est déjà assez longue et s’agrandira à chaque fois qu’un bloc sera documenté ou qu’un nouveau bloc sera ajouté dans l’éditeur.
Aussi il est proposé de regrouper les blocs en suivant la présentation de l’éditeur : blocs Texte, Média, Design, etc. en créant des indentations dans le menu.

🚩 L’idée est validée et JB s’occupe de faire une demande pour que les sous-menus puissent être utilisés dans la page d’accueil de la documentation, et communiquera le lien pour le suivi.

Traduction des contenus de Learn WP

Un nouveau projet voit le jour et concerne la traduction des contenus de Learn WordPress. L’équipe Training a mis en place un flux de travail pour chaque type de contenu de Learn WP et demande nos retours sur ces flux (Looking for feedback: Handbook page about content localization).

Jenny a commencé la traduction de cette page Content Localization qui sera intégrée au Guide de traduction de WordPress, dans un nouveau chapitre « Traduction de Learn WordPress en français » vous pouvez la prévisualisez ici. Cette page sera éventuellement réactualisée selon les modifications apportées aux flux de travail.

🚩 Nous allons prochainement lancer un appel à contributeurs pour tester dans un premier temps ces flux de travail afin d’aider l’équipe Training à les valider et/ou les améliorer. Si vous êtes intéressé·e·s par ces tests et ce projet, manifestez-vous dans le canal #documention-fr du slack WordPressFR.

Mise à jour de la documentation pour la sortie de WordPress 6.1

Ce sujet est ajouté à l’ordre du jour par JB.

Il nous transmet un lien vers une ressource qui liste les modifications à apporter aux différentes documentations de WordPress. Ceci va nous aider grandement à lister les articles pour lesquels il faudra faire des modifications, les fonctionnalités concernées sont celles qui sont étiquetées « End user docs » dans la colonne « Docs Type ».

🚩 Il faut se coordonner pour effectuer ces modifications, en établir la liste et utiliser l’extension permettant de planifier les modifications (documentation en cours de rédaction), aussi merci de suivre a minima ce process et de communiquer avant d’effectuer des modifications sur le canal #documentation-fr.


La réunion se termine à 13H03.

La prochaine réunion aura lieu le 10 octobre 2022 à midi.

#compte-rendu

Ordre du jour de la 18ème réunion de l’équipe Documentation du 12 septembre 2022

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

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

Compte-rendu de la 17ème réunion de l’équipe Documentation du 11 juillet 2022

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

Ordre du jour

  • Point avancement.
  • Bilan du Documentation Day FR.
  • Gestion des contenus en français du Codex.
  • Mise en place de codes sur Slack pour le travail en commun sur un article.

Personnes présentes

Prochaine réunion

Avant de commencer, nous nous mettons d’accord sur le maintien de la prochaine réunion qui doit avoir lieu le 8 août 2022, tout en n’étant pas totalement certain·e·s qu’elle ait effectivement lieu ; la décision sera prise le jour J, selon le nombre de personnes.

Point avancement

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

  • +2 articles publiés (203 sur 258, soit 78.7%).
  • +1 article importé.
  • Pas d’article rédigé directement en français.

Le pourcentage global d’avancement est de 76.7%.

L’équipe s’est agrandie avec l’arrivée de 6 nouveaux contributeurs (Clément Boirie, Benjamin Gosset, Jérémy Marchandeau, Pierre Mobian, Jean Michel Silone qui nous ont rejoint à l’issue du Documentation Day FR, et Marie-Aude Koiransky plus récemment à la suite de sa relecture d’un article sur l’optimisation pour les moteurs de recherche).

Bilan du Documentation Day FR

Nous avons oublié de traiter ce point de l’ordre du jour. Il a donc été reporté à la prochaine réunion, afin de recueillir le plus possible d’avis sur cet évènement.

Gestion des contenus en français du Codex.

La très grande majorité des contenus du Codex ont déjà été intégrés dans la documentation de WordPress en français, appellée HelpHub FR. L’intégration s’est déroulée en deux temps : migration des contenus (en anglais) du Codex vers des articles sous HelpHub réalisée par l’équipe qui gère la documentation officielle en anglais, puis dans un second temps, nous avons copié ces articles dans le HelpHub FR afin de les traduire, ce qui est le cas pour 78.7% d’entre eux.

Les contenus du Codex ont été migrés :

  • soit vers le HelpHub, pour les contenus destinés aux utilisateurs et utilisatrices de WordPress ;
  • soit vers d’autres documentations telles que le Code Reference ou encore le Theme Handbook lorsqu’il s’agit de contenus à destination des développeurs.

S’il n’est pas d’actualité de traduire les handbooks destinés aux développeurs, il nous semble intéressant d’intégrer dans le HelpHub FR certains contenus techniques disponibles dans le Codex en français, comme par exemple Hiérarchie des fichiers modèles.

Un premier travail consistera à faire la liste des contenus du Codex en français que nous souhaitons migrer vers le HelpHub FR, puis il faudra réaliser cette migration, mettre à jour le fond et la forme des contenus, puis une fois la publication effectuée, rediriger les URL du Codex vers les articles de HelpHub FR.

Avant de migrer les contenus d’une page du Codex, il est nécessaire de vérifier qu’aucun article de HelpHub FR ne contient ces contenus.
Dans le cas où les contenus d’une page du Codex existent déjà dans un article de HelpHub FR, il faudra lui appliquer une redirection vers cet article, via un shortcode. À manipuler avec précaution car le retour en arrière n’est pas simple !
Exemple : la page du Codex fr:Plugins (désolée pour le « plugins » 😉) qui propose le même contenu que l’article Les extensions, voir capture ci-dessous, a été redirigée vers cet article HelpHub.

🚩 Depuis la réunion, une nouvelle page du tableau de suivi a été créée, elle accueille la liste des pages du Codex en français et permettra de suivre l’avancement du travail. Si vous travaillez sur une des pages du Codex, c’est dans ce tableau qu’il faut indiquer ce que vous faites.
Une page sera ajoutée dans le handbook pour expliquer le flux de travail correspondant à l’intégration ou la redirection des contenus du Codex.

Mise en place de codes sur Slack pour le travail en commun sur un article

Lors du travail de relecture de l’article Optimisation pour les moteurs de recherche, les échanges sur le canal #documentation-fr du Slack ont étés importants, car plusieurs personnes ont participé à la relecture de l’article et ont proposé des modifications pour le fond et la forme.

Il fallait à la fois accepter ou non les modifications proposées, puis les reporter.

Nous avons donc utilisé des fils de discussions, mais aussi l’apposition d’icônes qui simplifie grandement la compréhension :

Émoticônes proposées pour des discussions à plusieurs sur des modifications dans un article :

  • :100: Approbation de la modification
  • :point_d'interrogation_rouge: Questionnement/incertitude sur la modification
  • :x: Désapprobation de la modification
  • :coche_blanche: Modification effectuée dans l’article

🚩 Ce message a été épinglé dans le canal #documentation-fr du Slack WordPressFR.


La réunion se termine à 12H55.

La prochaine réunion aura lieu le 8 août 2022 à midi.

#compte-rendu

Ordre du jour de la 17ème réunion de l’équipe Documentation du 11 juillet 2022

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

À l’ordre du jour :

  • Point avancement.
  • Bilan du Documentation Day du 17 juin 2022.
  • Gestion des contenus en français du Codex.
  • Mise en place de codes sur Slack pour le travail en commun sur un article

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 du Documentation Day – FR du 17 juin 2022

Bannière de l’évènement

Le Documentation Day – FR a été organisé à l’initiative de l’équipe de documentation de WordPress en français. Cet évènement en ligne avait pour objectif de proposer un tour d’horizon complet sur ce projet qui constitue un moyen intéressant de contribuer.

Durant ces trois heures, nous avons donc accueilli une quinzaine de participants de divers horizons (conception de sites WordPress et développement WordPress), souhaitant en savoir plus sur la contribution à la documentation en français ou faisant déjà partie de l’équipe.

Cet évènement a réuni de « nouvelles têtes » :

  • Clément Boirie
  • Benjamin Gosset
  • Jérémy Marchandeau
  • Pierre Mobian
  • Jean Michel Silone
  • Rachel Peter

des membres de l’équipe :

  • Sylvie Clément
  • Didier Demory
  • Gabrielle Fouix
  • Valérie Galassi
  • Laurent Millet
  • Patrick Olivaud
  • Jason Rouet
  • Bruno Tritsch

accueilli·e·s par les animateurs et animatrices de l’évènement : JB Audras, Marie Comet et Jenny Dupuy.

En s’appuyant sur le diaporama, réalisé par Jenny, Laurent et Marie, et proposé en fin d’article, nous avons présenté le projet, l’équipe et son fonctionnement, les outils utilisés et répondu aux questions des participants.

À l’issue de l’évènement, l’équipe s’est agrandie, puisque Clément Boirie, Benjamin Gosset, Jérémy Marchandeau, Pierre Mobian et Jean Michel Silone ont exprimé le souhait de contribuer prochainement…Bienvenue à vous 5 ! Nous sommes ravi·e·s de vous accueillir dans l’équipe et prêt·e·s à vous épauler dans vos contributions.

Pour ceux qui n’ont pas pu participer, ou ceux qui souhaitent conserver les informations diffusées pendant cet évènement, nous communiquons ici la présentation.

Ce diaporama est composé d’une première partie « Présentation du projet » qui détaille les objectifs, la chronologie et l’avancement du projet, la composition de l’équipe, son flux de travail et les outils utilisés. Puis une seconde partie « Foire aux questions » répond aux questions les plus fréquentes que se posent les contributeurs et contributrices débutant·e·s ou confirmé·e·s ! Cette deuxième partie (FAQ) devrait prochainement être intégrée au guide Traduire la documentation de WordPress en français, guide de référence pour toute personne souhaitant contribuer à la documentation.

Comme nous l’évoquions lors de la réunion du 9 mai dernier, cet événement en ligne était aussi l’occasion de préparer des supports à fournir aux équipes des meetups locaux, en vue d’un événement en présentiel et distanciel en septembre.
Nous disposons donc maintenant d’un support complet, et nous verrons en fonction des plannings de chacun s’il est possible d’organiser un événement en présentiel plus tard dans l’année.

Si vous souhaitez rejoindre l’équipe, vous avez maintenant toutes les informations nécessaires.
À vous de jouer !

Nous vous disons donc  : « à bientôt » et espérons vous rencontrer lors de futurs évènements en distanciel ou présentiel !

Merci à tous pour votre participation à cet évènement et pour votre contribution (présente, passée ou future) à ce beau projet qu’est la documentation de WordPress en français.

#evenement-2, #documentation-fr

Ordre du jour de la 16ème réunion de l’équipe Documentation du 14 juin 2022

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

À l’ordre du jour :

  • Point avancement.
  • Workflow publication : une relecture au lieu de deux.
  • Liens vers les articles sur chaque contenu embarqué dans l’article Les blocs.
  • Documentation Day – FR du 17 juin 2022.

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

Documentation Day – FR, le 17 juin 2022

Bannière du Documentation Day - FR 2022, il est inscrit WordPress Documentation Day - FR, 17 juin 2022 de 12 à 15 heures

Venez participer au premier Documentation-Day
(de l’histoire de WordPress) !

L’équipe de documentation organise, le 17 juin 2022 de 12 à 15 heures en visioconférence, un évènement au cours duquel nous vous présenterons en détail le fonctionnement de l’équipe, les outils que nous utilisons, et répondrons à toutes vos questions.

Le lien de la visioconférence sera publié sur le slack WordPress-FR, canal #documentation-fr.

N’hésitez pas à relayer l’info sur vos réseaux, à l’aide des visuels réalisés pour l’évènement (cliquez sur l’image pour l’ouvrir) :

ainsi que les badges pour ceux qui ont prévu d’y participer :

Et enfin, les bannières Twitter :

On vous attend nombreux et nombreuses !
À vendredi prochain…

#evenement-2

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