|
1 | | -# release-config-template |
2 | | -semantic-release release configuration template repository |
3 | | - |
4 | | -# How do I use it? |
5 | | -1. modify `index.js` to export whatever release config you want, this is the shareable config that other releases will use. |
6 | | -2. Replace all instances of `release-config-template` with the name of your release config. It should follow the convention `release-config-{your name here}` |
7 | | -3. PR to main following conventional commits. Make sure your squash message follows conventional commits. |
8 | | -4. The release workflow should run, and publish your shareable config to npm so you can use it in releases via extends as `@unsupervised/release-config-{your name here}` |
| 1 | +# release-config-general |
| 2 | +A semantic-release sharable configuration for releasing general code. This is a fairly standard configuration with no exec plugins, and no npm plugin. |
| 3 | +This release config generats release notes, a changelog, commits the changelog via the git plugin, and releases to github. |
| 4 | +## Plugins |
| 5 | + |
| 6 | +This shareable configuration use the following plugins: |
| 7 | + |
| 8 | +- [`@semantic-release/commit-analyzer`](https://github.com/semantic-release/commit-analyzer) |
| 9 | +- [`@semantic-release/release-notes-generator`](https://github.com/semantic-release/release-notes-generator) |
| 10 | +- [`@semantic-release/changelog`](https://github.com/semantic-release/changelog) |
| 11 | +- [`@semantic-release/git`](https://github.com/semantic-release/git) |
| 12 | +- [`@semantic-release/github`](https://github.com/semantic-release/github) |
| 13 | + |
| 14 | +## Install |
| 15 | + |
| 16 | +```bash |
| 17 | +$ npm install --save-dev semantic-release @unsupervised/release-config-general |
| 18 | +``` |
| 19 | + |
| 20 | +## Usage |
| 21 | + |
| 22 | +The shareable config can be configured in the [**semantic-release** configuration file](https://github.com/semantic-release/semantic-release/blob/master/docs/usage/configuration.md#configuration): |
| 23 | + |
| 24 | +```json |
| 25 | +{ |
| 26 | + "extends": "@unsupervised/release-config-general" |
| 27 | +} |
| 28 | +``` |
| 29 | + |
| 30 | +## Configuration |
| 31 | + |
| 32 | +See each [plugin](#plugins) documentation for required installation and configuration steps. |
| 33 | + |
0 commit comments