nodejs / nodejs/nodejs.org

Provide WSL guidance on download page

オープン
#7,651 コメント 14 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

主要言語
TypeScript
スター
6.9k
フォーク
6.5k
平均マージ
2日 8時間
マージ済み PR(30日)
29

説明

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.

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

ダウンロードページから始め、Windows と Linux のオプションがどのように提示されているかを確認します。Windows ユーザー向けの選択肢として WSL をどのように説明するかを決め、それらのユーザーを Linux のインストール手順に案内します。ページが WSL の予備知識を前提とせず、両方の点を明確にカバーしていれば完了です。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
linux
領域
documentation
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
35/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。