Ce qui est complètement crétin, évidemment, c'est de ne pas documenter son code.
Ce n'est pas évident a priori de dire telle pratique est définitivement bonne ou mauvaise. Par exemple lorsque le commentaire et le code seront en contradiction (c'est à dire une fois sur deux qu'on en examinera le détail), lequel doit faire autorité ?
Parmi ce qui fait des ravages dans ce domaine, c'est le manque d'humilité et le manque de discipline collective (comme ça a été dit, il faut coder en espérant être relu avec plaisir, par un autre ou par un autre soi dans deux ans).
[^] # Re: Complètement crétin !
Posté par Pol' uX (site web personnel) . En réponse au journal Comment briller auprès de la gent féminine dans « le monde de la tech ». Évalué à 8.
Ce n'est pas évident a priori de dire telle pratique est définitivement bonne ou mauvaise. Par exemple lorsque le commentaire et le code seront en contradiction (c'est à dire une fois sur deux qu'on en examinera le détail), lequel doit faire autorité ?
Parmi ce qui fait des ravages dans ce domaine, c'est le manque d'humilité et le manque de discipline collective (comme ça a été dit, il faut coder en espérant être relu avec plaisir, par un autre ou par un autre soi dans deux ans).
Adhérer à l'April, ça vous tente ?