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,27 @@ try {
 }
 ```
 
+### Inactivity timeout
+
+To terminate a subprocess when it is hanging, 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;
+const controller = new AbortController();
+const cancelSignal = controller.signal;
+const abort = debounceFn(controller.abort.bind(controller), {wait});
+
+const subprocess = execa({cancelSignal})`npm run build`;
+abort();
+subprocess.stdout.on('data', abort);
+subprocess.stderr.on('data', abort);
+await subprocess;
+```
+
 ## Current process exit
 
 If the current process exits, the subprocess is automatically [terminated](#default-signal) unless either: