Use wikipedia wiki links
We also have several comment tokens we use in various situations:
* Anywhere the code may be unintuitive or surprising, we add an [
http: //en.wikipedia.org/wiki/Nota_bene "NB"] comment that provides an explanation.* For code that is considered "dirty" or less than ideal, but necessary from a practical perspective, we add a [ http: //en.wikipedia.org/wiki/Kludge#In_computer_science "HACK"] comment explaining it.
* For code (or lack thereof) that is considered wrong or broken, and in need of repair, we add a "FIXME" comment with the relevant developer's initials, to serve as a reminder to address it as soon as time allows.
* When additional work is needed somewhere, but not urgently, we add a "TODO" comment marking it.