Ordre du jour de la 40e réunion de l’équipe Documentation du 3 octobre 2024

La 40e réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 3 octobre 2024 à 13h heure française, en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Point sur les mises à jour.
  • Point sur les tickets en cours.
  • Bilan de la journée de contribution.

Le lien d’invitation pour la visioconférence sera communiqué juste avant la réunion, sur le canal #documentation-fr du Slack WordPress-fr.

#documentation, #ordre-du-jour

Compte-rendu de la 39e réunion de l’équipe Documentation du 4 septembre 2024

La 39e réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 4 septembre 2024 à 13h heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Point sur les mises à jour.
  • Point sur les tickets en cours (reporté à une prochaine réunion).
  • Remplacer « blocs réutilisables » par « compositions synchronisées » dans les articles.
  • Préparation de la journée de contribution du 26 septembre 2024 à Rennes.

Personnes présentes

Point avancement

Depuis la dernière réunion du 5 août 2024 :

  • pas de nouvel article publié, ni rédigé ;
  • un article rédigé en cours de validation ;

L’avancement global est de 85.7%.

Point sur les mises à jour

6.4

40 mises à jour : 37 faites – 1 en cours, 2 à faire

6.5

32 mises à jour : 21 faites – 3 en cours – 8 à faire

6.6

Pour l’instant elles n’ont pas été reportées, donc le nombre total indiqué ici n’est pas réaliste.

4 mises à jour : 2 faites – 1 en cours – 1 à faire

Remplacer « blocs réutilisables » par « compositions synchronisées » dans les articles

On recherche pendant la réunion les articles concernés. Ils sont a priori au nombre de 4 :

Préparation de la journée de contribution du 26 septembre 2024 à Rennes

Pendant la journée de contribution, nous pourrions travailler sur la mise à jour des articles :

  • blocs réutilisables → compositions synchronisées ;
  • mises à jour des versions 6.4 et 6.5.

Proposition de ne pas faire le travail dans WordPress pour simplifier la mise en place.

Réalisation des modifications sur les articles dans Google Docs puis transfert dans les articles sous WP et citation des personnes dans le Journal des modifications pour les crédits.

Il faudrait chercher d’autres idées car la réalisation des mises à jour n’est pas forcément très intéressante.


La réunion se termine à 14 heures.

La prochaine réunion aura lieu le jeudi 3 octobre 2024.

#compte-rendu, #documentation-fr

Ordre du jour de la 39e réunion de l’équipe Documentation du 5 septembre 2024

La 39e réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 5 septembre 2024 à 13h heure française sur Slack ou en visioconférence.

À l’ordre du jour :

  • Point avancement.
  • Point sur les mises à jour.
  • Point sur les tickets en cours.
  • Remplacer « blocs réutilisables » par « compositions synchronisées » dans les articles.
  • Préparation de la journée de contribution du 26 septembre 2024 à Rennes.

La réunion se tiendra sur slack ou éventuellement en visioconférence, dans ce cas le lien d’invitation pour la visioconférence sera communiqué sur le canal #documentation-fr du Slack WordPress-fr.

#documentation, #ordre-du-jour

Compte-rendu de la 38e réunion de l’équipe Documentation du 8 août 2024

La 38e réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 8 août 2024 à 13h heure française.

Ordre du jour

  • Point avancement.
  • Point sur les mises à jour.
  • Vérification de la nouvelle interface de la documentation.
  • Nouvelle présentation des bloc Contribution et Journal des modifications.

Personnes présentes

Point avancement

Depuis la dernière réunion du 4 juillet 2024 :

  • aucun article traduit
  • aucun article rédigé

Le pourcentage global d’avancement est donc toujours de 86%.

Point sur les mises à jour

6.4

40 mises à jour : 36 faites – 2 en cours, 2 à faire

6.5

31 mises à jour : 21 faites – 3 en cours – 8 à faire

6.6

Pour l’instant elles n’ont pas été reportées, donc le nombre total indiqué ici n’est pas réaliste.

4 mises à jour : 2 faites – 1 en cours – 1 à faire

Il serait pratique que les auteurs de merge request sur le dépôt GitHub de Gutenberg utilisent le tag “Needs User Documentation” lorsque l’interface ou le fonctionnement des outils sont modifiés. Cela permettrait à la personne (Jenny pour la 6.6) qui recense les articles à mettre à jour d’identifier plus rapidement les modifications.
Liste des issues triées avec ce tag : https://github.com/WordPress/gutenberg/issues?q=+label%3A »Needs+User+Documentation

Vérification de la nouvelle interface de la documentation

Tickets créés sur Trac pour remonter les anomalies visuelle du site Documentation en français :

Nouvelles anomalies relevées lors de la réunion :

  • Dans les articles :
    • Sous la navigation principale, il y a un lien Forums qui est inutile. C’est apparemment un bloc “Site title”.
    • Il manque une marge entre le h1 et le contenu.

Nouvelle présentation des bloc Contribution et Journal des modifications

Le nouveau thème appliqué à la documentation implique une présentation pas très optimale du bloc Contribution en bas de page.
Il serait souhaitable de la modifier à l’occasion d’une mise à jour effectuée sur l’article, puis si on a le temps sur tous les articles.
Une proposition de mise en forme est proposée – à valider ou modifier ?

Présentation actuelle

Proposition

Cette proposition correspond aux réglages suivants :

  • bloc contribution : enlever les couleurs texte et arrière plan + transformer le bloc en bloc Groupe + ajouter des marges internes et externes à 2X Small + couleur d’arrière plan (Blueberry 4 – #EFF2FF)
  • bloc Journal des modifications : sélectionner le groupe / modifier la couleur d’arrière-plan (Blueberry 4 – #EFF2FF) / marges internes et externes à 2X Small

📌La proposition est validée. Cette mise en forme sera appliquée au fur et à mesure des mises à jour des articles.


La réunion se termine à 14 heures.

La prochaine réunion aura lieu le jeudi 5 septembre 2024 à 13 heures.

#compte-rendu, #documentation

Ordre du jour de la 38ème réunion de l’équipe Documentation du 8 août 2024

La 38e réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 8 août 2024 à 13h heure française, en visioconférence ou sur slack.

À l’ordre du jour :

  • Point avancement.
  • Point sur les mises à jour.
  • Vérification de la nouvelle interface de la documentation.
  • Nouvelle présentation des bloc Contribution et Journal des modifications.

Si la réunion se tient en visioconférence, le lien sera communiqué juste avant la réunion, sur le canal #documentation-fr du Slack WordPress-fr.

#documentation, #ordre-du-jour

Compte-rendu de la 36ᵉ réunion de l’équipe Documentation du 13 juin 2024

La 36e réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 13 juin 2024 à 13h heure française, sur le canal #Documentation du slack WordPress Francophone.

Ordre du jour

  • Point avancement.
  • Point sur les mises à jour de la documentation.
  • Choix d’une nouvelle formulation du renvoi vers l’article Barre d’outils.
  • Échanges sur le projet de transfert/migration de la documentation sur GitHub et traduction à l’occasion de la journée de Contribution à la veille de l’ouverture du WordCamp Europe 2024 à Turin.

Personnes présentes

Point avancement

Depuis la dernière réunion du 16 mai 2024 :

  • +1 article traduit (267 sur 298 soit 89.6%)
  • aucun article rédigé en FR (21 sur 37 soit 56.8%)

Le pourcentage global d’avancement est de 86%.
Il reste peu d’articles à traduire, le choix est donc limité.

Rappel : consultez le tableau de suivi > Articles FR et n’hésitez pas à rédiger/suggérer des articles.
Indiquez votre pseudo ou prénom entre parenthèses à côté du titre.

Point sur les mises à jour de la documentation

Les mises à jour d’articles avancent bien.

6.4

40 mises à jour : 28 faites – 12 à faire
Donc, 70% est fait.

6.5

31 mises à jour : 12 faites – 5 en cours – 14 à faire
Donc, 40 % est fait

Choix d’une nouvelle formulation de renvoi vers l’article Barre d’outils

La formulation actuelle est :

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Parmi ces outils, on distingue des outils communs, présentés dans l’article Barre d’outils des blocs, et d’éventuels outils spécifiques, décrits ci-dessous. 

Souvent suivie par :

Le bloc XXXXX ne propose pas d’outil spécifique.

La formulation ci-dessous est adoptée pour simplifier :

Chaque bloc dispose d’une barre d’outils vous permettant de le manipuler directement dans l’éditeur. Les outils communs à la plupart des blocs sont décrits dans l’article Barre d’outils des blocs. Si le bloc dispose d’outils spécifiques, ils sont décrits ci-dessous.

Projet de migration des articles de la documentation sur le nouveau thème

Pendant la journée de contribution, le travail préalable à la migration des articles de la documentation vers le nouveau thème, qui correspond aussi à un changement d’url de fr.wordpress.org/support/ vers fr.wordpress.org/documentation/, a été initié. Par méconnaissance du projet de la documentation en FR et parce que nous n’avons pas été contactés en amont, une tâche de listage des correspondances entre les articles en anglais et ceux en français a été démarrée. Celle-ci a été arrêtée car nous disposons déjà de ces informations, et que par ailleurs, nous souhaitons préparer au mieux cette migration pour tenir compte des spécificités de la documentation en français.

À la suite de cela, Jenny a contacté Estela Rueda pour comprendre les autres tâches à effectuer pour cette migration. Ce point sera abordé à la prochaine réunion.

Projet de transfert de la documentation sur GitHub

Échanges sur le projet de transfert/migration de la documentation sur GitHub et traduction à l’occasion de la journée de Contribution à la veille de l’ouverture du WordCamp Europe 2024 à Turin.
Un manque d’information sur le projet et les échanges qui ont lieu ne permet pas d’adapter la structure des contenus déjà traduits pour faciliter une possible migration.
Une réunion au sujet de l’optimisation des traductions de la communauté est prévue, elle suit une matinée à la table de contribution Documentation animée par Estela Rueda et par Courtney Robertson. On apprend sur Make que Courtney postera les conclusions des échanges.
Une captation audio de ces échanges https://web.plaud.ai/share/ac791718286008841

Voir les liens ci-dessous pour plus d’informations :


La réunion se termine à 14h30.

La prochaine réunion aura lieu le 4 juillet 2024 à 13h.

#compte-rendu, #documentation-fr

Compte-rendu de la 35ème réunion de l’équipe Documentation du 17 mai 2024

La 35e réunion de l’équipe de la documentation de WordPress en français s’est tenue le vendredi 17 mai 2024 à 13h heure française, en visio.

Ordre du jour

  • Point avancement.
  • Point sur les mises à jour de la documentation.
  • News diverses.
  • Projet de transfert de la documentation sur GitHub et traduction.
  • Sujet remis à discussion : Comment documenter les nouveaux écrans listant les données ?

Personnes présentes

Point avancement

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

  • +1 article traduit (266 sur 298 soit 89.3%)
  • +2 articles rédigés (21 sur 36 soit 58.3%) et 3 nouvelles idées d’articles

Le pourcentage global d’avancement est de 85.9% (valeur la plus élevée atteinte !).

  • Pas de nouvel article publié côté doc en anglais.
  • Un article est en attente d’une seconde relecture : Écran Compositions de l’éditeur de site

📌Idées d’articles : « Documenter le Playground » ou « WP CLI »…
Consultez le tableau de suivi > Articles FR et n’hésitez pas à rédiger/suggérer des articles. Indiquez votre pseudo ou prénom entre parenthèses à côté du titre.

Point sur les mises à jour de la documentation

  • Pas trop de nouveautés liées à 6.5.3.
  • Difficultés à identifier les mises à jour d’articles, car l’équipe EN ne travaille plus sur WP mais sur Google docs.
  • Le Notion a été mis à jour pour refléter l’avancement des mises à jour des articles.
  • Attention à ne pas prendre de l’avance sur des fonctionnalités à venir et sujettes à changements.

6.3

Il reste un seul article à mettre à jour pour la 6.3, mais il doit être mis aussi à jour pour la 6.5, on peut donc considérer les mises à jour de la 6.3 terminées.

6.4

40 mises à jour : 26 faites + 1 en cours + 13 à faire (dont 4 en commun avec 6.5) donc finalement 9 à faire au titre de la 6.4

6.5

28 mises à jour : 6 faites + 1 en cours + 21 à faire

News diverses

Projet de transfert de la documentation sur GitHub et traduction

C’est un projet en cours porté par l’équipe de la locale Espagnol pour que la documentation soit hébergée sur GitHub et qu’un répertoire par locale soit créé, il n’y a pas vraiment d’avancée ni de communication officielle. Il n’y a rien à faire de notre côté pour l’instant.

Voir les liens ci-dessous pour plus d’informations :

Sujet remis à discussion : Comment documenter les nouveaux écrans listant les données

Après avoir discuter du sujet lors de la dernière réunion.

Une piste serait de faire un article générique (titre à définir en français) qui décrirait de façon générique les écrans qui affichent des listes de publications, de modèles ou encore de compositions, et d’y renvoyer l’internaute depuis des écrans spécifiques. Il s’agit par exemple de l’écran Pages accessible depuis Pages > Gérer toutes les pages dans l’éditeur de site.

🚩 On opte pour patienter pour l’instant, en attendant que ces écrans soient plus aboutis dans Gutenberg.

La réunion se termine par une présentation de ces différents écrans qui n’affichent pas les mêmes éléments mais qui fonctionnent de la même manière.


La réunion se termine à 14h40 (quels bavards!).

La prochaine réunion aura lieu le jeudi 6 juin 2024.

#compte-rendu, #documentation-fr

Ordre du jour de la 35ème réunion de l’équipe Documentation du 17 mai 2024

La 35ème réunion de l’équipe documentation de WordPress en français aura lieu le vendredi 17 mai 2024 à 13h heure française, sur le slack.

À l’ordre du jour :

  • Point avancement.
  • Point sur les mises à jour de la documentation.
  • News diverses.
  • Projet de transfert de la documentation sur GitHub et traduction.
  • Sujet remis à discussion : Comment documenter les nouveaux écrans listant les données ?

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 34ᵉ réunion de l’équipe Documentation du 11 avril 2024

La 34e réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 11 avril 2024 à 13h heure française, sur slack, avec un appel d’équipe pour pouvoir partager un écran.

Ordre du jour

  • Point avancement.
  • Vérification des mises à jour des versions 6.3 et 6.4.
  • Liste des mises à jour pour la version 6.5.
  • Comment documenter les nouveaux écrans listant les données.
  • Questions diverses.

Personnes présentes

Point avancement

Depuis la dernière réunion du 7 mars 2024 :

  • +4 articles traduits (265 sur 298 soit 88.9%)
  • +1 article rédigé en attente de relecture (19 sur 33 soit 57.6%)

Le pourcentage global d’avancement est de 85.2%

✔ Le taux d’avancement de 90% est presque atteint, les articles en cours de traduction lorsqu’ils seront publiés permettront probablement d’atteindre ce cap !

Vérification des mises à jour des versions 6.3 et 6.4

Pour la version 6.3

  • 31 articles sont à jour – soit 91%
  • 2 sont en cours de mise à jour
  • 1 article (Bloc Galerie) n’a pas été mis à jour (voir ce qu’il faut modifier pour la 6.3)

Pour la version 6.4

  • 16 articles sont à jour – soit 48.5%
  • 4 sont en cours de mise à jour
  • 13 articles restent à mettre à jour – le détail des issues n’a pas été vu

Liste des mises à jour pour la version 6.5

Pour la version 6.5

  • 4 articles sont à jour – soit 16%
  • 2 articles sont en cours de mise à jour
  • 19 articles sont à mettre à jour – le détail des issues n’a pas été vu

Comment documenter les nouveaux écrans listant les données

Le sujet concerne le fait que, dans l’éditeur de site, de nouveaux écrans sont disponibles pour lister les modèles, les éléments de modèles, les pages et les compositions.

Comment documenter ces nouveaux écrans dans les articles :

  • Écran Pages de l’éditeur de site (pour les pages)
  • Écran Compositions de l’éditeur de site (pour les compositions)
  • L’éditeur de modèles (pour les modèles et éléments de modèles)

ou

  • on crée un article pour l’ensemble de ces écrans (afin de ne détailler qu’une seule fois les fonctionnalités communes)

ou encore

  • on crée un article par écran ?

L’approche la plus plébiscitée est une approche centralisée (mutualisée) comme pour les réglages et outils communs des blocs. Mais aucune décision n’a été prise à ce sujet.

Jenny propose qu’en attendant que les écrans Pages et Articles (du tableau de bord) soient déplacés dans l’éditeur de site, on ne les documente pas dans des articles dédiés, mais seulement dans les articles de l’éditeur de site, tout en ajoutant un article sur les fonctionnalités communes à ces écrans (vue liste/grille, modifications groupées, pagination,…). Et que le jour où ces écrans sont uniquement dans l’éditeur de site, on mette à jour les articles qui leur correspondent avec la description de la nouvelle interface.

Mais Marie rappelle que les écrans Pages et Articles du tableau de bord ne vont pas disparaître rapidement, voire jamais pour des questions de rétrocompatibilité avec les thèmes classiques. Aussi l’approche de Jenny pose problème.

🚩Les membres de l’équipe sont invité·e·s à réfléchir à cette question, pour être en mesure de prendre une décision prochainement.

Questions diverses

Le Translation Day envisagé par l’équipe Traduction est abordé. Il aura probablement lieu avant l’été.

Laurent souligne qu’il serait intéressant de profiter de l’évènement pour faire savoir qu’il existe aussi un travail de traduction dans l’équipe documentation.

Tout le monde est convaincu qu’il est effectivement utile de faire connaître ce travail de traduction pour amener peut-être des personnes à s’intéresser à la documentation.

Par contre, il ne semble pas trop opportun de faire de l’initiation à la contribution à la documentation pendant l’évènement d’une part parce que ce n’est pas l’objet de l’évènement et d’autre part, au vu de la relative complexité d’intégrer de nouvelles personnes dans l’équipe (création d’un compte éditeur + droits sur le tableau de suivi), car souvent les personnes qui participent pendant un évènement de ce genre ne reviennent pas contribuer. Exemple des personnes qui ont été intégrées à l’équipe lors du Documentation Day du 17 juin 2022 et qui ne se sont plus manifestées après.


La réunion se termine à 14h05.

La prochaine réunion aura lieu le jeudi 2 mai 2024.

#compte-rendu, #documentation

Ordre du jour de la 34ème réunion de l’équipe Documentation du 11 avril 2024

La 34ème réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 11 avril 2024 à 13h heure française, sur le canal #documentation du Slack WordPress-fr.

À l’ordre du jour :

  • Point avancement.
  • Vérification des mises à jour des versions 6.3 et 6.4.
  • Liste des mises à jour pour la version 6.5.
  • Comment documenter les nouveaux écrans listant les données.
  • Questions diverses.

#ordre-du-jour