Si la matinée est un peu morne et que vous voulez un peu enflammer le chat, rien de tel que de lancer un débat sur la documentation. A quoi ça sert, à qui elle sert, faut-il ou non documenter (son code surtout), et si oui comment le faire intelligemment, etc, etc. Et le moins qu'on puisse dire, c'est que si les avis sont souvent tranchés, ils sont également très souvent contradictoires... Comme pour tout autre sujet, il y a bien évidemment la théorie et la pratique.
Pour avoir un avis éclairé sur la question, j'ai la chance de recevoir dans cet épisode Rémy Léone. Rémy est cloud developer advocate chez Scaleway, et il est également le premier mainteneur de la documentation francophone de Kubernetes. Aujourd'hui, il vient nous expliquer avec passion les enjeux qui se cachent derrière une bonne documentation.
Sujets évoqués pendant l’épisode
- La documentation francophone de Kubernetes : https://kubernetes.io/fr/docs/home/
- Le guide pour les personnes souhaitant contribuer : https://kubernetes.io/fr/docs/contribute/start/
- Retrouvez également les personnes contribuants à la documentation sur le Slack de Kubernetes, https://slack.k8s.io/, channel #kubernetes-docs-fr
Electro Monkeys Podcast
Support the show (https://www.patreon.com/electromonkeys)