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

feat: next steps for version management progress #606

Merged
merged 6 commits into from
Aug 21, 2024
Merged
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/version-management/proposal-next-steps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
Proposal: Next steps

As part of achieving the second [goal](./goals.md):

> Install Node.js and a package manager for a local development environment.

And following up on the [proposal to revise the downloads page](./proposal-revise-downloads-page.md), we propose the following next steps:

1. We should revise the Node.js download page to split apart the operating system package managers (Homebrew and Chocolatey) onto their own tab separate from the Node.js version managers (nvm and fnm) and the version managers tab should remain the default. This will further nudge users toward our recommendation of installing Node.js in a version-managed way.

2. Also on the download page, we should add instructions for installing package managers which node has at any point historically supported (Yarn and `pnpm), plus any others to be determined by a new policy (yet to be proposed) to add and remove recommended package managers. These instructions should follow whatever recommendation we receive from those project's maintainers.
wesleytodd marked this conversation as resolved.
Show resolved Hide resolved

3. Corepack's documentation should be moved out of the Node.js API documentation and into its own website, or accessible as Markdown files in the Corepack repo. Corepack is a separate project from Node.js and intermingling its documentation within Node.js's is confusing; we don't do that for `npm` even though we distribute `npm`.
wesleytodd marked this conversation as resolved.
Show resolved Hide resolved

4. Once all of the above is complete, we should prepare the eventual removal of Corepack from the Node.js distribution by recommending alternative workflows. Users who wish to continue using Corepack will be recommended to do so via the instructions available on the Node.js download page or in Corepack's documentation.
wesleytodd marked this conversation as resolved.
Show resolved Hide resolved

5. Corepack governence and maintenence will be relinquished to the Corepack team who can decide on next steps for the project.
wesleytodd marked this conversation as resolved.
Show resolved Hide resolved