Skip to content

Commit

Permalink
feat: next steps for version management progress (#606)
Browse files Browse the repository at this point in the history
* feat: next steps for version management progress

* fix: amendments to next steps in version management proposal

* Update docs/version-management/proposal-next-steps.md

Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com>

* Update docs/version-management/proposal-next-steps.md

Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com>

* Update docs/version-management/proposal-next-steps.md

Co-authored-by: Stephen Wade <stephen@stephenwade.me>

* Update docs/version-management/proposal-next-steps.md

Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com>

---------

Co-authored-by: Antoine du Hamel <duhamelantoine1995@gmail.com>
Co-authored-by: Stephen Wade <stephen@stephenwade.me>
  • Loading branch information
3 people authored Aug 21, 2024
1 parent 51ea6ff commit af94d21
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions docs/version-management/proposal-next-steps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
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 projects' maintainers.

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` and intermingling its documentation within `node`'s is confusing; we don't do that for `npm` even though we distribute `npm`.

4. Once all of the above is complete, we should start recommending alternative workflows in case Corepack is removed from the Node.js distribution. 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.

0 comments on commit af94d21

Please sign in to comment.