Poll phase documentation

[LucaFranceschini]

• Version:
• Platform:
• Subsystem:

/doc/topics/event-loop-timers-and-nexttick.md
The documentation has been moved (#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: #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]

nodejs/help#1118

[BridgeAR]

I am going to close this since there was no interaction since 2020. I believe the docs could definitely be improved, it just has to be done by 'someone'. It is therefore always appreciated to receive such PR. Please reopen, if someone disagrees.