WordCamp Paris Contributor Day Atelier 1 : Présentation 20 novembre 2018

La contribution, c’est participer au développement d’un logiciel open-source et de son écosystème

Le parcours vers la contribution…

Parcours type… je modifie pour mon usage perso je rencontre la communauté je propose des modifications on m’explique comment faire ces modifications (mais je dois tout apprendre) je deviens contributeur et plus encore ? j’utilise un super logiciel mais il me convient pas à 100%

Le contributor day Je participe :) Je dois tout Apprendre :P ¯\_(ツ)_/¯ Le WordCamp Paris organise Un Contributor day \o/ L’idée qui nous est venue : des ateliers préparatoires !

Le contributor day du WordCamp Paris Je participe aux ateliers J’apprend le fonctionnement de la contribution Le jour du WordCamp je suis paré et peut même aider les nouveaux ! je deviens contributeur et plus encore ? Le WordCamp Paris organise Un Contributor day \o/

Mais pourquoi contribuerait-on ?

Entre individu et entreprise, des raisons équivalentes Individu Give back Veille technique Apprendre des choses Trouver des ami·e·s Apporter sa pierre Se valoriser Stratégie d’entreprise RSE & communication Anticiper le changement Monter en compétence Recruter Être acteur plutôt que suiveur Se valoriser

“ Organizations that want to grow the WordPress pie should dedicate 5% of their time to working on WordPress ecosystem. Le principe idéal des 5% de contrib’

“ 5%, sur 20 jours de travail, c’est une journée par mois* Mais ce coût doit être comparé avec la valeur ajoutée. Principe du contribution day Une journée de contribution commune tous ensemble, planifiée à l’avance. *ou deux heures par semaine

Où ça se passe pour contribuer à l’open-source ?

Ça dépend du projet… Github, Forums, Slack, tickets, IRC, évènements… → Partout dans le monde et dans tous les fuseaux horaires Pourquoi fait-on autant de remote dans notre secteur d’activité ? Car c’est dans l’ADN de l’open-source !

Mais qui peut contribuer ?

“ To contribute to WordPress core, you don’t need to be an excellent developer, nor a developer at all. You just have to feel involved. Se sentir impliqué

◉ Développeur·ses : → Patchs : PHP, JS, HTML, CSS… sur le core et partout ailleurs ◉ Designers : → Proposer du design sur les bundled themes, l’admin… ◉ Spécialistes : → Accessibilité, UI/UX, SEO, Perfs… : l’écosystème a besoin de vous ! → Sécurité : rendez-vous sur HackerOne ◉ Utilisateur·ices & Chefs de projets WordPress… et en fait tout le monde : → Issues / tickets → Participer aux décisions sur Slack Quels profils ?

Comment contribuer ?

There is a job for everyone! https://make.wordpress.org/ MAKE.WORDPRESS.ORG

◉ Des tables pour chaque domaine Make sélectionné ◉ Des référents pour chaque domaine ◉ Des figures de proue (là ou nous pouvons) ◉ Des pizzas et du café/thé ◉ Des contributions à l’écosystème ◉ Des contributeurs heureux et valorisés toute la journée Déroulement du Contributor Day

L’exemple du core

Les composants WordPress ◉ Bootstrap/load ◉ Build/test tools ◉ Bundled themes ◉ Cache API ◉ Comments ◉ Cron API ◉ Customize ◉ Database ◉ Date/time ◉ Editor ◉ Export ◉ External libraries ◉ Feeds ◉ Filesystem API ◉ Formatting ◉ General ◉ Help/about ◉ HTTP API ◉ I18n ◉ Import ◉ Mail ◉ Media ◉ Networks/sites ◉ Option/metaAPI ◉ Permalinks ◉ Plugins ◉ Posts/Post types ◉ Query ◉ Rest API ◉ Scripts loader ◉ Taxonomy ◉ Toolbar ◉ Theme > Menus ◉ Theme > Widget ◉ Upgrade/install ◉ Users > Login ◉ Users > Roles/Caps ◉ XML RPC Pour chaque composant, plusieurs maintainers sont désigné·es. Cela se fait sur la base du volontariat, de la compétence et de l’intérêt, et les leads changent au fil des années.

Le Trac WordPress ◉ Toute nouvelle fonctionnalité/correction doit ○ soit passer par un ticket ○ soit par un plugin as feature ◉ Old school mais pratique : historique, suivi, transparence

Contribuer avec Trac : quelques tips/liens ◉ Pour commencer : les good-first-bug réservés aux débutants → https://core.trac.wordpress.org/tickets/good-first-bugs ◉ Les tickets sans patch → https://core.trac.wordpress.org/tickets/no-patch ◉ Les tickets ayant besoin d’une expertise en accessibilité → https://core.trac.wordpress.org/focus/accessibility ◉ Les tickets qui vont atterrir dans la prochaine majeure → https://core.trac.wordpress.org/tickets/major/workflow ◉ Les tickets qui vont atterrir dans la prochaine mineure → https://core.trac.wordpress.org/tickets/minor/workflow

Comment proposer un patch ◉ Trouver un ticket ou en ouvrir un ◉ Disposer d’une instance de WP en local ◉ Cloner le dépôt GIT ou SVN du cœur WordPress et installer une instance en local à partir de ce répertoire ◉ Créer une branche, par exemple : 43623-hello-dolly-musical-note ◉ Faire les modifs ◉ La tester en local (responsive, RTL, PHP 5.2 à 7.2…) ◉ Soumettre le patch accompagné d’explications et de screenshots si nécessaire

Un ticket avec le focus accessibility : #40187

Correction en local, puis réalisation d’un fichier diff entre la branche master et la branche du correctif : $ git diff master > 40187.diff

Après une relance sur le Slack, quelques échanges et corrections, le props tant espéré \o/

On se retrouve dans les crédits de WP 5.0 ? WP 4.9