Pourquoi la documentation compte ? - Sarah Haïm-Lubczanski - PHP Tour Lyon 2014 #phptour

D'aucuns trouvent que la doc, c'est la partie fastidieuse du projet. Ecrire du texte pour expliquer aux utilisateurs ce qu'on a fait, c'est la corvée pour les développeurs. Les utilisateurs sont pourtant ceux qui donnent la vie à votre logiciel, et ceux qui font votre réputation. Ils ont besoin de savoir comment se servir de votre logiciel. Personne ne veut travailler la documentation, alors que c'est la première chose qui est lue lorsqu'on installe un nouveau projet : du README à la FAQ et aux points de Référence, une bonne documentation est commme une publicité pour votre projet. La documentation donne un aperçu de la qualité de votre projet, elle est une valeur ajoutée. Nous parlerons donc de l'intérêt de la doc, de la génération de documentation, de gérer de la documentation existante, et de comment les développeurs peuvent écrire de la doc sans douleur. https://joind.in/talk/view/11224 Slides : http://fr.slideshare.net/sarahhaim/pourquoi-ladoccomptephptour2014

Pourquoi la documentation compte ? - Sarah Haïm-Lubczanski - PHP Tour Lyon 2014 #phptour

Related Talks

keynote d'ouverture - Maxime Teneur & Mikael Randy - PHP Tour 2014 #phptour

Stop Multiplying by 4: Practical software estimation - PHP Tour Lyon 2014 #phptour

LT : Le nouveau dans l'équipe, boulet ou messie ? - Clement Herreman - PHPTour Lyon 2014 #phptour

Keynote de cloture - Maxime Teneur et Mikael Randy - PHP Tour Lyon 2014 #phptour