views:

218

answers:

3

what tokens do you find useful in visual studio? (visual studio 2010environmenttask list → tokens)

currently i have only:

  • HACK - low
  • REVIEW - high
  • TODO - normal
  • WTF - high

(only these - deleted some default ones)

are you using any others?

are you covering any other important thing with comment tokens?

any best practices? thnx

+1  A: 

Another built-in is NOTE.

chibacity
yeah, didn't like it since isn't any comment a NOTE somehow?
b0x0rz
Agreed, but I try not to use comments at all except for NOTE. If I have anything else, it goes into the tracking system. In my case JIRA.
chibacity
ah, i see, i use comments a bit more :P
b0x0rz
I'm not a big fan of the old green ink :)
chibacity
+2  A: 

Here's the ones I use:

  • TODO: the functionality is not yet implemented
  • FIXME: the code should be modified/refactored to achieve some goal (higher maintainability, better performance, and so on)
  • BUG: the code has a known bug
Enrico Campidoglio
i like fixme and bug :) i use hack for fixme. will add bug!
b0x0rz
I use the same :) -- I do subcatagories for my FIXME's, i.e.: FIXME - Performance.
cwap
Yup. And TODO - TRANSLATE. We use Mantis#123 to refer to our bugtracking system and the corresponding number.
Konerak
+2  A: 

Vim automatically highlights XXX, which happens to be my token of choice for the ease of typing it.

Sun's (old) Java coding conventions have this to say:

Use XXX in a comment to flag something that is bogus but works. Use FIXME to flag something that is bogus and broken.

Mark Rushakoff
nice tip about vim. didn't know that.
b0x0rz