Compte-rendu de la 17ème réunion de l’équipe Documentation du 11 juillet 2022

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 :

  • :100: Approbation de la modification
  • :point_d'interrogation_rouge: Questionnement/incertitude sur la modification
  • :x: Désapprobation de la modification
  • :coche_blanche: 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

Ordre du jour de la 17ème réunion de l’équipe Documentation du 11 juillet 2022

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

À l’ordre du jour :

  • Point avancement.
  • Bilan du Documentation Day du 17 juin 2022.
  • Gestion des contenus en français du Codex.
  • Mise en place de codes sur Slack pour le travail en commun sur un article

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

Ordre du jour de la 59ème réunion de l’équipe de traduction du 4 juillet 2022

L’ordre du jour est le suivant :

 12h, le 4 juillet 2022

La réunion se tiendra sur le Slack WordPress FR canal #traductions.

Pensez à alimenter le Trello avec les sujets qui vous intéressent, et à voter les sujets pour les prochaines réunions.

Vous pouvez donner votre avis sur les cartes des sujets sur le Trello (n’hésitez pas à demander l’accès sur le canal #traductions du Slack WordPress FR).

Merci à toutes et tous pour votre participation et vos contributions !

#ordre-du-jour, #traduction

Compte-rendu du Documentation Day – FR du 17 juin 2022

Bannière de l’évènement

Le Documentation Day – FR a été organisé à l’initiative de l’équipe de documentation de WordPress en français. Cet évènement en ligne avait pour objectif de proposer un tour d’horizon complet sur ce projet qui constitue un moyen intéressant de contribuer.

Durant ces trois heures, nous avons donc accueilli une quinzaine de participants de divers horizons (conception de sites WordPress et développement WordPress), souhaitant en savoir plus sur la contribution à la documentation en français ou faisant déjà partie de l’équipe.

Cet évènement a réuni de « nouvelles têtes » :

  • Clément Boirie
  • Benjamin Gosset
  • Jérémy Marchandeau
  • Pierre Mobian
  • Jean Michel Silone
  • Rachel Peter

des membres de l’équipe :

  • Sylvie Clément
  • Didier Demory
  • Gabrielle Fouix
  • Valérie Galassi
  • Laurent Millet
  • Patrick Olivaud
  • Jason Rouet
  • Bruno Tritsch

accueilli·e·s par les animateurs et animatrices de l’évènement : JB Audras, Marie Comet et Jenny Dupuy.

En s’appuyant sur le diaporama, réalisé par Jenny, Laurent et Marie, et proposé en fin d’article, nous avons présenté le projet, l’équipe et son fonctionnement, les outils utilisés et répondu aux questions des participants.

À l’issue de l’évènement, l’équipe s’est agrandie, puisque Clément Boirie, Benjamin Gosset, Jérémy Marchandeau, Pierre Mobian et Jean Michel Silone ont exprimé le souhait de contribuer prochainement…Bienvenue à vous 5 ! Nous sommes ravi·e·s de vous accueillir dans l’équipe et prêt·e·s à vous épauler dans vos contributions.

Pour ceux qui n’ont pas pu participer, ou ceux qui souhaitent conserver les informations diffusées pendant cet évènement, nous communiquons ici la présentation.

Ce diaporama est composé d’une première partie « Présentation du projet » qui détaille les objectifs, la chronologie et l’avancement du projet, la composition de l’équipe, son flux de travail et les outils utilisés. Puis une seconde partie « Foire aux questions » répond aux questions les plus fréquentes que se posent les contributeurs et contributrices débutant·e·s ou confirmé·e·s ! Cette deuxième partie (FAQ) devrait prochainement être intégrée au guide Traduire la documentation de WordPress en français, guide de référence pour toute personne souhaitant contribuer à la documentation.

Comme nous l’évoquions lors de la réunion du 9 mai dernier, cet événement en ligne était aussi l’occasion de préparer des supports à fournir aux équipes des meetups locaux, en vue d’un événement en présentiel et distanciel en septembre.
Nous disposons donc maintenant d’un support complet, et nous verrons en fonction des plannings de chacun s’il est possible d’organiser un événement en présentiel plus tard dans l’année.

Si vous souhaitez rejoindre l’équipe, vous avez maintenant toutes les informations nécessaires.
À vous de jouer !

Nous vous disons donc  : « à bientôt » et espérons vous rencontrer lors de futurs évènements en distanciel ou présentiel !

Merci à tous pour votre participation à cet évènement et pour votre contribution (présente, passée ou future) à ce beau projet qu’est la documentation de WordPress en français.

#evenement-2, #documentation-fr