node/doc/api
Rod Vagg ad670fa1c7 doc: remove "idiomatic choice" from queueMicrotask
It can't be idiomatic if it's not in general use and therefore hasn't
been picked up by users. It's not even in browsers yet.

"Idiomatic" use is an emergent property that comes from observed use
and this feature is so new (to browsers and Node) that it can't
possibly be. In general I don't think it's the place of the Node API
docs to observe what emerges as idiomatic Node.js.

It also can't be a recommended feature (if that was the intent of the
language) because it's marked experimental. For now, it's just a
feature, nothing more. Recommendations and/or observations about it
being 'idiomatic' can come later.

PR-URL: https://github.com/nodejs/node/pull/23885
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Tiancheng "Timothy" Gu <timothygu99@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Yuta Hiroto <hello@hiroppy.me>
Reviewed-By: Matheus Marchini <mat@mmarchini.me>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
2018-10-31 07:38:30 +11:00
..
addons.md test: fix compiler warning in doc/api/addons.md 2018-10-11 05:18:11 +02:00
assert.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
async_hooks.md async_hooks: remove promise object from resource 2018-10-15 19:40:51 +01:00
buffer.md 2018-10-23, Version 11.0.0 (Current) 2018-10-23 11:03:02 -07:00
child_process.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
cli.md doc: NODE_EXTRA_CA_CERTS is ignored if setuid root 2018-10-24 12:24:23 +02:00
cluster.md doc: make example more clarified in cluster.md 2018-10-28 22:26:09 -07:00
console.md 2018-07-18, Version 10.7.0 (Current) 2018-07-18 20:17:23 +02:00
crypto.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
debugger.md inspector: use js_app.html as the landing page for chrome devtools 2018-06-28 09:24:02 -03:00
deprecations.md doc: update missing deprecation 2018-10-27 09:02:10 -04:00
dgram.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
dns.md doc: add missing metadata for dns.lookup 2018-09-19 21:11:51 +02:00
documentation.md doc: make Stability Index more concise 2018-08-30 20:15:40 +01:00
domain.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
errors.md doc: document HPE_HEADER_OVERFLOW error 2018-10-30 11:16:21 -07:00
esm.md esm: provide named exports for builtin libs 2018-05-11 12:06:18 -05:00
events.md doc: add note about removeListener order 2018-10-23 13:12:03 -07:00
fs.md fs: default open/openSync flags argument to 'r' 2018-10-26 06:35:21 -07:00
globals.md doc: remove "idiomatic choice" from queueMicrotask 2018-10-31 07:38:30 +11:00
http2.md 2018-10-10, Version 10.12.0 (Current) 2018-10-10 23:18:55 +02:00
http.md doc: add documentation for http.IncomingMessage$complete 2018-10-30 08:47:31 -07:00
https.md doc: improve metadata for http.request 2018-09-19 21:12:45 +02:00
index.md doc: remove mailing list 2018-10-29 20:49:59 -07:00
inspector.md doc: fix structure and formatting in inspector.md 2018-07-08 21:56:10 +03:00
intl.md doc: bump ICU version to avoid confusion 2018-08-14 22:44:58 +03:00
modules.md doc: add review suggestions to require() 2018-10-23 21:01:14 -07:00
n-api.md benchmark,doc,lib,src,test,tools: fix typos 2018-10-09 16:53:12 +03:00
net.md doc: add optional callback to socket.end() 2018-10-29 07:44:57 +02:00
os.md doc, win: improve os.setPriority documentation 2018-09-19 08:02:18 +02:00
path.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
perf_hooks.md perf_hooks: remove less useful bootstrap marks 2018-06-15 09:05:19 -07:00
process.md timers: run nextTicks after each immediate and timer 2018-10-17 20:38:07 -07:00
punycode.md doc: prevent some redirections 2018-07-14 22:57:03 +03:00
querystring.md doc: remove redundant 'Example:' and similar notes 2018-08-29 16:53:03 +03:00
readline.md lib: add escapeCodeTimeout as an option to createInterface 2018-10-25 15:19:02 -07:00
repl.md doc: fix pr-url in repl.md 2018-10-15 05:51:28 +02:00
stream.md stream: add auto-destroy mode 2018-10-30 15:17:40 +01:00
string_decoder.md string_decoder: support typed array or data view 2018-09-17 17:48:44 +02:00
synopsis.md doc: match program and console output in synopsis.md 2018-09-22 00:49:25 +03:00
timers.md 2018-10-23, Version 11.0.0 (Current) 2018-10-23 11:03:02 -07:00
tls.md 2018-10-23, Version 11.0.0 (Current) 2018-10-23 11:03:02 -07:00
tracing.md trace_events: forbid tracing modifications from worker threads 2018-10-24 11:20:35 -03:00
tty.md tty: document WriteStream.cursorTo() and others 2018-10-06 01:36:03 +03:00
url.md 2018-10-23, Version 11.0.0 (Current) 2018-10-23 11:03:02 -07:00
util.md 2018-10-23, Version 11.0.0 (Current) 2018-10-23 11:03:02 -07:00
v8.md doc: update a link in v8.md 2018-09-03 17:47:28 +03:00
vm.md doc: remove notice of dashes in V8 options 2018-10-29 21:24:08 +00:00
worker_threads.md trace_events: forbid tracing modifications from worker threads 2018-10-24 11:20:35 -03:00
zlib.md doc: unify optional arguments format in headings 2018-08-19 21:45:39 +03:00