#113.src - Documentation: C'est une bonne position ça, Scribe ? avec Sarah Haïm-Lubczanski

"Pas de doc, pas de feature"

La D.E.V. de la semaine est Sarah Haïm-Lubczanski, Documentation Architect. Sarah vient nous parler de son métier, bien sûr, et aussi de la doc. Cet élément étrange que nous réclamons tous, de différentes façons, mais que personne ne veut faire. Sarah nous donne son avis sur ce qu’est une bonne documentation (et cela inclut les commentaires dans votre code), qui devrait écrire la doc (je ne spoil pas, mais vous devriez écouter l’épisode), quand faire la doc, et aussi comment faire la doc !

Liens évoqués pendant l'émission

Ranger votre doc : Framework de documentation Diataxis.fr

La doc de la doc, et la communauté de Documentarians : Write The Docs

Un exemple : La doc d'API de Stripe

Gitlab a publié son onboarding

Larry Ullman présente la doc de Stripe (2018)

Why Specs Matters ("dev morons vs dev assholes")

Collectionnez vos épisodes préférés !

Cet épisode vous a plu ? Vous avez envie de soutenir ce podcast et d'avoir un élément collector de cet épisode ?
Vous pouvez acheter le NFT de cet épisode sur Opensea ! Faire une offre sur le token #113

🎙️ Soutenez le podcast If This Then Dev ! 🎙️ Chaque contribution aide à maintenir et améliorer nos épisodes. Cliquez ici pour nous soutenir sur Tipeee 🙏

Retrouvez toutes les expertises de tous les experts et expertes passées dans IFTTD directement dans votre IDE avec le MCP IFTTD !

Archives | Site | Boutique | TikTok | Discord | LinkedIn | Instagram | Youtube | Twitch |

Hébergé par Audiomeans. Visitez audiomeans.fr/politique-de-confidentialite pour plus d'informations.