Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Release Notes Workflow #1055

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

alemohamad
Copy link
Member

Proposal: Automated Workflow for Fetching Vapor Repositories and Managing Release Notes

This Pull Request introduces an automated action workflow using the pozetroninc/github-action-get-latest-release tool. The workflow will:

  1. Fetch the latest releases from the Vapor repositories.
  2. Populate a predefined release notes template with the release information.
  3. Copy the completed release notes to the Release Notes page located within the docs folder of the project.

Additional Consideration:

Since the release notes for all Vapor repositories are written in English, I propose that the Release Notes page should remain in English and not be translated into other languages. This avoids having outdated translations, as the automated workflow only updates the main English page.

@alemohamad alemohamad added help wanted Contributor help wanted! github_actions Pull requests that update GitHub Actions code labels Jan 17, 2025
@alemohamad alemohamad self-assigned this Jan 17, 2025
@alemohamad alemohamad requested review from a team, 0xTim and gwynne as code owners January 17, 2025 13:44
@alemohamad alemohamad force-pushed the update-release-notes-workflow branch from 1e108bb to d42ceb9 Compare January 22, 2025 12:51
Copy link
Member

@0xTim 0xTim left a comment

Choose a reason for hiding this comment

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

Ok so I think the underlying method is fine, I think we're going to trip ourselves up pretty quick with the implementations. So essentially, if we commit the release notes with the data in to Git that's going to get pretty messy, pretty quick.

What I suggest we do is generate the release notes as part of the main deployment pipeline and never commit them. That way the site will be up to date and Git will just store the template. We can still run the cron job to update the docs daily but I think this gives us the best of both worlds


---

## [fluent-mongo-driver](https://github.com/vapor/fluent-mongo-driver)
Copy link
Member

Choose a reason for hiding this comment

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

Let's remove this - we shouldn't be encouraging people to be using Fluent with Mongo


---

## [core](https://github.com/vapor/core)
Copy link
Member

Choose a reason for hiding this comment

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

This is long dead!

---

## [api-docs](https://github.com/vapor/api-docs)
[**{{API_DOCS_RELEASE}}**](https://github.com/vapor/api-docs/releases/tag/{{API_DOCS_ID}})
Copy link
Member

Choose a reason for hiding this comment

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

We don't tag releases so can remove this I think

schedule:
# - cron: '0 0 * * *' # Daily at Midnight
# - cron: '0 0 * * 0' # Weekly every Sunday at Midnight
- cron: '0 0 */14 * 0' # Every two weeks on Sunday at Midnight
Copy link
Member

Choose a reason for hiding this comment

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

I'd be happy with daily if it's not too noisy

on:
schedule:
# - cron: '0 0 * * *' # Daily at Midnight
# - cron: '0 0 * * 0' # Weekly every Sunday at Midnight
Copy link
Member

Choose a reason for hiding this comment

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

Remove the ones we're not using

git config --global user.email 'actions@github.com'
git add docs/release-notes.md
git commit -m 'Update Vapor Release Notes'
git push
Copy link
Member

Choose a reason for hiding this comment

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

Given a commit to main deploys anyway, do we need this trigger below?

Copy link
Member

Choose a reason for hiding this comment

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

My one concern here is that new deployments will wipe out the release notes. This is also going to get overwritten almost straight away and then just committed. Will put this is the main body

@alemohamad
Copy link
Member Author

@0xTim I'll review the changes and let you know.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
github_actions Pull requests that update GitHub Actions code help wanted Contributor help wanted!
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants