目前接口文档都是按照规定的格式进行文档的提取和汇总，但有的接口需要有额外的说明，就得重新建立一个说明文本，对接口使用者来说，不太好定位。建议跟apidoc一样，在每个接口下面增加一个 类似接口备注类似的功能。那样有需要额外说明的就直接填写那里了。