Nan mais y'a quand même une sacré grosse différence entre trop commenter, perdre trop de temps à faire des docs inutiles et ne rien foutre du tout.
Lorsque le projet est livré et passe en maintenance (éventuellement évolutive), on peut s'attaquer à produire de la documentation
Et ben, je plain le boulot de ces gens, commenter le code d'un autre 6 mois après avoir été écrit…
Et surtout ça ne change rien au fait que l'intention du programmeur ne sera pas inscrite.
Je comprends que ce soit difficile à accepter, car on enseigne aux étudiants à bien commenter leurs codes
Les commentaires et la documentation sont une charge de travail non négligeable et il est préférable de se concentrer d'abord sur un code qui marche et faire de la transmission de connaissances de programmeur à programmeur.
La difficulté de compréhension n'a rien à voir avec l'enseignement mais justement du fait d'experience pro. Il arrive (et arrivera) toujours un cas où tu devra reprendre le code d'un autre (absence, problème critique, tout ce que tu veux) et là tu va bien souffrir sans la moindre doc.
C'est vraiment présomptueux de croire que le code n'a pas besoin d'être commenté pour être lisible et souvent on va trouver des arguments (genre ça prend trop de temps) qui sont souvent motivés par "ça m'emmerde de commenter".
Et même si tout ceci était valide, là tu propose quand même aux autres d'utiliser et modifier ton code. On parle pas du voisin dans un open space hein. Et dans ce cas, pour moi c'est simple, s'il n'y a aucune doc aucun commentaire faudrait vraiment, vraiment, vraiment qu'il y ait quelque chose d'intéressant pour que je me fasse chier à comprendre le code que le dev n'a pas jugé utile de commenter.
Newton Adventure suit le même chemin.
Ben c'est quand même un chemin qui aide à restreindre les possibilités de contributions.
[^] # Re: question
Posté par CrEv (site web personnel) . En réponse au journal Créer son propre jeu de plateforme en forkant Newton Adventure. Évalué à 4.
Nan mais y'a quand même une sacré grosse différence entre trop commenter, perdre trop de temps à faire des docs inutiles et ne rien foutre du tout.
Et ben, je plain le boulot de ces gens, commenter le code d'un autre 6 mois après avoir été écrit…
Et surtout ça ne change rien au fait que l'intention du programmeur ne sera pas inscrite.
La difficulté de compréhension n'a rien à voir avec l'enseignement mais justement du fait d'experience pro. Il arrive (et arrivera) toujours un cas où tu devra reprendre le code d'un autre (absence, problème critique, tout ce que tu veux) et là tu va bien souffrir sans la moindre doc.
C'est vraiment présomptueux de croire que le code n'a pas besoin d'être commenté pour être lisible et souvent on va trouver des arguments (genre ça prend trop de temps) qui sont souvent motivés par "ça m'emmerde de commenter".
Et même si tout ceci était valide, là tu propose quand même aux autres d'utiliser et modifier ton code. On parle pas du voisin dans un open space hein. Et dans ce cas, pour moi c'est simple, s'il n'y a aucune doc aucun commentaire faudrait vraiment, vraiment, vraiment qu'il y ait quelque chose d'intéressant pour que je me fasse chier à comprendre le code que le dev n'a pas jugé utile de commenter.
Ben c'est quand même un chemin qui aide à restreindre les possibilités de contributions.