Ordre du jour de la 21ème réunion de l’équipe Documentation du 1er décembre 2022

La vingt et unième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 1 décembre 2022 à 13h heure française, en visioconférence.

Le jour et l’horaire de la réunion mensuelle ont été modifiés pour permettre à un plus grand nombre de membres de l’équipe de participer aux réunions. Dorénavant, les réunions auront donc lieu le 1er jeudi du mois à 13 heures.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.1.
  • Traduction d’un article du blog developer.wordpress.org.

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

Compte-rendu de la 20ème réunion de l’équipe Documentation du 10 novembre 2022

La vingtième réunion de l’équipe de la documentation de WordPress en français s’est tenue le jeudi 10 novembre 2022 à treize heures (heure française), en visioconférence.

Ordre du jour

  • Point avancement.
  • Espace de travail sous Notion.
  • Mise à jour de la documentation pour la version 6.1.

Personnes présentes

Point avancement

Depuis la dernière réunion du 10 octobre 2022 :

  • Pas de nouvel article traduit, ni rédigé, ni importé du codex.
  • 1 article en attente de relecture (publié depuis).
  • +2 articles importés.

Le pourcentage global d’avancement est de 77.6% (sans tenir compte du Codex).

Pour les pages du Codex, l’avancement global est toujours de 48.6%.

Contenu de l’article Réglages communs des blocs.

Ce sujet n’était pas à l’ordre du jour mais il est évoqué dans le point fait sur l’actualité de la documentation officielle de WordPress. L’équipe de la documentation officielle a, en effet, mis en place des articles qui présentent des fonctionnalités communes à tous les blocs ou à un très grand nombre de blocs, soit les réglages de typographie, couleur, bordure, mise en page, dimensions, styles. Ce que nous avons déjà réalisé lors de la mise en place de la mutualisation des contenus pour les articles concernant les blocs, dans l’article Réglages communs des blocs.

La discussion se porte sur : découpons-nous l’article « Réglages communs des blocs » en plusieurs articles (comme dans la version officielle en anglais) ou complétons-nous l’article « Réglages communs des blocs » avec les éléments manquants (à savoir mise en page et bordure) ?

Les avantages d’un seul article :

  • De n’avoir rien à modifier dans les articles concernant les blocs qui contiennent tous déjà un lien vers cet article des réglages communs.
  • Les lecteurs et lectrices de la documentation peuvent prendre connaissance d’autres réglages communs juste en les voyant dans le sommaire.
  • Pas de création de nouveaux articles.
  • Conservation du référencement.

Les inconvénients d’un seul article :

  • Article au contenu assez long.
  • Le renvoi vers l’article des réglages communs peut être effectué uniquement pour un seul type de réglages, ce qui peut entraîner une certaine confusion concernant les réglages des blocs pour les utilisateurs/utilisatrices de la documentation.

Les avantages de plusieurs articles :

  • Clarté pour les utilisateurs et utilisatrices.
  • Synchronisation entre le HelpHub officiel et HelpHub FR simplifiée.

Les inconvénients de plusieurs articles :

  • Il faut effectuer le découpage en plusieurs articles et créer de nouveaux articles.
  • Il faut ajouter les liens vers les articles dans chaque article concernant un bloc selon les réglages que le bloc propose (demande donc à vérifier les réglages présents pour chaque bloc).
  • Perte du référencement.

🚩 L’équipe opte pour une mise à jour de l’article « Réglages communs des blocs » car c’est cette option qui implique le moins de travail à effectuer.

Espace de travail sous Notion.

L’association WPFR est ok pour financer un outil pour le travail collaboratif de l’équipe de documentation. Pour l’instant, un espace de travail Notion contient les informations concernant les réunions, le calendrier de publication, les tableaux d’avancement, ect. D’autres outils auto-hébergés ont été rapidement testés afin de voir si on pouvait utiliser un autre outil que Notion.

Nous discutons sur ces outils auto-hébergés : le travail lié à l’installation-maintenance d’un tel outil est évoqué comme étant un frein car gourmand en temps, tout comme la recherche de l’outil lui-même, ainsi que le temps nécessaire à sa prise en main.

🚩 L’équipe choisit donc de conserver l’outil Notion afin de ne pas engendrer de travail supplémentaire lié à la gestion du travail de l’équipe.
L’espace actuel va être migré dans un nouvel espace car il n’est pas correctement rattaché à l’abonnement de l’association WPFR.

Mise à jour de la documentation pour WP 6.1

La liste des issues concernant la version 6.1 avait été reportée dans un tableau/kanban sous Notion, cette liste a été complétée, et des éléments ont été ajoutés pour chaque item de la liste :

  • Un lien vers issue GitHub (afin de ne pas recopier les actions à mener qui sont déjà détaillées dans l’issue GitHub – même si ces actions doivent être adaptées au cas par cas à la version française puisque les contenus des articles ne sont pas à 100% synchronisés).
  • Des étiquettes Versions WP ont aussi été ajoutées quand des modifications existent pour les versions 5.9 et 6.0 de WordPress.
  • Des étiquettes Type (MAJ, Création d’article, Sans Objet) ont été ajoutées afin de pouvoir visualiser l’action globale à mener pour l’article.

🚩 Cette liste devra être mise à jour, au fur et à mesure de l’avancement, mais aussi avec les nouvelles issues déclarées dans GitHub.

Par ailleurs une page de documentation concernant la procédure de mise à jour des articles va étré rédigée dans le handbook, lorsqu’elle sera publiée, un lien sera ajouté dans le canal #documentation-fr du slack WordPressFR


La réunion se termine à 14H.

La prochaine réunion est prévue le 1er décembre 2022 à 13h.

#compte-rendu

Ordre du jour de la 20ème réunion de l’équipe Documentation du 10 novembre 2022

La vingtième réunion de l’équipe documentation de WordPress en français aura lieu le jeudi 10 novembre 2022 à 13h heure française, en visioconférence.

Le jour et l’horaire de la réunion mensuelle ont été modifiés pour permettre à un plus grand nombre de membres de l’équipe de participer aux réunions. Dorénavant, les réunions auront donc lieu le 1er jeudi du mois à 13 heures. La tenue de la réunion ce jeudi 10 novembre (deuxième jeudi du mois) est donc exceptionnelle.

À l’ordre du jour :

  • Point avancement.
  • Mise à jour de la documentation pour la version 6.1.
  • Espace de travail sous Notion.

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

Compte-rendu de la 19ème réunion de l’équipe Documentation du 10 octobre 2022

La dix-neuvième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 10 octobre 2022 à midi heure française, en visioconférence.

Ordre du jour

  • Point avancement.
  • Mise à jour de la documentation pour WP 6.1.
  • Test du flux de travail proposé pour la traduction des contenus de Learn WP.

Personnes présentes

Point avancement

Depuis la dernière réunion du 12 septembre 2022 :

  • +2 articles traduits (214 sur 267, soit 80.1%).
  • +1 articles importé.
  • Pas de nouvel article rédigé directement en français, ni d’article issu du Codex.
  • 1 article en attente de relecture.

Le pourcentage global d’avancement est de 78.1% (sans tenir compte du Codex).

Pour les pages du Codex, l’avancement global est toujours de 48.6%.

📊 À cette date, il reste 39 articles à traduire, ils concernent les sujets suivants :

  • Les blocs (en particulier les blocs utilisés dans l’éditeur de site) : 15 ;
  • L’éditeur de blocs : 7 ;
  • L’éditeur classique : 1 ;
  • Sujets plutôt orientés développement : 7 ;
  • La création de contenus, les commentaires, les rétroliens : 4 ;
  • Le multisite : 3 ;
  • La FAQ Travailler avec WordPress et comment trouver de l’aide.

N’hésitez pas à vous assignez un article qui vous intéresse. Dans le tableau de suivi, les titres des articles ont été colorisés pour reprendre cette classification, vous avez la signification des codes couleurs en remarque dans la cellule « Original Title ».

    Mise à jour de la documentation pour WP 6.1.

    À la réunion précédente, la liste des modifications à apporter aux diverses documentations (en particulier la documentation utilisateur et les handbooks de developer.wordpress.org), nous avez été fourni par JB. À partir de cette liste, un processus a été défini :

    1. Identifier les mises à jour à effectuer (un kanban a été créé dans cet objectif sous Notion).
    2. Différencier mises à jour d’articles existants et créations d’articles.
    3. Établir les priorités.
    4. Utiliser la fonctionnalité de mise à jour planifiée (Updates), ce qui permet d’une part, de pouvoir faire les modifications en plusieurs sessions (tout comme lorsqu’on traduit ou rédige), et d’autre part, d’effectuer une relecture avant publication. Cette fonctionnalité sera documentée dans le Guide du Traducteur. Ne pas oublier de compléter le journal des modifications de l’article.
    5. Relecture et validation des articles modifiés, puis publication.
    6. Report des modifications effectuées dans la table Modifications sous Notion.

    JB nous fournit un autre lien plus adapté contenant toutes les « issues » ouvertes concernant la documentation utilisateur (au nombre de 81) avec en plus un classement en termes de priorité.

    🚩 Nous allons donc, dans un premier temps, nous concentrer sur les « issues » étiquetées « high priority ».

    Test du flux de travail proposé pour la traduction des contenus de Learn WP.

    Nous proposons de suivre les flux de travail intiés par l’équipe de Learn WordPress tout en notant les points qui nous posent problème afin de pouvoir faire nos retours sur ces processus.

    Il nous faut donc choisir quelques contenus et en proposer une version française.

    🚩 Si la traduction de Learn WordPress vous intéresse, on en discute ensemble dans le canal #documentation-fr du slack WordPress-FR. Le choix des ressources à traduire sera bien évidemment fait avec les personnes intéressées.


    La réunion se termine à 13H.

    La prochaine réunion est prévue le 14 novembre 2022 à midi.

    #compte-rendu

    Ordre du jour de la 19ème réunion de l’équipe Documentation du 10 octobre 2022

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

    À l’ordre du jour :

    • Point avancement.
    • Mise à jour de la documentation pour WP 6.1.
    • Test du flux de travail proposé pour la traduction des contenus de Learn WP.

    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

    Compte-rendu de la 18ème réunion de l’équipe Documentation du 12 septembre 2022

    La dix-huitième réunion de l’équipe de la documentation de WordPress en français s’est tenue le lundi 12 septembre 2022 à midi heure française, en visioconférence.

    Ordre du jour

    Personnes présentes

    Point avancement

    Depuis la dernière réunion du 11 juillet 2022 :

    • +9 articles traduits (212 sur 266, soit 79.6%).
    • +8 articles importés.
    • 1 article en attente de relecture.
    • Pas d’article rédigé directement en français.

    Le pourcentage global d’avancement est de 77.7% (sans tenir compte du Codex).

    Pour les pages du Codex, l’avancement global est pour l’instant de 48.6% :

    • +1 page du Codex transférée (et mise à jour) sur HelpHub.

    Réorganisation du menu Éditeur de blocs

    Le menu Éditeur de blocs dans la page d’accueil de la documentation contient tous les articles concernant les blocs proposés dans l’éditeur de WordPress, aussi la liste est déjà assez longue et s’agrandira à chaque fois qu’un bloc sera documenté ou qu’un nouveau bloc sera ajouté dans l’éditeur.
    Aussi il est proposé de regrouper les blocs en suivant la présentation de l’éditeur : blocs Texte, Média, Design, etc. en créant des indentations dans le menu.

    🚩 L’idée est validée et JB s’occupe de faire une demande pour que les sous-menus puissent être utilisés dans la page d’accueil de la documentation, et communiquera le lien pour le suivi.

    Traduction des contenus de Learn WP

    Un nouveau projet voit le jour et concerne la traduction des contenus de Learn WordPress. L’équipe Training a mis en place un flux de travail pour chaque type de contenu de Learn WP et demande nos retours sur ces flux (Looking for feedback: Handbook page about content localization).

    Jenny a commencé la traduction de cette page Content Localization qui sera intégrée au Guide de traduction de WordPress, dans un nouveau chapitre « Traduction de Learn WordPress en français » vous pouvez la prévisualisez ici. Cette page sera éventuellement réactualisée selon les modifications apportées aux flux de travail.

    🚩 Nous allons prochainement lancer un appel à contributeurs pour tester dans un premier temps ces flux de travail afin d’aider l’équipe Training à les valider et/ou les améliorer. Si vous êtes intéressé·e·s par ces tests et ce projet, manifestez-vous dans le canal #documention-fr du slack WordPressFR.

    Mise à jour de la documentation pour la sortie de WordPress 6.1

    Ce sujet est ajouté à l’ordre du jour par JB.

    Il nous transmet un lien vers une ressource qui liste les modifications à apporter aux différentes documentations de WordPress. Ceci va nous aider grandement à lister les articles pour lesquels il faudra faire des modifications, les fonctionnalités concernées sont celles qui sont étiquetées « End user docs » dans la colonne « Docs Type ».

    🚩 Il faut se coordonner pour effectuer ces modifications, en établir la liste et utiliser l’extension permettant de planifier les modifications (documentation en cours de rédaction), aussi merci de suivre a minima ce process et de communiquer avant d’effectuer des modifications sur le canal #documentation-fr.


    La réunion se termine à 13H03.

    La prochaine réunion aura lieu le 10 octobre 2022 à midi.

    #compte-rendu

    Ordre du jour de la 18ème réunion de l’équipe Documentation du 12 septembre 2022

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

    À l’ordre du jour :

    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

    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

    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