53 lines
2.5 KiB
Markdown
53 lines
2.5 KiB
Markdown
# [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][daviddm-image]][daviddm-url] [![Coverage Status][coveralls-image]][coveralls-url]
|
|
|
|
> [conventional-changelog](https://github.com/ajoslin/conventional-changelog) [jQuery](https://github.com/jquery/jquery) preset
|
|
|
|
**Issues with the convention itself should be reported on the JQuery issue tracker.**
|
|
|
|
## JQuery Convention
|
|
|
|
Commit messages should describe what changed, and reference the issue number if the commit closes or is associated with a particular issue. Commit messages for all jQuery projects should look like this:
|
|
|
|
```
|
|
Component: Short Description
|
|
|
|
Optional Long Description
|
|
|
|
Fixes #xxx
|
|
Closes gh-yyy
|
|
Ref #zzz
|
|
```
|
|
|
|
Every commit must have a subject (the first line). Everything else is optional.
|
|
|
|
### Subject
|
|
|
|
This is the first line. It consists of a component, like "Event" or "Autocomplete".
|
|
|
|
### Long description
|
|
|
|
There are two line breaks between the subject and the long description. The description can have any length and formatting, like lists.
|
|
|
|
### References
|
|
|
|
References to issues or pull requests go after the long description, each one on their own line.
|
|
|
|
* Use **Fixes** when the commit fixes an open issue.
|
|
|
|
* Use **Closes** when the commit closes an open pull request.
|
|
|
|
* Use **Ref** when referencing an issue or pull request that is already closed or should remain open. Examples include partial fixes and commits that add a test but not a fix.
|
|
|
|
* Always use "gh-xxx" for GitHub issues and pull requests within the same repository. Use "\[user\]/\[repo\]#xxx" when referencing an issue or pull request in another repository, e.g., "Closes jquery/jquery-ui#175".
|
|
|
|
Based on https://github.com/jquery/contribute.jquery.org/blob/master/pages/commits-and-pull-requests.md#commit-guidelines
|
|
|
|
[npm-image]: https://badge.fury.io/js/conventional-changelog-jquery.svg
|
|
[npm-url]: https://npmjs.org/package/conventional-changelog-jquery
|
|
[travis-image]: https://travis-ci.org/conventional-changelog/conventional-changelog-jquery.svg?branch=master
|
|
[travis-url]: https://travis-ci.org/conventional-changelog/conventional-changelog-jquery
|
|
[daviddm-image]: https://david-dm.org/conventional-changelog/conventional-changelog-jquery.svg?theme=shields.io
|
|
[daviddm-url]: https://david-dm.org/conventional-changelog/conventional-changelog-jquery
|
|
[coveralls-image]: https://coveralls.io/repos/conventional-changelog/conventional-changelog-jquery/badge.svg
|
|
[coveralls-url]: https://coveralls.io/r/conventional-changelog/conventional-changelog-jquery
|