This document explains the release strategy for opensearch-api-specification.
At this time this project follows minor semantic versioning, i.e. a breaking change is an increment from 0.1.0 to 0.2.0 and a non-breaking change is an increment from 0.1.0 to 0.1.1. A version 1.0 of the API specification will be released when the spec is known to be complete against any current version of OpenSearch.
Given the early release stages of this repo we only maintain a main branch where all merges take place and code moves fast.
A release can be done by any maintainer.
- Check out the upstream repo and ensure the repo is up-to-date with
git pull origin main
and that you do not have any local changes. - Create a tag, e.g.
git tag v0.1.0
, and push it to GitHub withgit push origin --tags
. - The release workflow will be automatically kicked off, a draft release, and a pull request that increments the version in spec/_info.yaml will be created.
- Verify and release the draft.
- Approve, and merge the version increment pull request.