Dans cet épisode de Software Delivery Stories, nous recevons Mehdi Houacine pour parler documentation et de ses enjeux dans le delivery logiciel. On aborde les sujets suivants :
* Quelles sont les différentes formes que peu prendre la documentation : écrit, auto-générée, orale... ?
* Comment rendre la documentation utile et maintenable au fil du temps ?
* Quels outils et pratiques favorisent un vrai transfert de connaissances ? (Makefile auto-documenté, OpenAPI/Swagger, SchemaSpy, rituels...)
Références évoquées dans l'épisode :
* Le livre "Living Documentation" de Cyril Martraire : https://www.goodreads.com/book/show/34927405-living-documentation
* Le livre "The Software Guidebook" de Simon Brown : https://leanpub.com/documenting-software-architecture
* L' article de blog de Mehdi sur la Living Documentation : https://blog.octo.com/living-documentation-parce-que-la-doc-ca-peut-etre-fun-! et le repo compagnon : https://github.com/Mehdi-H/living-documentation-cookbook
* Le talk "Literate Programming in the Large" de Timothy Daly : https://www.youtube.com/watch?v=Av0PQDVTP4A
Où retrouver l'invité :
* Sur LinkedIn : https://www.linkedin.com/in/mehdihouacine/
* Dans sa newsletter Substack "the tech away" : https://thetechaway.substack.com/
---
À chaque numéro, nous invitons un expert qui nous parle de son expérience personnelle sur un sujet de delivery logiciel.
Notre fil rouge vient de l’étude “Accelerate, Building and Scaling High Performing Technology Organizations”. Celle-ci a permis de mettre en évidence des métriques d’évaluation de la performance d’un système de delivery logiciel ainsi qu’une série de capabilities (24 lors de la sortie de la première édition) que l’on pourrait traduire par des “capacités” dont pourrait se doter une entreprise pour améliorer ses performances.
Nous nous servons de cette série de capabilities comme prétexte pour étudier les systèmes de delivery sous tous les angles, à partir de vécus d’experts.
Pour plus de détails sur notre démarche et nos motivations, retrouvez-nous dans l’épisode #00 d’introduction de ce podcast.