Contribution au projet python

[josselinauguste]

Contribuer au projet python ce n'est pas qu'écrire du code compliqué, c'est aussi des tâches plus accessibles, comme participer à l'écriture de la documentation

cc @Krilivye

[vpoulailleau]

Comme mentionné ici python/python-docs-fr#986 (Traduire de la documentation à l'école), je compte animer ce genre d'atelier dans des écoles d'informatique à Bordeaux. Je suis passé voir l'équipe de traduction à la PyConFr 2019 pour me remettre au gout du jour sur leurs pratiques et ai même fait un outil pour les aider : https://github.com/vpoulailleau/padpo (par exemple en pratique sur une PR de @Krilivye https://github.com/python/python-docs-fr/pull/920#pullrequestreview-318677388, ou sur une autre PR https://github.com/python/python-docs-fr/pull/1020)

Tout ça pour dire que je peux partager mes retours d'expérience (quand les ateliers auront eu lieu, c'est à dire quelque part dans cette année scolaire, les modalités sont en cours de discussions).

Éventuellement, je peux animer, ou assister un animateur sur le sujet.

[vpoulailleau]

J'ai mis le support de présentation que je compte utiliser dans une école bordelaise pendant un atelier de traduction ici : https://github.com/vpoulailleau/support-traduction-doc-python

Vous pouvez faire vos remarques, si vous le souhaitez, en créant un ticket dans le repo mentionné.

Vous pouvez aussi réutiliser ce document pendant des ateliers.

[garaud]

@vpoulailleau merci beaucoup pour tes messages. Je trouve ça très intéressant. Ton retour d'expérience en tant qu'animateur de ces ateliers sera la bienvenue !!

[garaud]

Bonne idée le linter de .po pour gettext. Et bravo pour le nom :slightly_smiling_face:

[vpoulailleau]

Voici mon retour d'expérience, tel que je m'apprêtais à mettre sur mon blog (mais qui était en cours de maintenance…)

Bilan de l'atelier contribution au logiciel libre

Quoi ?

• Atelier première contribution au logiciel libre (2 ateliers indépendants de 4 heures chacun)
  • Découverte des logiciels libres
  • Pas besoin d'être un expert pour contribuer
  • Participation à la traduction en français de la documentation officielle de Python https://github.com/python/python-docs-fr et https://docs.python.org/fr/
  • Contribution sur GitHub avec git
  • Utilisation de la ligne de commande
  • Utilisation des scripts et outils fournis pour la traduction, dont l'outil que j'ai créé : https://github.com/vpoulailleau/padpo
  • Ouvert sur participation libre à des étudiants post-bac d'une école bordelaise (débutants acceptés avec plaisir)
  • Étudiants en informatique générale
  • Étudiants en informatique embarquée
  • Met en pratique des compétences scolaires : git, anglais, français, scripts, documentation technique…
  • Support de la présentation faite pendant l'atelier : https://github.com/vpoulailleau/support-traduction-doc-python, support entre autres relu par un core developer Python

Bilan

Réaction de l'école à la proposition du projet

• « […] excellente idée que cet atelier. Je (nous) sommes preneur ! Et oui pour que tu l’animes : un sachant qui les accompagne dans leur initiation au monde du libre et du travail collaboratif me semble indispensable »

Par l'équipe officielle de traducteurs

• PR = Pull Request, proposition de contribution
• « c'est une super idée et je suis impatient de relire leur PR !!!! »
• « Et encore bravo pour l'atelier, ça m'a fait plaisir de voir autant de PRs proposées d'un coup. »
• « J'espère que ton atelier se passe bien ! C'est super de recevoir des PRs de leur part, on est tous ravis ! »
• « Merci à padpo et à son auteur ! »

Par les étudiants

• « Je suis plutôt mauvais en anglais est-ce un problème ou le niveau d’anglais n’est pas un problème. » Ce à quoi j'ai répondu « Il faut arriver à comprendre le sens de la phrase écrite en anglais avant de la traduire. C'est donc clairement plus facile quand tu es à l'aise en anglais. […] Et il ne faut pas perdre de vue que toutes les traductions sont relues par des humains ».
  • Réponse de l'équipe officielle de traduction à la réception de sa première contribution : « Première PR parfaite ! Merci pour cette contribution ! »
• « Je me permet de vous contacter au sujet de l’atelier Python du vendredi 13 Décembre au matin pour savoir si vous acceptez des étudiants de première année » : « cet atelier est vraiment là pour faire ses premiers pas dans le monde du logiciel libre. Donc soit le bienvenu ! »
• « On est plusieurs à être intéressés malheureusement ca tombe pendant nos cours donc je ne sais pas si on peut-être excusés si on vient ? » Ce n'est pas simple de concilier avec les emplois du temps de chacun… Mais plusieurs étudiants m'ont fait part de l'envie de participer, mais de l'impossibilité de participer
• « Quand est le prochain atelier ? »
• « Je vous envoie ce mail pour savoir si vous alliez refaire un cours comme celui d'hier? »

Par moi

• Je suis satisfait d'avoir fait découvrir le monde du logiciel libre de l'intérieur à des étudiants, j'aurais moi-même aimé avoir ce genre d'atelier durant mes études !
• J'étais malade le jour de l'atelier, ça a été un peu dûr, mais je ne pense pas que cela a posé des difficultés aux étudiants, juste de la fatigue pour moi…
• Il est difficile d'installer les outils dans certains environnement, j'ai un peu galéré avec le premier groupe, où certains n'ont pas pu contribuer malheureusement. Par contre avec le second groupe, cela a été plus facile car j'avais appris des erreurs faites par les étudiants du premier groupe (faute de frappe dans les commandes, versions d'outils…) et j'ai amélioré la documentation au fur et à mesure
• J'ai envie de faire d'autres ateliers du même type, car c'est intimidant de contribuer pour la première fois à un logiciel libre, et c'est tellement plus simple quand on est accompagné !

Par les chiffres

Une semaine après l'atelier, le jour des vacances de Noël :

• En cours, 9 pull requests (1070, 1075, 1077, 1080, 1081, 1090, 1091, 1095, 1099)
• Presque fini, 3 pull requests (1078, 1092, 1094)
• Accepté et intégré dans la documentation officielle française de Python, 3 pull requests (1079, 1096, 1097)