Define release process

[rubensworks]

Given this shared repo management, it would be good to discuss and write down a release process we are all happy with.

I know @ludovicm67 has some good ideas already. Could you share them?

[ludovicm67]

The release process that is configured right now is Changesets.

The process goes as it:

• someone is doing some changes in a feature branch, for example
• to add a release note entry, the developer just has to enter npx changeset add, and he would be prompted to select the kind of change between major, minor and patch, and then enter a description of the change
• once this gets pushed to the repo, and a PR open, a comment like that one is added to the PR to show the kind of release that it will trigger, and allows people to create some entries by hand by clicking the Click here if you're a maintainer who wants to add another changeset to this PR in case they didn't create an entry
• once this PR gets merged to the main branch, a dedicated GitHub workflow would be triggered, and will create a PR similar to that one, called "Merge to release"
• people could review that PR and decide to trigger the release; on that step, we could all agree that we should have at least X approvals to be able to release, for example
• once we merge that "Merge to release" PR, the workflow will automatically publish the package to NPM, create tags, generate a GitHub release, add a changelog entry, remove all changesets files

Even this requires a specific step (creating a changeset entry), this is more flexible than semantic-release that uses the commit messages. We can decide when to release precisely, we can configure multiple packages to be released at the same time at the same version (like here), …

Maybe @tpluscode could also complete this in case I forgot anything.

Resources:

• Changesets GitHub repo
• Some basic questions about Changesets

[rubensworks]

This sounds great to me. @tpluscode has setup a similar thing for https://github.com/rdfjs/types/, which works quite well in a collaborative repo.