This repository automatically deploys any changes made to the main
branch.
In the event, that you'd like to stage changes to be released together (aka lump) we suggest the following process.
Some use cases in which this may be desired...
- A new version of
pack
may require some options in our guides to change and we'd like to coordinate the docs changes with the release of the new version. - A spec change may require a migration guide, some guides to change, and/or a new guide altogether. We want to update the docs all in one swoop.
- A milestone in the following format is created:
<component(s)>/<version>
* - Issues are created and tagged with appropriate milestone.
- A release branch in the following format is created off of
main
:release/<component(s)>/<version>
* - As changes are completed, PRs would target the release branch and merged using the same guidelines as merging to
main
. - Once all issues and/or the associated component release is shipped, the release branch is merged into
main
by sub-team maintainers.
* may require a project contributor or maintainer intervention.
Branches:
release/pack/1.2.3
release/spec/buildpack/0.9
release/spec/extension/bindings/0.3
release/tekton/task/buildpacks/0.5
Milestones:
pack/1.2.3
spec/buildpack/0.9
spec/extension/bindings/0.3
tekton/task/buildpacks/0.5
Let's imagine pack
is releasing version 1.2.3
. It is known that there will be a decent amount of changes to a few guides and we'd like to separate the entire set of changes per guide. The steps that would be taken are as follows:
- A milestone
pack/1.2.3
would be created. - Issues for the necessary changes would be tagged with milestone
pack/1.2.3
. - A release branch
release/pack/1.2.3
would be created. - As changes are completed, PRs would target
release/pack/1.2.3
and merged. - Once all issues and/or release of
pack
version1.2.3
is shipped, therelease/pack/1.2.3
branch would be merged intomain
.