Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

组件 Changelog 标准 #38

Open
zwhu opened this issue Nov 16, 2017 · 0 comments
Open

组件 Changelog 标准 #38

zwhu opened this issue Nov 16, 2017 · 0 comments

Comments

@zwhu
Copy link
Owner

zwhu commented Nov 16, 2017

Changelog

Branch-Name (0.0.2)

branch summary

Container Name (input)

summary

  • [type](Taone-id): summary
  • [feat](T1999999): add validate mode
    • [feat]: add number validate
    • [feat]: add price validate
    • [fix]: fix some bugs
    • [fix](T 200000): fix that some bugs bug

Container Name (select)

summary

  • [feat](T20001): add combobox mode
  • [fix](T200002): fix bug
    • [fix](T200009): fix T200002 bug bug
  • [fix](T200003): fix other bug

详细介绍

Changelog 的二级标题是分支名,每个分支都是有自己的目标的(例如修复 bug,增加功能点等等),所以可以在分支下面附上一些简短的介绍分支功能(不建议很长,和之后要写的内容重叠)。summary 都是非必填但是推荐填写的。

Changelog 的三级标题是组件名称,Container 仓库的以组件为维度。

列表:
[功能类型](Aone 的 id):此次修改所做的事情的简短介绍。

列表的第一层级是独立事件,第二层级是第一层级的关联事件,深度为 2 层。

注意点

每次组件的提交都应该去更改 Changelog,这是对 Changelog 的持续维护。

一个组件有多个新功能点,分多次提交,那么每次提交都应该去修改 Changelog,标注此次更新内容。

一个组件只有一个新功能点,但是第一次提交的时候,以为自己的提交已经完成所有功能,但是实际情况是没有完成,那么就可以去更新 Changelog 为

### Container Name (input)

-[feat]: 增加 xxx 功能点
	* [feat]: 上一次代码完成的功能有哪些 ....
	* [feat]: 本次代码完成的功能有哪些....

Tips:
虽然原则是应该是最小化提交。每次 commit 都只做一件事,但是如果真的在一次 commit 里面做了多件事,改了多个 cotainer 的代码, 也是同样可以在 changelog 中修改多个 container 的内容。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant