资源
有什么变化,什么时候。
Payrolless 尚未向公众开放,代码库中也没有已发布的版本。因此,若现在写带日期的条目,就只能编造历史。这里先说明记录框架;从首次上线起,所有经过核验的变化都会按此记录。
首次公开发布之前
开发中的改动不会被写成用户已经能用的新功能。第一条记录只会在注册真正开放时出现,并注明实际上线日期和正式版本标识。临时版本号或代码提交日期,都不能冒充一次发布。
每条记录对应一种可观察的变化
每条记录都会说明用户能多做什么,或哪里变得不同:接入一种新工具、更清楚地理解批准、找到一项信息,或看到一个错误已被修正。没有可见影响的内部调整只留在技术历史中,不写入本日志。
按版本归组
各条记录会归在使其正式生效的版本之下,并共享该版本的上线日期。若有助于理解影响,同一版本可以分成新增、改进和修正。文字只描述已经交付的结果,不会把提交记录包装成宣传材料。
核验后再发布
相关使用流程在构建后的服务上核验完毕,版本说明才会随之出现。若某项行为被移除或改变形式,也会在同一处说明。未来预告、承诺日期和仍在施工的功能,都不会写进来。