diff --git a/.github/COMMIT_CONVENTION.md b/.github/COMMIT_CONVENTION.md index 05e4786d68..6aaffa749a 100644 --- a/.github/COMMIT_CONVENTION.md +++ b/.github/COMMIT_CONVENTION.md @@ -56,6 +56,8 @@ A commit message consists of a **header**, **body** and **footer**. The header The **header** is mandatory and the **scope** of the header is optional. +A `!` MAY be appended prior to the `:` in the type/scope prefix, to further draw attention to breaking changes. `BREAKING CHANGE:` description MUST also be included in the body or footer, along with the `!` in the prefix. + ### Revert If the commit reverts a previous commit, it should begin with `revert: `, followed by the header of the reverted commit. In the body it should say: `This reverts commit .`, where the hash is the SHA of the commit being reverted. diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 56e1fd9971..5eb8134fb0 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,3 +1,17 @@ +## Workflow + +The Git workflow used in this project is largely inspired by [Gitflow workflow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow). + +There are two main branches: `master` and `next`, corresponding to the npm `dist-tag`s with the same names. +The documentation website for the current CLI version is deployed from the `master` branch, while documentation for new features is deployed from `next` branch. + +When sending documentation pull requests, please fork your branches from these two branches. + +The development branch is `dev`. +And there are several version branches for archiving old versions of Vue CLI, such as `v2`, `v3`. + +Pull requests that touches the code should be forked from `dev`, unless it's only targeting an old version. + ## Development Setup This project uses a monorepo setup that requires using [Yarn](https://yarnpkg.com) because it relies on [Yarn workspaces](https://yarnpkg.com/blog/2017/08/02/introducing-workspaces/). diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000000..55a5b2a458 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,27 @@ + + + + + +**What kind of change does this PR introduce?** (check at least one) + +- [ ] Bugfix +- [ ] Feature +- [ ] Code style update +- [ ] Refactor +- [ ] Docs +- [ ] Underlying tools +- [ ] Other, please describe: + + + +**Does this PR introduce a breaking change?** (check one) + +- [ ] Yes +- [ ] No + +**Other information:**