marked/docs/PUBLISHING.md

16 lines
1.2 KiB
Markdown
Raw Normal View History

2018-02-19 21:13:29 +00:00
# Releasing Marked
2020-10-21 13:21:12 +00:00
Marked uses [semantic-release](https://github.com/semantic-release/semantic-release) to release new versions. All PRs should use the "Squash and merge" strategy and the commit message should follow the [conventional commit guidelines](https://www.conventionalcommits.org/).
2018-02-25 23:02:04 +00:00
## Overall strategy
2020-10-21 13:21:12 +00:00
**Master is always shippable:** We try to merge PRs in such a way that `master` is the only branch to really be concerned about *and* `master` can always be released. This allows smoother flow between new features, bug fixes, and so on.
2018-02-19 21:30:38 +00:00
2018-02-19 21:13:29 +00:00
## Versioning
We follow [semantic versioning](https://semver.org) where the following sequence is true `[major].[minor].[patch]`:
2018-02-19 21:13:29 +00:00
1. **Major:** There is at least one change to the public API or a break from the [CommonMark](https://spec.commonmark.org/current/) or [GFM](https://github.github.com/gfm/) spec. Only [current and LTS](https://nodejs.org/en/about/releases/) Node.js versions are supported at any point in time. A drop in support for a Node.js version may not result in a semver major bump to Marked.
2. **Minor:** There is at least one new feature added to the public API.
3. **Patch:** Changes that move Marked closer to spec compliance or change a public API that does not break backwards compatibility.