Devriez-vous utiliser des «abréviations internes» dans les commentaires du code? [fermé
https://softwareengineering.stackexchange.com/questions/67310
-
31-10-2019 - |
Question
Si vous utilisez des commentaires "Abréviations internes / argot", c'est-à-dire que les abréviations et l'argot en dehors du projet pourraient avoir du mal à comprendre, par exemple, en utilisant quelque chose comme //NYI
à la place de //Not Yet Implemented
?
Il y a des avantages à ce sujet, comme il y a moins de "code" à taper (bien que vous puissiez utiliser la saisie semi-automatique sur les abréviations) et vous pouvez lire quelque chose comme NYE
plus rapide que quelque chose comme Not Yet Implemented
, en supposant que vous êtes conscient de l'abréviation et de sa signification (non abrégée).
Moi-même, je ferais attention à cela tant que ce n'est pas un projet sur lequel je serai certainement le seul développeur.
Pas de solution correcte