Documenter son code n'impressionne pas grand monde et son absence rend la maintenance affreuse autant pour un sexe que pour l'autre.
Par contre il y a tout un tas de raisons qui nous poussent à ne parfois pas documenter et je suis certain que tous les développeurs ici y ont déjà été confrontés au moins une fois :
- Une mise en production du vendredi soir qui se passe mal, un patch sorti à l'arrache pour corriger et on se tire en WE à 22H, on en a plein le cul. Ce patch finira irrémédiablement dans le legacy parce que "ça marche" mais sa documentation elle...
- On ne sait pas vraiment ce qu'on fait, on agit par mimétisme sur une techno qu'on ne maîtrise pas, ça fonctionne au petit bonheur la chance, on n'est pas trop capable de savoir pourquoi mais bon, ça marche hein...
- On maîtrise bien sa techno/son fwk et on estime que ce bout de code est assez simple et ne mérite pas de documentation. Bref on oublie que y a des individus qui vont relire le code et surtout qu'ils n'ont pas nécessairement le même niveau de maîtrise que nous.
Et convaincre un manager et une entreprise de faire de la doc', c'est pas toujours gagné d'avance. C'est le produit qui fait rentrer de l'argent, pas la doc' pour eux. Mais ne pas oublier qu'un code bien documenté, c'est des temps de développement réduits (donc de l'argent gagné pour l'entreprise).
Pour impressionner les femmes de l'IT, il est sans doute préférable de ne pas toujours les ramener uniquement à leur sexe et de traiter leur production à égalité de leurs homologues masculins.
Bref, faites de la doc', c'est bien. Mais n'espérez pas emballer votre collègue de travail avec, je doute que ce soit un fétichisme très répandu (mais vos témoignages sur le sujet sont bienvenus).
La majeure partie des morts l'était déjà de son vivant et le jour venu, ils n'ont pas senti la différence.
# Pourquoi "auprès de la gent féminine" ?
Posté par Nibel . En réponse au journal Comment briller auprès de la gent féminine dans « le monde de la tech ». Évalué à 10.
Documenter son code n'impressionne pas grand monde et son absence rend la maintenance affreuse autant pour un sexe que pour l'autre.
Par contre il y a tout un tas de raisons qui nous poussent à ne parfois pas documenter et je suis certain que tous les développeurs ici y ont déjà été confrontés au moins une fois :
- Une mise en production du vendredi soir qui se passe mal, un patch sorti à l'arrache pour corriger et on se tire en WE à 22H, on en a plein le cul. Ce patch finira irrémédiablement dans le legacy parce que "ça marche" mais sa documentation elle...
- On ne sait pas vraiment ce qu'on fait, on agit par mimétisme sur une techno qu'on ne maîtrise pas, ça fonctionne au petit bonheur la chance, on n'est pas trop capable de savoir pourquoi mais bon, ça marche hein...
- On maîtrise bien sa techno/son fwk et on estime que ce bout de code est assez simple et ne mérite pas de documentation. Bref on oublie que y a des individus qui vont relire le code et surtout qu'ils n'ont pas nécessairement le même niveau de maîtrise que nous.
Et convaincre un manager et une entreprise de faire de la doc', c'est pas toujours gagné d'avance. C'est le produit qui fait rentrer de l'argent, pas la doc' pour eux. Mais ne pas oublier qu'un code bien documenté, c'est des temps de développement réduits (donc de l'argent gagné pour l'entreprise).
Pour impressionner les femmes de l'IT, il est sans doute préférable de ne pas toujours les ramener uniquement à leur sexe et de traiter leur production à égalité de leurs homologues masculins.
Bref, faites de la doc', c'est bien. Mais n'espérez pas emballer votre collègue de travail avec, je doute que ce soit un fétichisme très répandu (mais vos témoignages sur le sujet sont bienvenus).
La majeure partie des morts l'était déjà de son vivant et le jour venu, ils n'ont pas senti la différence.