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 (215 sur 270)
  • +1 article importé.
  • Aucun nouvel article rédigé, ni importé du codex.

Le pourcentage global d’avancement est de 77.7% (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.6% (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 (214 sur 267, soit 80.1%).
  • +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 78.1% (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

    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