Développeur : 4 points pour créer un excellent logiciel
Essayez d'atteindre ces objectifs d'apprentissage de toute une vie, simples mais difficiles à atteindre. Chacun paraît simple sur le papier. Chacun demande une carrière pour être bien fait.
Voici les quatre auxquels je reviens toujours.
Que veut dire « un logiciel qui marche » en pratique ?
Le premier objectif est de produire un logiciel qui marche. Ma liste est longue exprès : maintenable, scalable, lisible, simple, testable, facile à intégrer, bien documenté, et pleinement au service du métier et des objectifs de l'organisation.
« Qui marche » vient en premier, et ça compte. Un logiciel qui tourne sur votre laptop n'est pas encore un logiciel qui marche. Un logiciel marche quand il marche encore après le prochain changement, quand un collègue peut le lire, et quand il résout le problème métier pour lequel il a été construit.
Chaque adjectif de la liste a un mécanisme derrière lui. Un code lisible coûte moins cher à changer, parce que la personne suivante peut le comprendre sans vous poser de question. Un code testable coûte moins cher à vérifier, parce que les tests peuvent atteindre chaque comportement sans un environnement complet. Un code facile à intégrer a des frontières claires, donc les autres parties du système peuvent l'utiliser sans lire ses entrailles.
Écrivez du code pour les humains, pas pour les machines. Une machine accepte presque tout ce qui compile. Le prochain lecteur est une personne, et très souvent cette personne, c'est vous, six mois plus tard. Clean Code, de Robert C. Martin, défend la lisibilité par le nommage et par de petites fonctions ciblées.
Simple a besoin d'une définition, parce que le mot est employé à la légère. Rich Hickey sépare le simple du facile. Simple veut dire non entrelacé. Facile veut dire à portée de main. Un système peut être facile à démarrer et très dur à changer.
Faire simple, c'est difficile, et ça demande de l'expertise. Ne confondez pas simple et simpliste ! Un logiciel bâti sur des principes simplistes est très complexe à maintenir.
Comment continuer à progresser sans s'épuiser ?
Le deuxième objectif est de développer assez de compétences pour sortir des versions plus efficaces chaque mois, chaque semaine, chaque jour. Cela passe par un meilleur design, une meilleure architecture et un apprentissage constant.
Le mécanisme ici, c'est le feedback. Une équipe qui livre une fois par trimestre apprend une fois par trimestre. Une équipe qui livre tous les jours apprend tous les jours. La recherche présentée dans Accelerate, de Nicole Forsgren, Jez Humble et Gene Kim, relie la fréquence à laquelle une équipe livre des changements à la performance de cette équipe. Les métriques DORA issues de ce travail mesurent la même boucle : à quelle fréquence vous déployez, combien de temps met un changement pour arriver en production, et à quelle fréquence un changement casse quelque chose.
Échouez vite, apprenez plus vite. Apprendre, mesurer, désapprendre. Ce ne sont pas des slogans quand la boucle est courte. Cela devient une habitude quotidienne, parce que chaque release vous dit quelque chose de vrai sur le code et sur l'équipe.
Un meilleur design vient aussi de la pratique sur de vrais problèmes. Lire des livres aide, et vous devez continuer à lire sur l'architecture. Mais le sens du design grandit quand vous l'appliquez, que vous voyez le résultat en production, puis que vous changez d'avis. Tenez une courte liste des décisions que vous prendriez autrement aujourd'hui. Relisez-la chaque trimestre.
À quoi ressemble une culture forte ?
Le troisième objectif est de soutenir votre organisation en construisant une culture forte autour des bonnes pratiques. Je décris cette culture en quatre mots : empathie, mentorat, partage et bienveillance.
La culture n'est pas un poster sur un mur. Elle se voit dans ce que les gens font quand quelque chose casse, et dans qui prend la parole quand un design semble mauvais.
Le mentorat, ça compte ! L'architecture est trop importante pour être laissée à quelques personnes seulement. Créez plus d'architectes dans l'équipe. Tirer les compétences vers le haut, c'est ce qui permet à une équipe de continuer quand quelqu'un est en vacances, et c'est ainsi que la génération suivante apprend les raisons derrière les règles.
Le partage a besoin de sécurité. Les travaux d'Amy Edmondson sur la sécurité psychologique, présentés dans The Fearless Organization, montrent que les gens posent des questions et reconnaissent leurs erreurs seulement s'ils pensent que l'équipe ne les punira pas pour cela. Le Project Aristotle de Google est arrivé à un constat proche sur ses propres équipes : la sécurité psychologique était le facteur le plus important de l'efficacité d'une équipe.
L'empathie est la part de la culture qui rend le challenge possible. Vous pouvez challenger une idée avec empathie, et vous devez le faire. Attaquez le design, pas la personne qui l'a proposé. L'idée s'améliore, et la personne continue à proposer des idées.
Pourquoi partir du problème ?
Le quatrième objectif est de travailler avec l'équipe produit pour découvrir les problèmes. N'implémentez pas de solution sans avoir le problème à résoudre. Challengez chaque ligne des exigences, et restez simple. Le minimalisme et les petites itérations sont la clé d'un rythme de confiance.
L'ingénierie consiste d'abord à résoudre des problèmes. L'implémentation vient ensuite. Les exigences arrivent souvent déguisées en solutions. « Ajouter un bouton » est une solution. Le problème derrière, c'est peut-être que les clients annulent trop tard, ou qu'ils ne trouvent pas du tout l'action d'annulation. Le bouton est une réponse parmi plusieurs, et vous ne pouvez pas bien choisir tant que vous ne connaissez pas la question.
Les petites itérations rendent ce travail praticable. Alistair Cockburn décrit le walking skeleton comme la plus petite version de bout en bout d'un système, celle qui relie les grandes parties et fait une seule petite chose. Une fois que le squelette marche, chaque nouvelle étape ajoute un peu de chair, et chaque étape peut être vérifiée avec de vrais utilisateurs. Itératif ne veut pas dire incrémental. Il vous faut les deux : un chemin complet, puis un chemin plus épais.
Rester simple, c'est aussi couper le travail que personne n'a demandé. Chaque feature inutilisée est du code qu'il faut lire, tester et changer. Supprimez-la.
Où les quatre objectifs tirent-ils en sens contraire ?
Les objectifs ne sont pas toujours d'accord. La vitesse et la maintenabilité peuvent tirer dans des directions opposées. Une release quotidienne qui saute les tests produit de la dette quotidienne. La dette technique n'existe pas. Le choix d'accepter la médiocrité existe, et c'est un choix que vous pouvez faire exprès ou par défaut.
Le minimalisme a aussi ses limites. Dans un domaine réglementé, une règle qui doit être implémentée n'est pas une feature en trop, même si elle en a l'air. Partez de la loi, du contrat ou du risque, et simplifiez autour.
La culture prend du temps dans une petite équipe aussi. Deux ingénieurs peuvent partager leurs connaissances en une seule conversation, et cela reste du partage. L'objectif n'a pas besoin d'un programme. Il a besoin d'une habitude.
Les quatre objectifs se renforcent aussi les uns les autres. Un logiciel qui marche vous donne un feedback rapide. Un feedback rapide rend l'apprentissage bon marché. L'apprentissage se diffuse par le partage. Le partage marche mieux quand le problème est clair. Retirez-en un seul, et les autres s'affaiblissent.
Comment vous situer par rapport aux quatre objectifs ?
Utilisez cette courte liste avant de fermer un ticket.
- Nommez l'objectif métier que votre changement sert.
- Écrivez le code pour qu'un nouveau collègue puisse le lire sans vous.
- Testez d'abord le comportement, puis vérifiez le design.
- Livrez une version cette semaine, et une autre la semaine prochaine.
- Observez le changement en production, pas seulement pendant le passage des tests.
- Expliquez ce que vous avez appris à un collègue.
- Demandez au product owner quel problème l'exigence résout.
- Supprimez le code que personne n'utilise.
Si vous ne savez pas répondre à la première question, arrêtez de coder. Le reste de la liste en dépend.
💡 Il ne s'agit pas seulement de faire le travail. Il s'agit de bien le faire !
Ressources et bibliographie
- Robert C. Martin, Clean Code: A Handbook of Agile Software Craftsmanship (Prentice Hall, 2008). https://www.oreilly.com/library/view/clean-code-a/9780136083238/
- Rich Hickey, Simple Made Easy (Strange Loop, 2011). https://www.infoq.com/presentations/Simple-Made-Easy/
- Nicole Forsgren, Jez Humble, Gene Kim, Accelerate: The Science of Lean Software and DevOps (IT Revolution, 2018). https://itrevolution.com/product/accelerate/
- Amy C. Edmondson, The Fearless Organization: Creating Psychological Safety in the Workplace (Wiley, 2018). https://www.wiley.com/en-us/The+Fearless+Organization:+Creating+Psychological+Safety+in+the+Workplace+for+Learning,+Innovation,+and+Growth-p-9781119477266
- Google re:Work, Guide: Understand team effectiveness (Project Aristotle) (rework.withgoogle.com). https://rework.withgoogle.com/intl/en/guides/understand-team-effectiveness
- Alistair Cockburn, Crystal Clear: A Human-Powered Methodology for Small Teams (Addison-Wesley, 2004). https://www.oreilly.com/library/view/crystal-clear-a/0201699478/
Publié d'abord sur LinkedIn : le post d'origine
