From 38b6aeba6812c9df74867f54d98085f9ae4d8c48 Mon Sep 17 00:00:00 2001
From: Thales Maciel <thales@thalesmaciel.com>
Date: Mon, 9 Mar 2026 21:00:37 -0300
Subject: [PATCH] Align doctor docs with CLI output

---
 docs/host-requirements.md | 14 +++++++++++++-
 docs/troubleshooting.md   |  3 ++-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/docs/host-requirements.md b/docs/host-requirements.md
index 81d0754..132d74e 100644
--- a/docs/host-requirements.md
+++ b/docs/host-requirements.md
@@ -25,7 +25,19 @@ The current implementation uses `sudo -n` for host networking commands when a ne
 pyro doctor
 ```
 
-Check these fields in the output:
+In the default human-readable output, check:
+
+- `Runtime: PASS`
+- `KVM: exists=yes readable=yes writable=yes`
+- `Networking: tun=yes ip_forward=yes`
+
+If you need the raw structured fields instead:
+
+```bash
+pyro doctor --json
+```
+
+Check:
 
 - `runtime_ok`
 - `kvm`
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index dc5ac3f..a8225bd 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -68,7 +68,8 @@ Cause:
 Fix:
 
 - reinstall the package
-- verify `pyro doctor` reports `runtime_ok: true`
+- verify `pyro doctor` reports `Runtime: PASS`
+- or run `pyro doctor --json` and verify `runtime_ok: true`
 - if you are working from a source checkout, ensure large runtime artifacts are present with `git lfs pull`
 
 ## Ollama demo exits with tool-call failures