一般元规则

编码

使用 UTF-8(无 BOM)。

确保你的编辑器将没有字节顺序标记的 UTF-8 用作字符编码。不要将样式表的编码设置为假定的 UTF-8。

注释

在可行和必要时,对代码添加注释。

用注释解释代码的覆盖范围、目的和作用以及使用和选择各解决方案的原因。

任务项

用 TODO: 标注待办事项和任务项:

仅用关键词 TODO 标注待办事项,不要使用 @@ 等其他格式的字样。在任务项前加冒号,如:TODO: action item。

推荐:

/* TODO: 添加一个按钮元素 */