• # Ne pas oublier la doc !

    Posté par . En réponse au journal L'angoisse du programmeur. Évalué à 4.

    Le code, c’est bien, la doc qui va avec c’est mieux !

    Avoir un code bien documenté permettra plus facilement aux autres contributeurs potentiels de participer. C’est un point qui est assez souvent négligé, donc faut y faire gaffe.

    Je ne programme pas mais je suis après dans la chaîne, en qualification / packaging. Et régulièrement, je dois me plonger dans le code pour réussir à comprendre quelles sont les dépendances et les besoins de l’appli à cause du manque de documentation qui devrait venir avec ! Et ça, c’est… Un peu « fatiguant » :)

    Et régulièrement je maudis les devs avec lesquels je travaille car ils ont omit cette satanée documentation !

    Donc, n’oublie pas la doc !

    cd /pub && more beer