Compte rendu de la 2ème réunion Documentation du 8 février 2021

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

Ordre du jour

  • Point sur « où en sommes-nous ? où allons-nous ? ».
  • Organisation de la création d’un ticket sur core pour remplacer les mentions vers le Codex par des liens vers la documentation.
  • Anticiper les changements dans la prochaine version de WordPress (5.7) et leurs ajustements/créations sur la documentation.

Personnes présentes

Point sur nos avancées

Par rapport au point précédent du 4 janvier 2021 :

  • + 16 articles traduits, 115 articles sont publiés sur 224 soit 51.3%.
  • + 9 articles créés (dont 6 sur l’accessibilité et 3 sur les options supplémentaires / réglages avancés / contrôles de texte enrichis des blocs).

Jenny compte préparer un petit aide mémoire pour intégrer des liens vers ces articles dans les articles concernant les blocs, le but étant d’alléger les articles et de n’y mettre que ce qui est spécifique au bloc concerné. Cet aide mémoire sera ajouté au guide du traducteur.

Au total il y a plus d’articles publiés (124) que d’articles en brouillons (115).

5 nouveaux articles ont été importés :

  • sur des blocs (recherche, nuage mots-clés, groupe) ;
  • le répertoire des blocs ;
  • HTTPS pour WordPress.

Également des articles qui n’étaient pas présents dans /support mais qui faisaient partie de la liste dans le tableau :

  • les blocs des contenus embarqués YouTube, Facebook et Twitter ;
  • le bloc Calendrier.

Concernant le suivi des imports de nouveaux articles, à l’avenir nous les signalerons sur le Slack en plus de l’ajout au tableau.

Remplacement des liens vers le Codex

Dans le tableau de bord, il reste des liens qui mènent vers le Codex, ancienne documentation de WordPress. Des redirections ont été mises en place, mais pas sur tous les articles.

Il est proposé de remplacer ces liens vers la nouvelle documentation en français lorsqu’elle existe.
Ce type de demande de modification se fait sur Trac, le gestionnaire de tickets de WordPress.

Nous pouvons réaliser cette tâche à plusieurs, en s’appuyant notamment sur une série d’articles rédigée par JB.

Voici les étapes à suivre et les personnes qui se proposent de les accomplir :

  1. Préparer le ticket (Marie).
  2. Préparer la liste des liens à mettre à jour (fait par Jenny, il y en a 14, et Miky a également fait une liste).
  3. Faire le patch (Valérie ou Miky accompagnés de JB).
  4. Soumettre le ticket sur Trac (Marie).

Nous poursuivrons les échanges sur Slack dans le canal #documentation-fr pour avancer sur ce projet.

Anticiper les changements dans la prochaine version de WordPress (5.7)

La prochaine version de WordPress (5.7) apportera de nouvelles fonctionnalités, qui pour certaines entraîneront des ajouts ou des modifications à la documentation.

JB, qui contribue à cette version notamment sur la rédaction des notes de développement, nous expose la difficulté des équipes de la documentation à y retranscrire les évolutions de WordPress.

Certains changements du cœur n’ont d’ailleurs jamais été mis à jour ou publiés dans la documentation.

JB propose, pour la version 5.7, de noter les changements qui nécessitent un nouvel article ou une modification dans la documentation. Ainsi, nous pourrons anticiper ces changements et les reporter dans la documentation.

Nous pouvons utiliser les notes de développement pour connaître les nouvelles fonctionnalités, mais elles arrivent parfois en retard. Cependant la liste des notes de développement qui seront rédigées est accessible publiquement.

Pour finir, il pourrait être intéressant de publier ces articles en français, puis de les transmettre à l’équipe de la documentation en anglais.

#compte-rendu