Skip to content

Commit

Permalink
update maintenance guide with recent news
Browse files Browse the repository at this point in the history
  • Loading branch information
Byron authored and jongiddy committed Aug 14, 2024
1 parent 01c3f03 commit af8bcdb
Showing 1 changed file with 11 additions and 4 deletions.
15 changes: 11 additions & 4 deletions MAINTENANCE.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
This document explains how to perform the project's maintenance tasks.

### Repository Configuration

Some repository settings, including branch protection and required approvals, are managed in the
[Rust team repo](https://github.com/rust-lang/team/blob/master/repos/rust-lang/flate2-rs.toml).
See the [repository schema](https://github.com/rust-lang/team/blob/aaa8039a2420a07cab9bbaca3885b3ad95a256a7/docs/toml-schema.md?plain=1#L248)
for supported directives.

### Creating a new release

#### Artifacts
Expand All @@ -11,11 +18,11 @@ This document explains how to perform the project's maintenance tasks.

To generate all the artifacts above, one proceeds as follows:

1. `git checkout -b release-<next-version>` - move to a branch to prepare making changes to the repository. *Changes cannot be made to `main` as it is protected.*
2. Edit `Cargo.toml` to the next package version.
3. `gh pr create` to create a new PR for the current branch and **get it merged**.
1. `git checkout -b release-<next-version>` - create a branch to make changes to the repository. *Changes cannot be made to `main` as it is protected.*
2. Edit `Cargo.toml` to update the package version to `<next-version>`.
3. Create a new PR for the branch (e.g. using `gh pr create`) and **get it approved and merged**.
4. Pull the `main` branch and ensure that you are at the merged commit.
4. `cargo publish` to create a new release on `crates.io`.
5. `git tag <next-version>` to remember the commit.
6. `git push --tags` to push the new tag.
7. Go to the newly created release page on GitHub and edit it by pressing the "Generate Release Notes" and the `@` button. Save the release.

0 comments on commit af8bcdb

Please sign in to comment.