同步操作将从 腾讯开源/APIJSON 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
在对项目作出更改后,我们需要生成 Commit 来记录自己的更改。以下是参照 Angular 对 Commit 格式的规范:
提交信息包括三个部分:Header
,Body
和 Footer
。
<Header>
<Body>
<Footer>
其中,Header 是必需的,Body 和 Footer 可以省略。
Header 部分只有一行,包括俩个字段:type
(必需)和subject
(必需)。
<type>: <subject>
Type
Type 用于说明 Commit 的类别,可以使用如下类别:
Subject
Subject 是 Commit 目的的简短描述。
Body 部分是对本次 Commit 的详细描述,可以分成多行。下面是一个范例。
More detailed explanatory text, if necessary. Wrap it to
about 72 characters or so.
Further paragraphs come after blank lines.
- Bullet points are okay, too
- Use a hanging indent
**注意:**应该说明代码变动的动机,以及与以前行为的对比。
Footer 部分应该包含:(1)Breaking Changes; (2)关闭 Issue;
Breaking Changes:
如果当前代码与上一个版本不兼容,则 Footer 部分以BREAKING CHANGE
开头,后面是对变动的描述、以及变动理由和迁移方法。这种使用较少,了解即可。
Issue 部分:
通过 Commit 关联 Issue:
如果当前提交信息关联了某个 Issue,那么可以在 Footer 部分关联这个 Issue:
issue #2
通过 Commit 关闭 Issue,当提交到默认分支时,提交信息里可以使用 fix/fixes/fixed
, close/closes/closed
或者 resolve/resolves/resolved
等关键词,后面再跟上 Issue 号,这样就会关闭这个 Issue:
closes #1
注意,如果不是提交到默认分支,那么并不能关闭这个 Issue,但是在这个 Issue 下面会显示相关的信息表示曾经想要关闭这个 Issue,当这个分支合并到默认分支时,就可以关闭这个 Issue 了。
下面是一个完整的例子:
feat: 添加了分享功能
给每篇文章添加了分享功能
- 添加分享到微信功能
- 添加分享到朋友圈功能
issue #1, #2
closes #1
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。