种行为是很常见的，也普遍被接受的。
算法描述.比如，下面程序将增加一个注释来解释为什么插入排序没有被快速排序所替代，即使理论上前者比后者更慢。这将写为如下：
元数据和资源.在注释中，可以插入各种资源和元数据。下面是Spring框架中的一段注释，用于表达版权。许多代码维护者会将指导（元数据）放到注释中，帮助读者更好的阅读，并提供反馈途径。但值得一提，随着Git等版本管理器的流行，元数据作为指导的功能也被部分代替了，如：GIt能记录第一版代码、代码创