注释有时候也可以用来给一段代码声明额外的信息。这些声明的格式以单个单词打头并紧跟一个冒号。可以使用的声明如下。
TODO:
说明代码还未完成。应当包含下一步要做的事情。
HACK:
表明代码实现走了一个捷径。应当包含为何使用hack的原因。这也可能表明该问题可能会有更好的解决办法。
XXX:
说明代码是有问题的并应当尽快修复。
FIXME:
说明代码是有问题的并应尽快修复。重要性略次于XXX。
REVIEW:
说明代码在任何可能的改动都需要评审。
这些声明可能在一行或者多行注释中使用,并且应当遵循同一般注释类型相同的格式规则。
参考:JavaScript编码风格指南(中文版)