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
