Provide WSL guidance on download page
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 35/100
- Issue type
- Documentation
- Clarity
- Needs clarification
- Activity status
- Stale
- Tech stack
- linux
- Domain
- documentation
Research direction
Start at the download page and review how the Windows and Linux options are presented. Decide how to explain WSL as an option for Windows users and direct those users to the Linux installation guidance; done means the page clearly covers both points without assuming prior WSL knowledge.
Written by the indexing model from the issue text.
Description
Moving a convo out of #7650.
@ljharb (in PR Review):
it'd be nice to have a "WSL" option somehow prominent, so that windows users who have WSL can choose nvm, devbox, etc, but atm this seems good
@MattIPv4 (in Issue Comment):
We should move this discussion to an issue, but yeh, either we should update "Linux" to be "Linux (+ WSL)" or add a dedicated "WSL" option in the dropdown. Or, we could display a banner whenever Windows is selected noting that if the user is using WSL, they should refer to the Linux options.
@avivkeller (in Issue Comment):
It's in the name, Windows Subsystem for Linux. IMHO users should be expected to know that if they WSL, they can refer to the Linux instructions
@MattIPv4 (in Issue Comment):
The whole point of this page is to not make assumptions, this page is for beginners that're new to Node.js (and often development generally). They may have heard that WSL is the thing to use for Windows dev, and not know anything beyond that.
@ljharb (in Issue Comment):
Yes, but windows users who are not using or aware of WSL won't know that WSL even exists as an option in the first place such that they could use the things listed under Linux.
Not sure quite what the perfect solution is, but we should have a way to educate Windows users about WSL -- both that it is an option to them alongside conventional Windows development using Powershell, and also that if they do want to use WSL they should follow the Linux install options that we provide.
- Dominant language
- TypeScript
- Stars
- 6.9k
- Forks
- 6.5k
- Avg merge
- 2d 9h
- Merged PRs (30d)
- 29
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from nodejs/nodejs.org
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
nodejs/nodejs.org#9162 · 1 comment ·
-
web-agenda
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
nodejs/nodejs.org#9098 · 3 comments · 1 reaction ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
nodejs/nodejs.org#8828 · 4 comments ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 55/100
nodejs/nodejs.org#9166 · 3 comments · 1 reaction ·
-
Difficulty 3/5 1-2 days Newbie friendliness 68/100
nodejs/nodejs.org#9140 · 10 comments · 3 reactions ·
All issues in nodejs/nodejs.org
Similar issues
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
dennys-bd/agent-hive#184 ·
-
Add: hunch Open
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
AbdelStark/awesome-typesafe#104 ·
-
ai-observability bug team/ai-observability
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
vicharanashala/fln#563 ·