quels jetons trouvez-vous utiles dans le studio visuel? (visual studio 2010 → environnement → liste des tâches → jetons)jetons en studio visuel: HACK, TODO ... un autre?
actuellement je ne dispose que:
(seulement ces - supprimé certains ceux par défaut)
utilisez-vous d'autres?
couvrez-vous d'autres choses importantes avec des jetons de commentaire?
des meilleures pratiques? thnx
est ici ceux que j'utilise:
j'aime fixme et bug :) j'utilise hack pour fixme. va ajouter un bug! – b0x0rz
J'utilise la même chose :) - Je fais des sous-catégories pour mes FIXME, à savoir: FIXME - Performance. – cwap
Yup. Et TODO - TRADUIRE. Nous utilisons Mantis # 123 pour faire référence à notre système de suivi des bogues et au numéro correspondant. – Konerak
Un autre élément intégré est NOTE.
ouais, n'a pas aimé depuis n'est pas un commentaire un NOTE en quelque sorte? – b0x0rz
D'accord, mais j'essaie de ne pas utiliser de commentaires du tout, sauf pour NOTE. Si j'ai autre chose, cela va dans le système de suivi. Dans mon cas JIRA. –
ah, je vois, j'utilise les commentaires un peu plus: P – b0x0rz
Vim met automatiquement en surbrillance XXX, qui se trouve être mon gage de choix pour la facilité de saisie.
Sun's (old) Java coding conventions ont ceci à dire:
Utilisez
XXXdans un commentaire à quelque chose de drapeau qui est faux, mais fonctionne. UtilisezFIXMEpour marquer quelque chose qui est faux et cassé.
bonne astuce sur vim. Je ne le savais pas. – b0x0rz
J'ai fait une combinaison de la plupart des jetons ci-dessus.
RED: code that simply does not work/compile
// Error - This code is throwing a specific reproducible error.
// Broken - This code is broken and will not run.
// WTF - WHAT THE FRIG.
ORANGE: code that works but is not right
// Hack - This code has intentionally been hacked in order to work. Should not go into production.
// FixMe - This code works but could be better. Needs better abstraction, maintainability, performance, etc.
// Bug - This code works and was expected to be right but a bug has been found. (usually flagged post production)
// Review - This code is probably right but should be reviewed for piece of mind.
// Smells - Same as FixMe
BLUE: code that works but either needs more features or more explaining
// Todo - Functionality is not yet implemented
// Note - Better explain what's going on. This is gives a higher profile to standard comments, and allows notes to be found in the to-do pane.
Je n'utilise pas nécessairement tous ces éléments, mais en fonction de mon humeur ce jour-là, je vais obtenir les faits saillants d'une façon ou d'une autre. –
C'est plutôt cool si tous les employés de votre entreprise ont les mêmes jetons en évidence. Si cela ne rend pas les commentaires plus difficiles à comprendre dans certains cas. –
Comment la fonction _functionality n'est pas encore implémentée_ code qui fonctionne? –
J'aime le jeton RETIRER, ce qui indique qu'il est seulement pour les tests, et ne devrait pas être inclus dans la version finale
devrait probablement être wiki communautaire. – Konerak
pour qui atterrit ici à la recherche des jetons de liste des tâches dans Visual Studio, notez que les commandes de menu sont Visual studio → outils → options → environnement → liste des tâches → jetons – lib