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

📌 Mocha 11 Release Plan #5249

Open
1 of 3 tasks
JoshuaKGoldberg opened this issue Nov 11, 2024 · 4 comments
Open
1 of 3 tasks

📌 Mocha 11 Release Plan #5249

JoshuaKGoldberg opened this issue Nov 11, 2024 · 4 comments
Assignees
Labels
type: discussion debates, philosophy, navel-gazing, etc.
Milestone

Comments

@JoshuaKGoldberg
Copy link
Member

JoshuaKGoldberg commented Nov 11, 2024

We're working on a new major version of Mocha! 📦

Mocha 11 will be the first new major version of Mocha in 3 years. It will contain no new bug fixes or features compared to v10. The only user-facing changes in Mocha 11 will be:

Our plan is to:

  • Monday, November 11th: release a "pre-release" version of Mocha 11 today to npm (not as stable)
  • Wait a few business days to merge the two PRs, then >=1 business day after
  • Release Mocha 11 as stable on npm

As mentioned in #5027, we're a new volunteer maintenance team and want to tread carefully with breaking changes to Mocha. We're holding off an adding any additional breaking changes until the next major version, Mocha 12, which we will not release until some time in 2025 at the earliest. We'll first learn see how the Mocha 11 release goes and learn from it. As careful as we are planning on being with Mocha 11, there is always some risk with publishing a new major version of a project. Mocha is depended upon by thousands upon thousands of consuming projects, many of which are not open source or built in ways we're familiar with as a team.

Alternating major versions between ones that purely raise engine targets and ones that add breaking feature changes is a strategy used by some other ecosystem projects, such as typescript-eslint.

👉 In the meantime, we're also working on a new docs site at https://mocha-docs-next.netlify.app.

@JoshuaKGoldberg JoshuaKGoldberg added the type: discussion debates, philosophy, navel-gazing, etc. label Nov 11, 2024
@JoshuaKGoldberg JoshuaKGoldberg added this to the v11.0.0 milestone Nov 11, 2024
@JoshuaKGoldberg JoshuaKGoldberg self-assigned this Nov 11, 2024
@JoshuaKGoldberg JoshuaKGoldberg pinned this issue Nov 11, 2024
@mark-wiemer

This comment has been minimized.

@JoshuaKGoldberg

This comment has been minimized.

@jftanner
Copy link

Wait a few business days to merge the two PRs

How're you feeling about merging #5148? It'd be nice to be able to kick the tires on mocha@next for a few days before a lot of US folk are away for the Thanksgiving week.

@JoshuaKGoldberg
Copy link
Member Author

JoshuaKGoldberg commented Nov 23, 2024

Feeling very good about it 😄. Merged!

[email protected] is now published on npm under the mocha@next tag.

You raise a good point about Thanksgiving. I'm personally going to be out of commission for something like half the week. 🦃

My tentative plan (not run by @Uzlopak or @voxpelli, cc for input) is to release Mocha@11 as stable on Monday, December 2nd.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: discussion debates, philosophy, navel-gazing, etc.
Projects
None yet
Development

No branches or pull requests

3 participants