|
"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
Participez au prochain enregistrement !
Une partie des épisodes sont enregistrés en live sur Twitch !
Soit le mardi à 15:14, soit le mercredi à 14:15
Abonnez-vous à la chaîne Twitch ou retrouvez les épisodes en replay sur YouTube @ifthisthendev
Continuons la discussion
@ifthisthendev (https://twitter.com/ifthisthendev)
@bibear (https://twitter.com/bibear)
@mereteresa (https://twitter.com/mereteresa)
Discord (https://discord.gg/FpEFYZM)
LinkedIn (https://www.linkedin.com/company/if-this-then-dev/)
Retrouvez tous nos épisodes sur notre site https://ifttd.io/listes-des-episodes/ |