Node: Poll phase documentation

[LucaFranceschini]

• Version:
• Platform:
• Subsystem:

/doc/topics/event-loop-timers-and-nexttick.md
The documentation has been moved (https://github.com/nodejs/node/issues/10792):
https://github.com/nodejs/nodejs.org/blob/master/locale/en/docs/guides/event-loop-timers-and-nexttick.md

The description of the poll phase is not clear at all to me. Could someone please clarify the (sequence of the) operations in this phase?

Examples:

When the event loop enters the poll phase _and there are no timers scheduled_, one of two things will happen:

Well, what happens if _there are_ timers scheduled?

If scripts have not been scheduled by setImmediate(), the event loop will wait for callbacks to be added to the queue, then execute them immediately.

Until... what?

Once the poll queue is empty [...]

This could not even happen if we reached the system-dependent hard limit, right? Would this step be ignored in such cases?

[psypersky]

+1

[metalshan]

+1

[icelancer]

+1

[bnoordhuis]

Use upvotes please, don't +1. It sends an unnecessary email to several hundred people.

[sam-github]

@LucaFranceschini current location: https://github.com/nodejs/nodejs.org/blob/master/locale/en/docs/guides/event-loop-timers-and-nexttick.md

PR that moved it: https://github.com/nodejs/node/issues/10792

@nodejs/documentation Should this issue be reopened against https://github.com/nodejs/nodejs.org ?

[apapirovski]

@nodejs/documentation This could use some love. It is not exactly incorrect but certainly confusing and somewhat misleading.

[Himself65]

+1 and no one to reedit the docs?

[yuqingc]

https://github.com/nodejs/help/issues/1118