［译］AngularJS Git提交信息规范

时间 2019-11-16

原文原文链接

目标linux
- 生成 CHANGELOG.mdgit
- 识别不重要的提交angularjs
- 在浏览 Git 历史时提供更多信息github

格式化提交信息工具

恢复(Revert)测试

信息头部fetch

- 必需<type>
  - 必需<scope>
  - <subject>文本

信息主体spa

信息尾部日志

- 重大更改(Breaking changes)
  - 引用讨论(Referencing issues)

目标

可以经过脚本生成 CHANGELOG.mdcode
能让 git bisect 过程忽略不重要的提交
在浏览历史时提供更好的信息

生成 CHANGELOG.md

咱们在 changeling 里使用这三个标志: new features, bug fixes, breaking changes.
在作一个发行版的时候，这个列表能够经过脚原本生成，经过关联这些相关的提交。
天然，你能够在实际发行以前编辑这些变动日志，可是这样子能够很容易的生成骨架。

列出自最近一次发行以来全部的主体（提交信息第一行）

>> git log <last tag> HEAD —pretty=format:%s

在本次发行内的新功能

>> git log <last release> HEAD —grep feature

识别不重要的提交

一般有不少的Formatting changes(adding/removing spaces/empty lines, indentation), missing semicolons, comments.因此当你查找一些变动的时候，你能够忽略这些提交 - 这些提交里面没有业务逻辑变动。

当二分查找的时候，你能够忽视这些提交经过键入如下命令：

>> git bisect skip $(git rev-list —grep irrelevant <good place> HEAD)

在浏览历史时提供更多信息

这将会增长一种“context”信息
看这些信息（经过查看最近的 angularjs 的提交信息）

Fix small typo in docs widget (tutorial instructions)
Fix test for scenario.Application - should remove old iframe
docs - various doc fixes
docs - stripping extra new lines
Replaced double line break with single when text is fetched from Google
Added support for properties in documentation

全部这些信息都尝试去代表更改的位置，可是它们没有使用公共的规范
再看看这些信息：

fix comment stripping
fixing broken links
Bit of refactoring
Check whether links do exist and throw exception
Fix sitemap include (to work on case sensitive linux)

你能猜出这里面到底装了些什么？这些信息缺少重点。
也许还有这些代码：docs, docs-parser, compiler, scenario-runner, ...
我知道，你能够经过查看哪些文件被改变来肯定这个提交到底作了什么，可是这样子太麻烦了。
当查看 git 历史信息的时候咱们能够看到你们都在努力保持一致，可是缺乏一个公共规范。

提交信息的格式化

<type>(<scope>):<subject>
 <BLANK LINE>
 <body>
 <BLANK LINE>
 <footer>

提交信息的任意一行都不能超过100个英文字符！这个能让信息在 github 上和 git 工具里更容易查看。

恢复

若是提交是用于恢复一个更早的提交，这个头部应该以“revert:”开始，接下来是被恢复提交的头部，在主体内应该写“This reverts commit <hash>.”，hash 的位置就是被恢复提交的 sha 值

信息头部

信息头部应该是包含改变的一条单行简要描述，包括一个类型，一个可选的范围和一个主题

必需的<type>
这是用于说明提交的类型，下列是7个标志。

feat: 新功能
fix : 修补bug
docs: 文档
style: 格式化，缺乏分号等
refactor
test: 增长缺乏的测试
chore 维护

必需的<scope>
范围能够是任何制定的提交更改的地方。例如 $location, $browser, $compile, $rootScope, ngHref, ngClick, ngView等等
<subject>文本
这是变动的简单描述

以动词开头，使用第一人称如今时，好比change，而不是changed或changes
第一个字母小写
结尾不加句号

信息主体

这部分是对本次提交的详细描述，能够分红多行

使用第一人称如今时，好比使用 change 而不是 changed 或者 changes。
说明代码变动的冬季，以及和之前代码的对比

信息尾部

只有两种状况：不兼容变更全部不兼容变更应该被列为不兼容变更块放在信息尾部，应该以“BREAKING CHANGE:”开始，后面是对变更的描述，以及变更的动机和迁移方法引用讨论若是当前提交是针对某个讨论，那么能够在尾部关闭这个讨论Closes #234或者同时关闭多个讨论Closes #123, #245, #992