You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
We currently have two guides talking about how Node.js events work. It's really important to have these guides explaining the event loop and how node runs - they both would benefit from a big update for example the event loop guide starts with:
The event loop is what allows Node.js to perform non-blocking I/O operations — despite the fact that JavaScript is single-threaded — by offloading operations to the system kernel whenever possible.
JavaScript is not single threaded and it does not explain what non-blocking I/O does.
I think it's important to explain the user facing consequences of the timing of things in Node - for example from a user's point of view it is a lot more important to learn that microtasks (like nextTick/queueMicrotask and promises) get scheduled ahead of I/O all the time and it's possible to starve I/O with it.
Since these guides are so important it would be awesome if the foundation could even pay a technical writer to talk to some project people and review it.
The text was updated successfully, but these errors were encountered:
Since these guides are so important it would be awesome if the foundation could even pay a technical writer to talk to some project people and review it.
That would get the info updated and it might not be a bad way to go. But it will be a one-time event and the two guides will go back to not being maintained at all, like all of our guides.
With the guides, I'm generally an advocate for a two step process:
Find the essential Node.js-specific material in there (emphasis on essential and not merely Node.js-specific) and make sure that material is represented in the appropriate places in our API docs.
Find reliable external sources that provide the other information and replace the guides with links to those sources.
Hey,
We currently have two guides talking about how Node.js events work. It's really important to have these guides explaining the event loop and how node runs - they both would benefit from a big update for example the event loop guide starts with:
JavaScript is not single threaded and it does not explain what non-blocking I/O does.
I think it's important to explain the user facing consequences of the timing of things in Node - for example from a user's point of view it is a lot more important to learn that microtasks (like nextTick/queueMicrotask and promises) get scheduled ahead of I/O all the time and it's possible to starve I/O with it.
Since these guides are so important it would be awesome if the foundation could even pay a technical writer to talk to some project people and review it.
The text was updated successfully, but these errors were encountered: