docs: Document the Event Loop as it Relates to Node

[DavidTPate]

This came up in the roadmap with #70 and I volunteered to get some content put together. I've done some local presentations on it for the JS folks in my town. I really enjoyed a talk by Philip Roberts @ JSConf EU 2014 something like that could be made more Node-centric and distilled into some GIFs for a presentation to help illustrate it.

[jrit]

I see this issue listed on the docs quarterly roadmap along with an overview of "blocking vs non-blocking" and was wondering how you plan to cover this topic without involving the other, and how one would talk about blocking without getting into how the event loop works? I ask just for the sake of planning the topics, I was considering trying to help out on the blocking topic.

[techjeffharris]

I started work on this about a week ago and would greatly appreciate feedback!

nodejs/node#4936

[techjeffharris]

@jrit I'm imagining the "Introduction to Node.js" document introducing the concept of blocking vs non-blocking breifly (and pointing to the topic/guide for that) just before also briefly describing the event loop (and pointing to the topic for that). But that's just off the top of my head.

The trick I think is establishing a progressive hierarchy of documents: at the foundation we have the documents for those totally new to node which introduce but skim over many of the core concepts while providing inline links to documents of further detail.

Also, FYI - Just pushed updates to nodejs/node#4936

[DavidTPate]

@techjeffharris That definitely sounds good, establishing a hierarchy of documents to progressively explain more I think would be the best. I'll take a look at your PR and provide any feedback I can.

[Trott]

Closing as this repository is dormant and likely to be archived soon. If this is still an issue, feel free to open it as an issue on the main node repository.