-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
chore(readme): add readme covering repo's functionality
- Loading branch information
1 parent
c4110d9
commit b1e15a9
Showing
1 changed file
with
100 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,101 @@ | ||
# seed | ||
seed repository with basic | ||
|
||
Purpose of this repo is to serve as a seed repository for any kind of project, that has some | ||
basic functionality: | ||
|
||
# Commit linting | ||
Checks if your commit messages meet the conventional commit format. Note: Please check [rules](https://github.com/conventional-changelog/commitlint/blob/master/docs/reference-rules.md) / [rules](https://conventional-changelog.github.io/commitlint/#/reference-rules) before using it. | ||
|
||
In general the pattern mostly looks like this: | ||
|
||
`type(scope?): subject` (scope is optional) | ||
|
||
Real world examples can look like this: | ||
|
||
`chore: run tests on travis ci` | ||
|
||
`fix(server): send cors headers` | ||
|
||
`feat(blog): add comment section` | ||
|
||
--- | ||
|
||
Common types according to [commitlint-config-conventional](https://github.com/conventional-changelog/commitlint/tree/master/%40commitlint/config-conventional#type-enum) (based on the the Angular convention) can be: | ||
|
||
- build | ||
- ci | ||
- chore | ||
- docs | ||
- feat | ||
- fix | ||
- perf | ||
- refactor | ||
- revert | ||
- style | ||
- test | ||
|
||
These can be modified by your own [configuration](https://github.com/conventional-changelog/commitlint#config). | ||
|
||
You still can commit with `git commit`, however the recommended way to do it is by using **cli-prompt** for commits. | ||
|
||
Implemented with [commitlint](https://github.com/conventional-changelog/commitlint) | ||
|
||
![](https://trello-attachments.s3.amazonaws.com/5c544e9a28eba76fabf3dedb/5c544f7796142c1efdc3edd0/f8c47b856c62436587298256cff0ae77/Screen_Shot_2018-12-05_at_11.06.23.png) | ||
|
||
--- | ||
|
||
# CLI prompt for commits | ||
|
||
You still can commit with git commit, however the recommended way to do it is by using cli-prompt for commits - commitizen-cli. Run `yarn commit` to open | ||
a prompt with a step-by-step wizard with hints to properly fill in the commit data. | ||
|
||
![](https://trello-attachments.s3.amazonaws.com/5c544e9a28eba76fabf3dedb/5c544f7796142c1efdc3edd0/b7a3e5a846f7b88247d8e5da3285e81f/Screen_Shot_2018-12-05_at_11.23.31.png) | ||
|
||
Implemented with [commitizen](https://github.com/commitizen/cz-cli) | ||
|
||
Following conventional commit format will allow us to automatically generate changelog from commit history, that would have chapters (features, bugfixes, etc.) and would look like [this](https://github.com/angular/material2/releases) | ||
|
||
# Recommended version bump | ||
Run `yarn recommended:bump` to find out what is the reccomended version for bump. | ||
|
||
Implemented with [recommended bump](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-recommended-bump) | ||
|
||
# Changelog generation | ||
Run `yarn changelog` to generate a changelog (will overwrite any previous changelog if exists). Generates a changelog based on commits since the last semver tag that match the pattern of a "Feature", "Fix", "Performance Improvement" or "Breaking Changes". Conventional commits are a necessary prerequisite, enabling automatic changelog generation from commit history. | ||
|
||
Implemented with [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog). | ||
|
||
![](https://trello-attachments.s3.amazonaws.com/5c544e9a28eba76fabf3dedb/5c54672549044a1837c0364c/aff687d86a74b45704cb8556ce242452/2019-02-01_16-48-48.png) | ||
|
||
--- | ||
Recommded flow: | ||
|
||
1. Run `yarn recommended:bump` to find out what is the reccomended version for bump | ||
2. Depending on which version you want to bump, run one of the following (this will also create git tag): | ||
``` | ||
yarn version --major | ||
yarn version --minor | ||
yarn version --patch | ||
``` | ||
3. Generate changelog with `yarn changelog` | ||
4. Commit `package.json` and `CHANGELOG.md` files | ||
5. Push including tags with `git push --follow-tags` | ||
6. Manually create a release draft in Github and copypaste changelog’s release markdown to it | ||
# Enforce gitflow branches | ||
Implemented with [enforce-gitflow-branches](https://github.com/Dacrol/EnforceBranchNames) | ||
![](https://trello-attachments.s3.amazonaws.com/5c546d7eddb4a82f52f14917/970x1572/915f284c485422b5aab05baa832bbb8b/image.png) | ||
# Enforce yarn | ||
Programmatically enforce usage of yarn instead of npm for installing node packages. | ||
Implemented with `.nvmrc` according [to](https://github.com/yarnpkg/yarn/issues/4895). | ||
![](https://trello-attachments.s3.amazonaws.com/5c55aeddd546a91ee331ecea/1028x390/99d9274660a0ab1de5ab01cb492dbf99/image.png) | ||
![](https://trello-attachments.s3.amazonaws.com/5c544e9a28eba76fabf3dedb/5c55aeddd546a91ee331ecea/d4682258d34fce791634528d27997cec/image.png) | ||
# Enforce node version (.nvmrc) | ||
Implemented according [to](https://medium.com/@hebet/locking-down-a-project-to-a-specific-node-version-using-nvmrc-and-or-engines-e5fd19144245) | ||
# Editorconfig | ||
Implemented with [editorconfig](https://editorconfig.org/) |