Skip to content

Commit a967da2

Browse files
committed
feat: add Userland Migrations Working Group section to upgrading page
1 parent cced532 commit a967da2

1 file changed

Lines changed: 18 additions & 0 deletions

File tree

apps/site/pages/en/about/upgrading-nodejs.mdx

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,24 @@ Take the first step and download the latest Node.js version.
4646
- **Dependency Incompatibility**: Critical libraries might not yet support the new Node.js version.
4747
- **Silent Failures**: Subtle behavior changes in the runtime can lead to difficult-to-debug issues.
4848

49+
## Open Source Migration Tools
50+
51+
The [Node.js Userland Migrations Working Group](https://github.com/nodejs/userland-migrations) is a community-driven initiative under the Node.js project focused on helping developers handle breaking changes gracefully. The working group maintains a collection of **codemods** — automated code transformations — that can upgrade your source code to adopt new features or adapt to breaking changes across major Node.js versions.
52+
53+
These codemods are published in the [Codemod Registry](https://registry.codemod.com) and can be run directly against your project:
54+
55+
```bash
56+
npx codemod @nodejs/<recipe>
57+
```
58+
59+
Key benefits of using the Userland Migrations codemods:
60+
61+
- **Automated refactoring**: Codemods handle repetitive, error-prone code changes across your entire codebase.
62+
- **Community maintained**: Recipes are built and reviewed by the Node.js community, ensuring they reflect real-world migration patterns.
63+
- **Incremental adoption**: Run individual recipes targeting specific breaking changes rather than attempting a full rewrite.
64+
65+
The working group welcomes contributions — whether you want to author new codemods, review existing ones, or help shape the migration strategy for the ecosystem. Check out the [repository](https://github.com/nodejs/userland-migrations) to get involved.
66+
4967
## Ecosystem Support Programs
5068

5169
The OpenJS Foundation has established an LTS Upgrade & Modernization framework to help organizations move safely off legacy and end-of-life (EOL) Node.js versions. As the nonprofit steward of Node.js, the Foundation defines the program standards, ensures alignment with the upstream project, and works with qualified service providers who deliver tools and technical support under this framework.

0 commit comments

Comments
 (0)