From 9530dd72bcd6aa683e282f9527f97ddd01fb54a8 Mon Sep 17 00:00:00 2001 From: Austin Macdonald Date: Thu, 15 Feb 2024 10:52:07 -0500 Subject: [PATCH 1/2] Document how to release and add changelog entries Fixes #732 --- CONTRIBUTING.rst | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 772b17f3..d22f875f 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -51,11 +51,33 @@ If you are unsure what that means, here is a set-up workflow you may wish to fol git push -u origin topic_of_your_contribution - (If any of the above seems overwhelming, you can look up the `Git documentation `_ on the web.) +Releases and Changelog +---------------------- + +Heudiconv uses the `auto `_ tool to generate the changelog and automatically release the project. + +`auto` is used in the heudiconv github actions, which monitors the labels on the pull request. +Heudiconv automation can add entries to the changelog, cut releases, and +push new images to `dockerhub `_. + +The following pull request labels are respected: + + * major: Increment the major version when merged + * minot: Increment the minot version when merged + * patch: Increment the patch version when merged + * skip-release: Preserve the current version when merged + * release: Create a release when this pr is merged + * internal: Changes only affect the internal API + * documentation: Changes only affect the documentation + * tests: Add or improve existing tests + * dependencies: Update one or more dependencies version + * performance: Improve performance of an existing feature + + Development environment ----------------------- From 709b104a9e1f43145d468e5f10e475d72e7955f3 Mon Sep 17 00:00:00 2001 From: Yaroslav Halchenko Date: Thu, 15 Feb 2024 14:59:35 -0500 Subject: [PATCH 2/2] Consistent casing for HeuDiConv and GitHub project names --- CONTRIBUTING.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index d22f875f..850bae79 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -58,10 +58,10 @@ If you are unsure what that means, here is a set-up workflow you may wish to fol Releases and Changelog ---------------------- -Heudiconv uses the `auto `_ tool to generate the changelog and automatically release the project. +HeuDiConv uses the `auto `_ tool to generate the changelog and automatically release the project. -`auto` is used in the heudiconv github actions, which monitors the labels on the pull request. -Heudiconv automation can add entries to the changelog, cut releases, and +`auto` is used in the HeuDiConv GitHub actions, which monitors the labels on the pull request. +HeuDiConv automation can add entries to the changelog, cut releases, and push new images to `dockerhub `_. The following pull request labels are respected: