Document how to terminate hanging subprocesses

docs/termination.md

@@ -124,6 +124,8 @@ If the subprocess is still alive after 5 seconds, it is forcefully terminated wi
 
 ## Timeout
 
+### Execution timeout
+
 If the subprocess lasts longer than the [`timeout`](api.md#optionstimeout) option, a [`SIGTERM` signal](#default-signal) is sent to it.
 
 ```js
@@ -138,6 +140,36 @@ try {
 }
 ```
 
+### Inactivity timeout
+
+To terminate a subprocess when it becomes inactive, the [`cancelSignal`](#canceling) option can be combined with some [debouncing logic](https://github.com/sindresorhus/debounce-fn). The following example terminates the subprocess if it has not printed to [`stdout`](api.md#resultstdout)/[`stderr`](api.md#resultstderr) in the last minute.
+
+```js
+import {execa} from 'execa';
+import debounceFn from 'debounce-fn';
+
+// 1 minute
+const wait = 60_000;
+const controller = new AbortController();
+const cancelSignal = controller.signal;
+const abort = debounceFn(controller.abort.bind(controller), {wait});
+const onOutput = {
+	* transform(data) {
+		abort();
+		yield data;
+	},
+	binary: true,
+};
+
+abort();
+await execa({
+	cancelSignal,
+	stdout: onOutput,
+	stderr: onOutput,
+})`npm run build`;
+
+```
+
 ## Current process exit
 
 If the current process exits, the subprocess is automatically [terminated](#default-signal) unless either: