Skip to content

Commit

Permalink
Add release instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
jaap3 committed Dec 7, 2023
1 parent 03aa1c3 commit f514061
Show file tree
Hide file tree
Showing 2 changed files with 46 additions and 4 deletions.
44 changes: 44 additions & 0 deletions CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Leukeleu Eslint configuration

## Testing this package

To reduce the chances of publishing bugs, test your package before publishing it to the npm registry. Run npm install with the full path to your package directory. You can get this path with `pwd` in your terminal.

`npm install <local path to this repo>`

## Releasing this package

The release of the package can be done entirely on GitHub.

### Bump version

For a release you want to change the version within package.json and create a tag.

1. In GitHub at the top, Go to the `Actions` tab.
1. In the left sidebar, press the Run the GitHub Action named `Bump NPM version` action.
1. You'll see an overview of previous ran actions. On the top right press the button `Run workflow`.

You'll get a prompt to enter a version type. Choose from:

- 'major' version when you make incompatible API changes
- 'minor' version when you add functionality in a backwards compatible manner
- 'patch' version when you make backwards compatible bug fixes

(See https://semver.org/ for more information about versioning)

The action will bump te version, create a tag and push this to the main branch. When the action is done you can see a commit from `leukeleu-deployer` in the package-json. And that there's a tag with the new version number added to the tags.

### Make a release

Now we created a new tag we can continue to make a release.

1. Go to `Releases` in the right sidebar on GitHub.
1. Press the `Draft a new release` button.
1. Press the `Choose a tag` selector and select the tag that was just generated by the `npm-version` GitHub Action.
1. Press `Generate release notes`.
1. Review the generated notes and edit wherever needed. We want to make the changes easy to understand for the maintainers of projects this package is used in.
1. When satisfied with the notes, you can publish the release. Press `Publish release`.

The release is now published on GitHub and you can see your new version in the right sidebar as latest.

The release will also trigger a GitHub Action that releases the package to NPM. Only thing you have to do is check whether the Action succeeded and the package is correctly published to https://www.npmjs.com/package/@leukeleu/stylelint-config.
6 changes: 2 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,8 +48,6 @@ module.exports = {
}
```

## Testing this package
## Contributing

To reduce the chances of publishing bugs, test your package before publishing it to the npm registry. Run npm install with the full path to your package directory. You can get this path with `pwd` in your terminal.

`npm install <local path to this repo>`
To learn how to local test and publish this package, please refer to the instructions in the `CONTRIBUTORS.md` file.

0 comments on commit f514061

Please sign in to comment.