Make documentation standalone and generalize examples

docs/code/workers.md

@@ -38,11 +38,12 @@ export FLUKSIO_WORKER_TOKEN='<token from the engine>'
 fluksio-worker \
   --url wss://fluksio.example.com/api/v1/workers/attach \
   --labels gpu,cuda12 \
-  --python /opt/torch-venv/bin/python
+  --python /path/to/node-venv/bin/python
 ```
 
-Use your engine's hostname. `--python` selects the environment containing the
-node's dependencies, such as PyTorch or a device SDK. If you install the worker
+Replace the address and interpreter path with your own. `--python` selects
+the environment containing the node's dependencies, such as PyTorch or a
+device SDK. If you install the worker
 in that environment, you can omit the option. An engine installation also
 provides the same agent as `fluksio worker`.
 
@@ -55,7 +56,7 @@ provides the same agent as `fluksio worker`.
 | `--python` | worker's interpreter | Python used for node code |
 | `--parallel` | `1` | concurrent calls |
 | `--artifact-url` | derived from `--url` | artifact endpoint, if hosted separately |
-| `--service-host` | address the engine sees | host in a service's url, when the engine reaches this machine elsewhere, such as through a tunnel |
+| `--service-host` | address the engine sees | reachable hostname or IP for services, when the connection address is unsuitable |
 | `--cpus` | detected | advertised CPU count |
 | `--gpus` | detected | advertised GPU count; explicit `0` means none |
 | `--ram-mb` | detected | advertised memory in MB |
@@ -183,7 +184,7 @@ in `$DATA_DIR/provisioners.json`, replacing the example addresses and paths:
 [{
   "type": "slurm",
   "name": "hpc",
-  "login": "me@login.cluster",
+  "login": "user@login.cluster.example.com",
   "ssh_key": "/secrets/hpc_ed25519",
   "engine_url": "wss://fluksio.example.com/api/v1/workers/attach",
   "max_idle_s": 300,
@@ -195,7 +196,7 @@ in `$DATA_DIR/provisioners.json`, replacing the example addresses and paths:
     "ram_mb": 65536,
     "labels": ["gpu"],
     "sbatch": ["--partition=gpu", "--gres=gpu:1", "--time=04:00:00"],
-    "prerun": ["module load cuda/12", "source ~/venvs/fluksio/bin/activate"]
+    "prerun": ["module load cuda", "source /path/to/node-venv/bin/activate"]
   }]
 }]
 ```