《公约》本身的问题应报告在Angular问题跟踪仪上.
《角公约》
角质 承诺信息准则。 。 。 .
实例
在"Features"标题下外观,铅笔子标题:
feat(pencil): add 'graphiteWidth' option
外观为"Bug Fixes"标题下,石墨子标题下,并有链接到第28期:
fix(graphite): stop graphite breaking when width < 0.1
Closes #28
外观为"性能改进"标题下,"生动变化"下有断裂变化解释:
perf(pencil): remove graphiteWidth option
BREAKING CHANGE: The graphiteWidth option has been removed. The default graphite width of 10mm is always used for performance reason.
下述行为: 667ecc1 如果它们处于同一版本下,则不出现在更改日志中。 如果没有,则返回承诺出现在“Reverts”标题下.
revert: feat(pencil): add 'graphiteWidth' option
This reverts commit 667ecc1654a317a13331b17617d973392f415f02.
提交信件格式
承诺信息包括: 标题, (中文(简体) ), 机构 财务报告和审定财务报表 页脚。标题有 类型, (中文(简体) ), 范围 财务报告和审定财务报表 主题数字 :
<type>(<scope>): <subject>
<BLANK LINE>
<body>
<BLANK LINE>
<footer>
这个 标题 强制的,以及 范围 标题是可选的.
还原
如果承诺还原了先前的承诺,则应从 revert: 然后是重犯头目。 在体内,它应该说: This reverts commit <hash>.,其中散列是SHA 承诺被还原.
类型
如果前缀是 feat, (中文(简体) ), fix 或者说 perf,它会出现在更改日志中。 不过,如果有的话 破坏变化承诺将永远出现在更改日志中.
其他前缀由你斟酌决定. 建议的前缀为: build, (中文(简体) ), ci, (中文(简体) ), docs , (中文(简体) ),style, (中文(简体) ), refactor,以及 test 用于非更改相关任务.
这些类型的详情见官方网站 角贡献准则。 。 。 .
范围
范围可以是规定承诺变化地点的任何东西。 举个例子 $location, (中文(简体) ),
$browser, (中文(简体) ), $compile, (中文(简体) ), $rootScope, (中文(简体) ), ngHref, (中文(简体) ), ngClick, (中文(简体) ), ngView等,还有...
议题
这一主题简要地描述了这一变化:
- 使用必须的,现在的时态:"改变"不是"改变"或"改变"
- 不要利用第一个字母
- 结尾没有点 (.)
体质
和以前一样 主题,使用必须的,现在的时态:"改变"不是"改变",也不是"改变". 身体应该包括改变的动机,并与以前的行为作对比.
页脚
该页脚应包含任何关于 中断更改 也成为 引用此操作的 GitHub 问题 关闭。 。 。 .
中断更改 应该从字开头 BREAKING CHANGE: 带有一或两条新行。 其余的承诺信息则用于此.
详细解释见此 文档。 。 。 .