Compte rendu de la 8ème réunion Documentation du 11 octobre 2021

La huitième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 11 octobre 2021 à midi heure française, en visioconférence.

Ordre du jour

  • Point sur l’avancement de la traduction.
  • Handbook sur les extensions.
  • Faire le point sur les contenus à importer.

Personnes présentes

Point sur l’avancement de la traduction

Depuis la dernière réunion du 13 septembre :

  • +6 articles traduits (153 sur 236 soit 64.8%).
  • Pas de nouveau contenu rédigé.

Le pourcentage global d’avancement est de 64.3%.

Il ne reste plus que quelques articles en attente de relecture. Un regain d’activité ces derniers jours !

Handbook sur les extensions

JB s’est lancé dans la rédaction d’un guide pour déposer et gérer son extension sur le répertoire WordPress.

La rédaction du document est pratiquement terminée et il peut être publié.

La discussion concerne l’emplacement dans lequel on publie cette documentation : sur le site « /support » (site de la documentation) ou sur le site « /team/handbook » (site de l’équipe FR où se trouve le Guide du traducteur).

Les deux emplacements ont leurs avantages et inconvénients :

  • Une meilleure visibilité sur « /support ».
  • Un emplacement plus logique dans « /team/handbook » qui est davantage dédié à la contribution qu’à l’utilisation de WP (qui est plutôt l’objectif de la documentation de « /support »).

L’équipe décide de publier dans la documentation (« /support »), dans la catégorie Développement, et de communiquer sur cette publication via une news afin de faire connaître son existence. Il sera toujours possible par la suite, si cette documentation s’étoffe de la déplacer dans un Handbook spécifique.

Depuis la réunion, l’article a été relu et publié.

Point sur les contenus à importer

Certains articles de la documentation en anglais ne sont pas présents dans notre liste, tous ne sont pas à importer, mais il serait bien de voir si parmi les nouveaux articles (comme par exemple celui sur le répertoire des compositions), quels sont les articles à importer.

Jenny propose de faire une liste des contenus manquants, et de statuer sur leur importation dans un second temps.

Concernant les articles sur les blocs « Embeds » : l’équipe EN présente chaque type de contenu embarqué dans un article. De notre côté, nous décidons de faire un article pour tous les types de contenu embarqué, et d’indiquer uniquement les réglages spécifiques à chacun.

Santé du site : un article sur l’outil Santé du site a été publié côté EN, et Marie en avait commencé la rédaction avant cela. Il est décidé de ne pas importer l’article EN mais de comparer leurs contenus avant publication du FR.

WordPress 5.9 : Besoin d’une personne pour coordonner la documentation

JB nous signale que l’équipe de WP 5.9 cherche son lead documentation.

Cette personne sera en charge de coordonner la documentation de cette prochaine version majeure de WordPress :

  • Identifier les points à documenter.
  • Contacter les personnes pour leur demander si elles peuvent faire telle tâche, les relancer.
  • Coordonner les différentes équipes (doc, tech…) pour la publication de la documentation.

Si ce challenge vous intéresse, vous pouvez nous contacter sur le Slack.

Divers

Lorsqu’on a traduit ou rédige un article, attention aux particularités liées au thème actif sur nos environnements de test. Il est important de garder en tête que les options d’un thème ne seront pas valables pour n’importe quelle installation.

Si nécessaire, installer un thème blank type Underscores pour ne voir que les options de WordPress et donc universelles.

La réunion s’est terminée à 13h, rendez-vous le lundi 15 novembre pour la prochaine réunion et en attendant, toujours sur le canal #documentation-fr du Slack !

#compte-rendu

Ordre du jour de la 8ème réunion Documentation du 11 octobre 2021

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

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

À l’ordre du jour :

  • Point sur l’avancement de la traduction.
  • Handbook sur les extensions.
  • Faire le point sur les contenus à importer.

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

Compte rendu de la 7ème réunion Documentation du 13 septembre 2021

La septième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 13 septembre 2021 à midi heure française, en visioconférence.

Ordre du jour

  • Point sur l’avancement de la traduction.
  • La catégorisation des articles.
  • WPTD et traduction de la documentation.
  • Traduction des handbooks.

Point sur l’avancement de la traduction

Depuis la dernière réunion du 12 juillet 2021 :

  • + 1 article traduit (147 sur 235 soit 62.6%)
  • Pas de changement pour les articles rédigés (59.3%)

Le pourcentage global d’avancement est de 62.2%

A noter, qu’il y a plusieurs articles en attente de relecture.

Catégorisation des articles

Ce chantier, abordé lors de la précédente réunion, concerne la réorganisation des catégories, qui sont parfois en doublon

La tache est encore à réaliser. Il faut que la personne qui l’effectue le signale dans le canal #documentation-fr du slack WordPress-FR

WPTD

L’équipe de la documentation ne propose rien de spécial pour le WordPress Translation Day du 24 septembre 2021. Si des personnes sont intéressées, elles peuvent commencer la traduction d’un article et poser des questions si elle rencontre des difficultés.

Traduction des handbooks

La liste fournie est celle des handbooks traduits par l’équipe japonaise.

Priorisation :

  • Plugins
  • Thèmes
  • Accessibilité

Pour le « Handbook plugins », l’objectif est de partir sur une documentation simple destinée aux développeurs d’extensions qui souhaitent déposer une extension sur le répertoire.

Si vous souhaitez participer, contactez Jb Audras (JB).

https://docs.google.com/document/d/1aHpedVOCV57uH_TM50ligsE13VZJ3gz3uTYdGjLTI9o/edit?usp=sharing

On laisse de côté les autres handbooks pour l’instant.

Commentaires des articles de documentation

Les commentaires ont été autorisés depuis quelques mois sur la documentation.

Les personnes qui ont commenté n’ont pas utilisé correctement le formulaire qui avait pour objectif de connaître l’opinion des utilisateurs/utilisatrices de la documentation et non de poser des questions sur les fonctionnalités abordées dans l’article.

L’équipe décide donc de :

  • Supprimer l’autorisation de commenter pour les articles (Jenny).
  • Désapprouver les commentaires existants (Marie).

Pensez à décocher l’option Autoriser les commentaires si vous la voyez cochée pour un article.


Rendez-vous le lundi 11 octobre pour la prochaine réunion.

#compte-rendu

Ordre du jour de la 7ème réunion Documentation du 13 septembre 2021

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

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

À l’ordre du jour :

  • Point sur l’avancement de la traduction.
  • La catégorisation des articles.
  • WPTD et traduction de la documentation.
  • Traduction des handbooks.

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 6ème réunion Documentation du 12 juillet 2021

La sixième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 12 juillet 2021 à midi heure française, en visioconférence.

Ordre du jour

  • Point sur l’avancement.
  • Catégorisation des articles de la documentation.
  • Mise à jour de la documentation pour la sortie de WordPress 5.8.
  • Démonstration du fonctionnement des mises à jour planifiées.

Personnes présentes

Sujets abordés

Point sur l’avancement

Depuis la dernière réunion (14 juin 2021) :

  • +2 articles traduits (146 sur 235, soit 62.1%).
  • +3 articles importés (235 au total).
  • Pas de changement pour les articles rédigés.

Le pourcentage global d’avancement est de 61.8%.
A noter qu’il y a plusieurs articles en attente de relecture.

Catégorisation des articles

Il s’agit de réorganiser les catégories des articles de la documentation qui comporte des doublons et des catégories vides.

Dans un premier temps, il est nécessaire de supprimer les catégories en doublon, tout en ayant placé les articles contenus dans ces catégories en doublon, dans la catégorie conservée. Marie (@chaton666) se charge d’effectuer cette opération (qu’il n’est pas souhaitable d’effectuer à plusieurs afin d’éviter de faire des erreurs, comme par exemple, de supprimer les deux catégories en doublon).

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

Jenny (@jdy68) a établi la liste des modifications à effectuer :

  • Article à traduire :
    • L’éditeur de widgets.
    • L’éditeur de modèles.
  • Articles à modifier :
    • Écran Menus (ajout de la suppression simultanée de plusieurs éléments de menu – modification effectuée par le collègue de @audrasjb, auteur de la fonctionnalité).
    • Les blocs (ajout des nouveaux blocs et réorganisation des paragraphes).
    • Bloc Colonnes (ajout marge interne).
    • Réglages communs des blocs (ajout couleur du lien).
    • Bloc Fichier (ajout de l’aperçu PDF).
    • Bloc Image (fonctionnalité duo-tone et crop).
    • Bloc Icônes de réseaux sociaux (justification et espacement des boutons).
    • Les blocs réutilisables (modification de la procédure d’enregistrement et mise à jour à partir d’une occurence du bloc vers toutes les occurences).

A noter qu’il faut ajouter ou mettre à jour le bloc « Journal des modifications » lorsqu’on effectue des modifications sur un article de la documentation.

Démonstration du fonctionnement des mises à jour planifiées.

Jenny (@jdy68) fait une démonstration du fonctionnement de cette fonctionnalité développée par Corey Mc Krill (@coreymckrill).
Cette fonctionnalité est utile pour faire des modifications en plusieurs fois ou pour différer la publication des modifications concernant des nouvelles fonctionnalités à une date ultérieure, lors de la sortie d’une nouvelle version de WordPress par exemple.

Une page du handbook sera rédigée par Jenny (@jdy68) pour expliquer comment cela fonctionne.


La réunion s’est terminée à un peu plus de 13h rendez-vous lundi 13 septembre 2021 pour la prochaine réunion.

#compte-rendu, #documentation-fr

Ordre du jour de la 6ème réunion Documentation du 12 juillet 2021

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

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

À l’ordre du jour :

  • Point sur l’avancement.
  • Catégorisation des articles de la documentation.
  • Mise à jour de la documentation pour la sortie de WordPress 5.8.
  • Démonstration du fonctionnement des mises à jour planifié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 5ème réunion Documentation du 14 juin 2021

La cinquième réunion de l’équipe de la documentation s’est tenue le lundi 14 juin 2021 à midi heure française, en visioconférence.

La réunion du mois de mai a été annulée en l’absence de sujets à traiter.

Ordre du jour

  • Point sur l’avancement.
  • Bilan du WPTD-FR 2021.
  • Catégorisation des articles de la documentation.
  • Présentation de l’espace de travail Notion.

Personnes présentes

Sujets abordés

Point sur l’avancement

Depuis la dernière réunion (12 avril 2021) :

  • +14 articles traduits (144 sur 232 soit 62.1%)
  • +4 articles rédigés (16 sur 27 soit 59.3%)
  • Le pourcentage global d’avancement est de 61.8%

Bilan WPTD du 30 avril 2021

Lors du WPTD du 30 avril, nous avons présenté le fonctionnement de l’équipe de documentation de WordPress en français, ainsi que l’avancement du travail. Nous avons accueilli Romain Vincent, qui a traduit son premier article pendant l’évènement. La documentation a été au final peu abordée ce jour, car les personnes présentes ont posé plutôt des questions concernant la traduction de l’interface de WordPress et de ses extensions et thèmes.

Nous nous posons la question des raisons pour lesquelles l’effectif de l’équipe s’est réduit au fil du temps.

Marie propose la tenue d’un évènement du même type dédié à la documentation. Ce qui pourrait être un moyen d’agrandir l’équipe. Nous sommes tous d’accord sur le fait que cet évènement doit être programmé après l’été.

Présentation de l’espace de travail Notion

Depuis le début du chantier de la traduction de la documentation en français, nous utilisons seulement deux outils pour organiser notre travail : le tableau de suivi et un canal Slack.

Il y a quelques mois a été évoquée l’idée d’utiliser un outil plus adapté qui nous permettrait de mieux gérer les différents aspects liés à nos contributions :

  • la prise de notes ;
  • les dates et sujets des réunions ;
  • la gestion éditoriale (suivi des publications, points sur les avancements, etc.) ;
  • les documents utiles ;
  • la liste des membres de l’équipe ;
  • la liste des tâches à effectuer.

Jenny a testé l’outil Notion, qui se rapproche un peu de Trello, mais qui offre plus de fonctionnalités et qui est plus personnalisable. Elle s’est occupée de créer un espace pour l’équipe de Documentation, qui est déjà assez complet, et qu’elle nous a présenté lors de cette réunion.

C’est l’association WPFR qui sponsorise ce compte Notion, qui est payant, à hauteur de 4$ par utilisateur et par mois, sur lequel seuls les comptes administrateurs sont payants.
Nous avons la possibilité de fonctionner avec des comptes « invités », qui sont gratuits, et qui vous permettront si vous le souhaitez, d’accéder à plusieurs parties de cet espace.

Certains endroits sont accessibles en lecture comme les pages concernant les réunions. Pour ajouter des sujets, il vous faudra un compte Notion. Voici un tutoriel expliquant la création d’un compte Notion.

Pour plus d’informations, rejoignez-nous sur le Slack, canal #documentation-fr.

Catégorisation des articles de la documentation

Ce point concerne une réorganisation des catégories sur le support, qui est aujourd’hui pas optimale (présence de doublons, catégories vides).

Nous n’avons pas eu le temps de traiter ce sujet, qui est reporté, mais sur lequel nous continuons de travailler.

La réunion s’est terminée à 13h rendez-vous le lundi 12 juillet pour la prochaine réunion.

#compte-rendu

Ordre du jour de la 5ème réunion Documentation du 14 juin 2021

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

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

À l’ordre du jour :

  • Point sur l’avancement.
  • Bilan du WPTD-FR 2021.
  • Catégorisation des articles de la documentation.
  • Présentation de l’espace de travail 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 4ème réunion Documentation du 12 avril 2021

La quatrième réunion de l’équipe de la documentation s’est tenue le lundi 12 avril 2021 à midi heure française, en visioconférence.

Ordre du jour

  • Point sur l’avancement.
  • Annonce du WPTD-FR 2021.
  • Présentation du « Season of docs » par Justin Ahinon.
  • Fonctionnement de la mutualisation des contenus pour les articles concernant les blocs.
  • Styles à utiliser dans la documentation.

Personnes présentes

Point sur l’avancement

Par rapport au point précédent du 8 mars 2021 :

  • 1 article traduit (130 articles publiés sur 230 soit 56.5%).
  • 2 articles créés (12 articles publiés sur 26 soit 46.2%).

Au vu de ces chiffres, l’avancement semble faible, mais ce bilan est à relativiser car nous avons réussi à mettre en place la mutualisation des contenus concernant les blocs (voir ci-dessous) et 9 articles sont en attente de relecture (dont plusieurs devront être remaniés suite à cette mutualisation des contenus car ils concernent des blocs).

Annonce du WPTD-FR 2021

Marie nous annonce que le WordPress Translation Day – FR 2021 aura lieu le 30 avril de 14h à 18h. Valérie indique qu’elle communiquera cette information sur le site de l’association WPFR.
JB rappelle que les WPTD sont l’occasion de bien avancer sur des projets et de former des personnes qui débutent dans la contribution à la traduction.
Pour la traduction de la documentation, JB propose que nous préparions une petite liste d’articles courts qui se prêteraient bien à former de nouvelles personnes.

Présentation du « Season of docs »

Justin Ahinon qui fait partie de l’équipe de Documentation de WordPress nous présente le Google Season of docs 2021 : il s’agit d’un programme de Google afin de soutenir la rédaction et l’amélioration de documentations techniques concernant des projets open source. En attendant l’annonce des projets retenus, qui est prévue le 16 avril 2021, les commentaires sont toujours ouverts sur la liste d’idées de projets. Si vous êtes intéressés par ce projet, il est encore temps pour vous faire connaître auprès de Justin, ou de nous en parler.

L’an dernier le « Season of docs » avait débouché sur la rédaction d’un excellent guide concernant la mise en forme de la documentation de WordPress mené par Atharva Dhekne.

Fonctionnement de la mutualisation des contenus pour les articles concernant les blocs

La mutualisation des contenus pour les articles concernant les blocs a été mise en place par Marie et Jenny. Le principe est simple, tous les contenus qui sont répétés dans chaque article de bloc ont été déplacés dans des articles dédiés qui sont ciblés dans les articles concernant les blocs.

Jenny explique comment cette mutualisation a été organisée.

Nous avons plusieurs articles mutualisés qui concernent :

Et des renvois vers ces articles mutualisés dans les articles concernant les blocs s’effectuent via des blocs réutilisables.

Pour guider les traducteurs/traductrices et rédacteurs/rédactrices, une page du handbook dédiée à l’implémentation de ces renvois vers les articles mutualisés a été rédigée.

JB suggère de présenter cette organisation des contenus avec un exemple lors du WPTD-FR du 30 avril.

Justin est très intéressé par ce concept de mutualisation. Nous lui faisons part que nous avons déjà informé l’équipe Documentation de WordPress et proposé ces contenus, mais cette proposition n’a débouché sur aucune réponse. Justin décide qu’il en parlera à la réunion de l’équipe qui a lieu quelques heures après, et Jean-Baptiste lui fournira une capture d’écran pour expliquer ce que nous avons mis en place.

Styles à utiliser dans la documentation

Dans un souci d’homogénéisation des styles utilisés dans les articles de la documentation dont l’objectif est de faciliter la compréhension de la documentation, un mémento des styles à utiliser dans la documentation a été ajouté au Guide de traduction de WordPress en français.

Pour rédiger cette page, Jenny s’est appuyée sur le très complet guide des styles de la documentation de WordPress (issu du Season of Docs de 2020).

Les contributeurs et contributrices à la documentation de WordPress sont invités à prendre connaissance des styles à utiliser et à les implémenter au maximum dans les articles qu’ils traduisent ou rédigent, en gardant en tête lors des traductions, que ces styles sont prioritaires sur la mise en forme des articles sources en anglais.

Fin de la réunion à 13h.

La prochaine réunion aura lieu le lundi 10 mai 2021.


Note : la présentation de la mutualisation des contenus concernant les blocs, faite par Justin lors de la réunion de l’équipe Documentation de WordPress, a retenu l’attention de l’équipe. Voir le compte-rendu de cette réunion – paragraphe Open Floor. Merci Justin pour cette transmission à l’équipe Documentation de WordPress.

#compte-rendu, #documentation-fr

Ordre du jour de la 4ème réunion Documentation du 12 avril 2021

This image has an empty alt attribute; its file name is documentation-wordpress-team-fr_FR-1024x427.png

La quatrième réunion de l’équipe documentation de WordPress en français aura lieu le lundi 12 avril 2021 à 12h heure française, en visioconférence.

À l’ordre du jour :

  • Point sur l’avancement.
  • Annonce du WPTD-FR 2021.
  • Présentation du « Season of docs » par Justin Ahinon.
  • Fonctionnement de la mutualisation des contenus pour les articles concernant les blocs.
  • Styles à utiliser dans la documentation.

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