From 76d9d6d0c728052af68a3354b4fae4d5a91c751b Mon Sep 17 00:00:00 2001 From: Nick Gerace Date: Fri, 7 Jul 2023 11:06:31 -0400 Subject: [PATCH] Add libgfold CHANGELOG and release process Signed-off-by: Nick Gerace --- docs/RELEASE.md | 41 ++++++++++++++++++++++++++++++++++----- lib/libgfold/CHANGELOG.md | 26 +++++++++++++++++++++++++ 2 files changed, 62 insertions(+), 5 deletions(-) create mode 100644 lib/libgfold/CHANGELOG.md diff --git a/docs/RELEASE.md b/docs/RELEASE.md index 8b36897..a396ff1 100644 --- a/docs/RELEASE.md +++ b/docs/RELEASE.md @@ -2,14 +2,14 @@ This document contains all information related to release. -## Checklist +## Checklist (gfold) -This checklist details the `gfold` release process. +This checklist details the [**gfold**](../README.md) release process. Steps should be executed in sequential order. - [ ] Checkout and rebase `main` to its latest commit, then checkout a new branch -- [ ] Change the `version` field in [`Cargo.toml`](../crates/gfold/Cargo.toml) to the new tag -- [ ] **Full Releases Only**: change the version in `CHANGELOG.md` and uncomment the following line: `` +- [ ] Change the `version` field in [`Cargo.toml`](../bin/gfold/Cargo.toml) to the new tag +- [ ] **Full Releases Only**: change the version in [`CHANGELOG.md`](../CHANGELOG.md) and uncomment the following line: `` - [ ] Verify that everything looks/works as expected: ```shell @@ -50,7 +50,38 @@ cargo install --locked --version gfold ``` - [ ] Verify that the [GitHub release](https://github.com/nickgerace/gfold/releases) on the repository's releases page looks correct -- [ ] **Full Releases Only**: Update the formula for the [Hombrew tap](https://github.com/nickgerace/homebrew-nickgerace) +- [ ] **Full Releases Only**: Update the formula for the [Homebrew tap](https://github.com/nickgerace/homebrew-nickgerace) + +## Checklist (libgfold) + +This checklist details the [**libgfold**](../lib/libgfold/README.md) release process. +Steps should be executed in sequential order. + +- [ ] Checkout and rebase `main` to its latest commit and checkout a new branch +- [ ] Change the `version` field in [`Cargo.toml`](../lib/libgfold/Cargo.toml) to the new tag +- [ ] **Full Releases Only**: change the version in [`CHANGELOG.md`](../lib/libgfold/CHANGELOG.md) and uncomment the following line: `` +- [ ] Verify that everything looks/works as expected: + +```shell +cargo xtask ci +``` + +- [ ] Create and _do not merge_ a commit with the following message: `Update libgfold to ` +- [ ] Test and verify the publishing workflow: + +```shell +cargo publish --dry-run -p libgfold +``` + +- [ ] Merge the preparation commit into `main` +- [ ] Publish the crate: + +```shell +cargo publish -p libgfold +``` + +- [ ] Verify that the [crate](https://crates.io/crates/libgfol) on `crates.io` looks correct +- [ ] Ensure that the [docs](https://docs.rs/libgfold/latest/libgfold/) on `docs.rs` look correct ## Versioning Scheme diff --git a/lib/libgfold/CHANGELOG.md b/lib/libgfold/CHANGELOG.md new file mode 100644 index 0000000..0639d46 --- /dev/null +++ b/lib/libgfold/CHANGELOG.md @@ -0,0 +1,26 @@ +# Changelog ([libgfold](./README.md)) + +- All notable changes to this project will be documented in this file +- All changes are from [@nickgerace](https://github.com/nickgerace) unless otherwise specified +- The format was inspired by [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) +- This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) + +## Unreleased + + + +### Changed + +- Bump deps + +## 0.1.1 - 2023-06-26 + +### Added + +- Add a `README` for the crate + +## 0.1.0 - 2023-06-26 + +### Added + +- Add initial contents \ No newline at end of file