diff --git a/doc/api/cluster.md b/doc/api/cluster.md index d34b1bb795c363..5dfd8116dc5de0 100644 --- a/doc/api/cluster.md +++ b/doc/api/cluster.md @@ -6,9 +6,10 @@ -A single instance of Node.js runs in a single thread. To take advantage of -multi-core systems, the user will sometimes want to launch a cluster of Node.js -processes to handle the load. +Clusters of Node.js processes can be used to run multiple instances of Node.js +that can distribute workloads among their application threads. When process +isolation is not needed, use the [`worker_threads`][] module instead, which +allows running multiple application threads within a single Node.js instance. The cluster module allows easy creation of child processes that all share server ports. @@ -1121,3 +1122,4 @@ socket.on('data', (id) => { [`process` event: `'message'`]: process.md#event-message [`server.close()`]: net.md#event-close [`worker.exitedAfterDisconnect`]: #workerexitedafterdisconnect +[`worker_threads`]: worker_threads.md