Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

release: update release guide #167

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

lucab
Copy link
Member

@lucab lucab commented Jul 14, 2020

This updates the metadata for cargo-release and the release instructions, in order to work with latest binary.
Notably:

Closes: #166

@lucab lucab requested a review from steveej July 14, 2020 09:31
@lucab
Copy link
Member Author

lucab commented Jul 14, 2020

/cc @steveej

docs/release-guide.md Outdated Show resolved Hide resolved
docs/release-guide.md Outdated Show resolved Hide resolved
docs/release-guide.md Show resolved Hide resolved
@steveej
Copy link
Contributor

steveej commented Oct 6, 2020

@lucab would you mind creating a separate PR for the Cargo.toml update? I'm trying to do a release with this updated guide to verify it which relies on those changes already being merged.

@lucab
Copy link
Member Author

lucab commented Oct 7, 2020

@steveej up at #182. I've thus dropped the manifest changes from this PR.

Copy link
Contributor

@steveej steveej left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the cleanup. The guide works well with just a few nitpicks.

- [ ] `RELEASE_VER=x.y.z`
- [ ] `UPSTREAM_REMOTE=origin`

:warning:: `UPSTREAM_REMOTE` should reference the locally configured remote that points to the upstream git repository.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
:warning:: `UPSTREAM_REMOTE` should reference the locally configured remote that points to the upstream git repository.
:warning: `UPSTREAM_REMOTE` should reference the locally configured remote that points to the upstream git repository.

- [ ] open a web browser and create a PR for the branch above
- [ ] make sure the resulting PR contains exactly two commits
- [ ] in the PR body, write a short changelog with relevant changes since last release

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

- make sure the project is clean and prepare the environment:
- [ ] `cargo test`
- [ ] `cargo clean`
- [ ] `git clean -fd`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm uncertain whether to leave the -d parameter to remove untracked files in here or not. At least we should add a warning about it.


2. create release commits on a dedicated branch and tag it:
- [ ] `git checkout -b release-${RELEASE_VER}`
- [ ] `cargo release` (and confirm the version when prompted)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For a minor release I had to run cargo release -- minor, as the RELEASE_VER environment variable is not considered by cargo release. Should we add a note on this or do we trust this to be intuitive enough?

@lucab lucab changed the title release: update cargo metadata and release guide release: update release guide Oct 8, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Release guide is not compatible with cargo-release-release 0.12.4
2 participants