Auto-critique de la revue de code (bienveillante)

A presentation at Paris Web in October 2019 in Paris, France by Kim Laï Trinh

Slide 1

Slide 1

AUTO-CRITIQUE DE LA REVUE DE CODE (BIENVEILLANTE)

Kim Laï TRINH

Slide 2

Slide 2

PRÉ-REQUIS

  • Pull Request
  • Revue de code

Slide 3

Slide 3

À LA RUCHE

  • entre 5 et 15 développeur·se·s
  • deux pouces = mise en prod

Slide 4

Slide 4

OBJECTIFS DE LA REVUE DE CODE

  • corriger les bugs avant de mettre en prod
  • maîtriser l’architecture logicielle
  • diffuser les connaissances
  • partager la responsabilité

Slide 5

Slide 5

COMMENT FAIRE UNE BONNE REVUE DE CODE ?

Slide 6

Slide 6

1. ÊTRE BIENVEILLANT

  • se concentrer sur le code
  • éviter l’impératif
  • poser des questions
  • justifier techniquement ses commentaires
  • proposer des solutions rester respectueux
  • dire merci

Slide 7

Slide 7

2. METTRE DE CÔTÉ SON EGO

Vous n’êtes pas votre code. Rappelez-vous que le but de la revue de code est de trouver des problèmes, et des problèmes seront trouvés. Ne le prenez pas personnellement lorsqu’ils sont découverts. The psychology of computer programming (Gerald M. Weinberg - 1971)

Slide 8

Slide 8

À LA RUCHE

  • bonne ambiance dans l’équipe
  • respect mutuel et bienveillance

Slide 9

Slide 9

POURTANT

  • PRs qui s’empilent
  • problèmes d’architecture
  • code parfois difficile à s’approprier

Slide 10

Slide 10

PRÉ-REQUIS

Il existe des discriminations structurelles qui proviennent de rapports de domination entre certains groupes

Slide 11

Slide 11

QUEL RAPPORT ?

Slide 12

Slide 12

LA REVUE DE CODE EST UNE INTERACTION SOCIALE

Slide 13

Slide 13

DANS UNE ÉQUIPE TECHNIQUE

  • le nombre d’années d’expérience
  • études d’informatique / autodidacte - reconversion
  • backend / frontend
  • vim, emacs / PHPStorm

Slide 14

Slide 14

Vous n’êtes pas votre code. Rappelezvous que le but de la revue de code est de trouver des problèmes, et des problèmes seront trouvés. Ne le prenez pas personnellement lorsqu’ils sont découverts.

Slide 15

Slide 15

La seule véritable autorité acceptable découle de la connaissance et non du pouvoir. La connaissance engendre l’autorité, et l’autorité suscite le respect. Si vous voulez du respect, cultivez le savoir.

Slide 16

Slide 16

LA REVUE DE CODE (EMPATHIQUE)

  • Exemple 1 : le freelance
  • Exemple 2 : le professionnel

Slide 17

Slide 17

NOUVEL OBJECTIF

S’assurer que toutes les personnes de l’équipe contribuent, tirent de la reconnaissance de leurs contributions et gagnent en autonomie

Slide 18

Slide 18

PAR EXEMPLE

Slide 19

Slide 19

merci :)