La 30ᵉ réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 7 décembre 2023 à 13h heure française, sur le canal #documentation-fr du Slack WordPress-fr.
Ordre du jour
- Point avancement.
- Mise à jour de la documentation pour la version 6.4.
- Méthode pour la description des captures avec numéros (suite des échanges précédents).
- Rythme et calendrier 2024 des réunions.
- Questions diverses
Personnes présentes
Point avancement
Depuis la dernière réunion du 2 novembre 2023 :
- 3 articles traduits (253 articles sur 298 soit 84.9%).
- Pas de nouvel article rédigé.
- 1 article importé (Twenty Twenty-Four).
Un pourcentage global d’avancement de 82.2%, bon résultat qui est la conséquence d’un rythme de 3/4 articles traduits depuis quelques mois.
À noter également : l’équipe Documentation en anglais est concentrée sur les mises à jour plutôt que sur de nouveaux articles pour le moment.
Mise à jour de la documentation pour la version 6.4
Toutes les issues définies par la team Doc en anglais pour la version 6.4 ont été reportées dans notre Notion.
Pas évident de trier les mises à jour selon leur statut car il y a chevauchement avec différentes versions.
Jenny a établi les statistiques suivantes pour se faire une idée :
Pour les modifications liées à la version 6.3 (56) :
- 33 sont terminées (59%)
- 5 en cours (9%)
- 18 à faire (32%)
Pour les modifications liées à la version 6.4 (40) :
- 9 sont terminées (23%)
- 5 en cours (12%)
- 26 à faire (65%)
Rappel du fonctionnement
Dans le tableau Notion sont indiquées les versions concernées. Quand un article est étiqueté pour plusieurs versions, il est recommandé de rédiger la mise à jour selon la dernière version, et donc d’incorporer aussi les versions précédentes.
Lorsqu’un article est mis à jour, les personnes s’inscrivent dans le tableau de suivi dans les colonnes correspondantes à leur intervention (auteur modifs ou relecture). Le tableau Notion est renseigné par Marie ou Jenny.
Méthode pour la description des captures avec numéros (suite des échanges précédents)
Rappel : sur certaines captures d’écran, il est parfois utile de mettre des pastilles numérotées dont les numéros sont repris dans le texte pour bien décrire l’élément de l’interface dont a fonctionnalité est détaillée.
Des applications comme Greenshot (Windows) ou Snip (Mac) aident à placer la numérotation sur les captures d’écran.
Le mois dernier nos discussions ont un peu dévié de « comment décrire les captures avec des pastilles numérotées ? » (au fil du texte vs sous forme de listes numérotées) à « faut-il généraliser ce procédé ? ».
Il est clair que l’annotation avec des pastilles numérotées n’est pas attendue des contributeurs et il n’est pas souhaitable de la généraliser car elle est très chronophage, et pose des problèmes d’accessibilité.
Recommandation pour la description des captures avec numéros :
Cette méthode n’est absolument pas à généraliser, elle demeure facultative et doit être réservée aux nouvelles interfaces ou à des manipulations complexes.
Cependant si cette méthode est utilisée la description se fait alors au fil du texte, avant ou après la capture avec le numéro placé entre parenthèses : il est ainsi plus facile de décrire l’emplacement de l’élément décrit.
D’autre part afin de s’assurer que les lecteurs d’écran ignorent ces numéros, il est proposé de placer des balises <span aria-hidden="true">(1)</span> autour de ces numéros.
Rythme et calendrier 2024 des réunions
Le rythme d’une réunion par mois est conservé pour le moment, de manière à permettre à un maximum de personnes de se joindre aux discussions et à l’équipe.
Le premier jeudi du mois est conservé comme rendez-vous mensuel.
La réunion se termine à 14 heures.
La prochaine réunion aura lieu le jeudi 11 janvier 2024 (exceptionnellement pas le premier du mois ;))
#compte-rendu
