docs: keep subprocess snippets lintable

Author: AndreKalberer

docs/run/index.md

@@ -47,13 +47,20 @@ reader. If your tool starts a subprocess and you do not intend to feed it input,
 redirect the child's stdin:
 
 ```python
-process = await asyncio.create_subprocess_exec(
-    sys.executable,
-    "script.py",
-    stdin=subprocess.DEVNULL,
-    stdout=subprocess.PIPE,
-    stderr=subprocess.PIPE,
-)
+import asyncio
+import subprocess
+import sys
+
+
+async def run_script() -> tuple[bytes, bytes]:
+    process = await asyncio.create_subprocess_exec(
+        sys.executable,
+        "script.py",
+        stdin=subprocess.DEVNULL,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+    return await process.communicate()
 ```
 
 The matching troubleshooting entry is **[My stdio tool hangs when it starts a subprocess on Windows](../troubleshooting.md#my-stdio-tool-hangs-when-it-starts-a-subprocess-on-windows)**.

docs/troubleshooting.md

@@ -156,13 +156,20 @@ same pipe.
 If you do not intend to send input to the child, redirect its stdin:
 
 ```python
-process = await asyncio.create_subprocess_exec(
-    sys.executable,
-    "script.py",
-    stdin=subprocess.DEVNULL,
-    stdout=subprocess.PIPE,
-    stderr=subprocess.PIPE,
-)
+import asyncio
+import subprocess
+import sys
+
+
+async def run_script() -> tuple[bytes, bytes]:
+    process = await asyncio.create_subprocess_exec(
+        sys.executable,
+        "script.py",
+        stdin=subprocess.DEVNULL,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+    )
+    return await process.communicate()
 ```
 
 Use the same idea with `subprocess.Popen(..., stdin=subprocess.DEVNULL)`. Also