Skip to content

Conversation

@cdils
Copy link
Contributor

@cdils cdils commented Dec 9, 2025

This PR adds RELEASE.md, which documents the full maintainer release workflow for FAIR Connect.

The guide provides step-by-step instructions for running release-related workflows, reviewing and merging automated PRs, updating POT files, creating GitHub releases, and performing optional milestone cleanup.

The goal is to ensure a consistent, repeatable release process and to make onboarding easier for future maintainers.

Included in this PR

  • New RELEASE.md file
  • Full documentation of the version bump workflow
  • Instructions for reviewing and merging automated PRs
  • Guidance for generating and publishing GitHub releases
  • Optional milestone cleanup procedures

Additional improvements that may be added before merging

  • Confirm Generate POT workflow (👀 @afragen, @costdev)
  • Insert screenshots into the RELEASE.md document to supplement written steps.

Future enhancements (out of scope for this PR)

  • Add documentation describing the GitHub workflows and automations that power the release process.

Fixes #354

@github-actions
Copy link
Contributor

github-actions bot commented Dec 9, 2025

Copy link
Member

@costdev costdev left a comment

Choose a reason for hiding this comment

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

Nice @cdils ! I've left some notes below.

RELEASE.MD Outdated
1. From the repository’s main page, click the **Releases** link — or go directly to the [Releases page](https://github.com/fairpm/fair-plugin/releases).
2. Click the **Draft a new release** button.
3. In the **Select tag** field:
- select the tag that matches the version you just released (e.g., `1.2.0`).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- select the tag that matches the version you just released (e.g., `1.2.0`).
- Select the tag that matches the version you just bumped to (e.g., `1.2.0`).

@cdils cdils added the documentation Improvements or additions to documentation label Dec 21, 2025
@cdils cdils added this to the Plugin Adjacent milestone Dec 21, 2025
Signed-off-by: Carrie Dils <carriedils@gmail.com>
- Removes mention of POT file since this is now automated
- Make milestone verification a prerequisite for releases

Signed-off-by: Carrie Dils <carriedils@gmail.com>
@cdils cdils force-pushed the issue-354/release-docs branch from 48f77dc to dd1f664 Compare December 21, 2025 17:24
@cdils cdils requested a review from costdev December 21, 2025 17:27
@cdils cdils marked this pull request as ready for review December 22, 2025 18:36
…release

Signed-off-by: Carrie Dils <carriedils@gmail.com>
Copy link
Member

@joedolson joedolson left a comment

Choose a reason for hiding this comment

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

I mean, just one little change.

Signed-off-by: Carrie Dils <carriedils@gmail.com>
Copy link
Member

@joedolson joedolson left a comment

Choose a reason for hiding this comment

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

LGTM!

@joedolson joedolson merged commit 6cbe325 into main Dec 22, 2025
59 checks passed
@joedolson joedolson deleted the issue-354/release-docs branch December 22, 2025 18:57
@joedolson joedolson mentioned this pull request Dec 22, 2025
6 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add RELEASE.md documenting the FAIR Connect release process

4 participants