Skip to content

Latest commit

 

History

History
72 lines (54 loc) · 2.64 KB

DEVELOPMENT.md

File metadata and controls

72 lines (54 loc) · 2.64 KB

Developer guide to this crate

This crate follows the standard for developing a Rust library via cargo. The CI is our "ground truth" over the state of the library. Check out the different parts of the CI to understand how to test the different parts of this library locally.

Merging

We currently do not have maintaince versions and thus only PR and merge to main.

We use labels to build a changelog - it is very important to label issues and/or PRs accordingly. Because our changelog can contain both issues and PRs, when a PR closes an issue, we favor having the PR on the changelog, since it includes a reference to the author (credits).

Summary:

  • pull requests with both backward-incompatible changes and new features/enchancements MUST close at least one issue (the one documenting the backward-incompatible change)
  • Every other pull request MAY close one issue

issues are only used to document situations whose a single PR adds two entries to the changelog (e.g. a backward incompatible change + an new enchancement).

Merging a PR to main has the following checklist:

  1. Does it close an issue? If yes, add the label no-changelog to the issue.
  2. Label the PR accordingly (Testing, Documentation, Enchancement, Feature, Bug)
  3. If the PR is backward incompatible:
    1. create a new issue labeled backward-incompatible with what changed and how to migrate from the old API to the new API
    2. Edit the PR's description with Closes #...
  4. Adjust the PRs title with a description suitable for the changelog
    • In the past tense
    • backtick code names (e.g. MutableArray, not MutableArray)
    • place "(-X%)" or "(Yx)" at the end if it is a performance improvement
  5. Press merge (squash merge) and adjust any items added by github to your liking

This will reduce the burden of a release, where we go through every item from the changelog and adjust titles, labels, etc.