nodejs / node

Node.js JavaScript runtime ✨🐢🚀✨
https://nodejs.org
Other
108.04k stars 29.82k forks source link

doc: troubleshooting FAQ? #21663

Open vsemozhetbyt opened 6 years ago

vsemozhetbyt commented 6 years ago

We have some frequently emerged issues mostly concerned Node.js installation. Just two classic examples:

  1. Windows issue with antivirus and "Performance counters" / "Event tracing" options: https://github.com/nodejs/node/issues/20538

  2. Global npm installation issue: https://github.com/nodejs/node/issues/21661

Should we create some troubleshooting FAQ doc and link to it from the main nodejs/node GitHub page and from the nodejs.org site?

vsemozhetbyt commented 6 years ago

Some other candidates:

  1. Memory issues and --max_old_space_size option.
  2. Intl issues (including Date etc) and small-icu default.
Trott commented 6 years ago

@nodejs/documentation

Trott commented 6 years ago

@nodejs/website

Trott commented 6 years ago

A third/fourth place to link to it might be the README and/or issue template in the help repo.

fhemberger commented 6 years ago

Regarding the issue template: The only issue is that you can't use Markdown directly. So you have to add the link to the FAQ as plain text to either the issue template description or body text.

RedYetiDev commented 7 months ago

Hi! It's been a few years since this issue was created. This comment will bump to the forefront of the issues list. If someone wants to implement this, they will likely see this. Otherwise, this issue can be closed if desired.

This is an effort to resolve older issues.