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 :
- Approbation de la modification
- Questionnement/incertitude sur la modification
- Désapprobation de la modification
- 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