En tant qu’ingénieur logiciel depuis 20 ans, travaillant principalement sur des sujets liés à la sécurité (SF-PD), je dois dire que votre patron n’est peut-être pas la personne que vous voulez être votre exemple. Le manque de commentaires est le signe d’un programmeur amateur autodidacte qui n’a jamais appris à bien faire son travail ou d’un ingénieur inexpérimenté. Ou peut-être un ingénieur qui n'a tout simplement pas le temps - les délais et les délais peuvent faire des choses horribles pour votre code! ;) C'est cependant un anti-modèle pour chaque ingénieur logiciel compétent.
Votre patron est peut-être un très bon codeur, mais on dirait qu'il n'est pas un bon ingénieur en logiciel. Un ingénieur utilise l’expérience d’un groupe pour éviter les pièges qui ont déjà attiré d’autres personnes. Des commentaires efficaces font partie de cette expérience collective collective de logiciels, de la même manière que l'analyse de stress fait partie de l'expérience collective de groupe en génie mécanique. Ce qui compte comme commentaire efficace est plus fluide, et c’est certainement quelque chose que vous obtenez par expérience.
La chose la plus fondamentale est que les commentaires ne doivent pas dire ce que fait une ligne de code. Il arrive parfois que les commentaires expliquant ce que fait une fonction sont également superflus (en particulier en C #). Les commentaires excessifs peuvent être tout aussi inefficaces (et indiquer un manque d'expérience), car vous ne pouvez pas trouver les éléments importants dans les scories. En tant que novice, vous pouvez toujours essayer de déterminer le "quoi" du code, et pour cela, il vous suffit de lire et de comprendre ce qu'il a fait.
Cependant, l’important pour les commentaires est qu’ils disent POURQUOI une ligne de code ou une fonction fait ce qu’elle fait, là où cela n’est peut-être pas évident. Avez-vous besoin de configurer le module X avant le module Y? Est-il important de vérifier un code de retour pour voir si un fichier était déjà ouvert, ou ignorons-nous consciemment le code de retour parce que cela a été vérifié ailleurs? Le "pourquoi" du code sera pertinent pour tout le monde, quelle que soit l'expérience - et ce le sera aussi pour lui dans 6 mois, lorsqu'il aura oublié la bonne raison de faire quelque chose d'une manière particulière. Les commentaires ne concernent pas uniquement les autres, ils vous aident également à l'avenir.
Si vous voulez éviter d'ennuyer votre patron, posez des questions intelligentes. Concentrez-vous sur le "pourquoi" et essayez de déterminer vous-même le "quoi" (à moins que ce soit vraiment obscur). On ne posera pas de questions à un bon patron s’il n’est pas le genre de choses que vous auriez pu trouver dans R-ing TFM. Et aucun bon ingénieur ne voudra se faire demander de faire quelque chose qui facilitera considérablement la vie d'un autre ingénieur, à moindre coût. (Ne lui demandez simplement pas de renvoyer des commentaires sur l'ensemble du code!;)