pythonnative
diff --git a/‎api/cli/index.html‎
Lines changed: 10 additions & 3 deletions b/‎api/cli/index.html‎
Lines changed: 10 additions & 3 deletions
diff --git a/‎guides/testing/index.html‎
Lines changed: 35 additions & 0 deletions b/‎guides/testing/index.html‎
Lines changed: 35 additions & 0 deletions
diff --git a/‎search/search_index.json‎
Lines changed: 1 addition & 1 deletion b/‎search/search_index.json‎
Lines changed: 1 addition & 1 deletion
@@ -3648,7 +3648,9 @@ <h2 id="subcommands">Subcommands<a class="headerlink" href="#subcommands" title=
 <li><code>pn doctor [android|ios]</code>: diagnose the local toolchain and validate
   <code>pythonnative.toml</code>, including that a <code>python3.X</code> matching
   <code>[app].python_version</code> is available for package resolution. Exits
-  non-zero when something will block a build.</li>
+  non-zero when something will block a build. Flag: <code>--json</code> to print a
+  JSON array of check results to stdout for scripting; the verdict line
+  goes to stderr instead, and the exit status is unchanged.</li>
 <li><code>pn deps [android|ios]</code>: resolve <code>[requirements].packages</code> for every
   device target (iOS device, iOS Simulator, and each Android ABI)
   without installing anything, and report the wheel each package would
@@ -3707,7 +3709,8 @@ <h2 id="subcommands">Subcommands<a class="headerlink" href="#subcommands" title=
 <li><code>pn init [name]</code>: scaffold a new project (<code>pythonnative.toml</code> +
   <code>app/</code>) into <code>./name/</code>, or into the current directory when no name
   is given.</li>
-<li><code>pn doctor [platform]</code>: diagnose the local toolchain and config.</li>
+<li><code>pn doctor [platform]</code>: diagnose the local toolchain and config, as a
+  report or as JSON with <code>--json</code>.</li>
 <li><code>pn deps [platform]</code>: resolve <code>[requirements].packages</code> for every
   device target and report which wheels would be used (or why a package
   can't be installed), without building anything.</li>
@@ -4015,6 +4018,10 @@ <h2 id="pythonnative.cli.pn.doctor_command" class="doc doc-heading">
     <div class="doc doc-contents ">
 
         <p>Run toolchain/config diagnostics and exit non-zero on errors.</p>
+<p>With <code>--json</code>, stdout carries a JSON array and nothing else, one
+object per check (see <code>CheckResult.to_dict</code>), and the verdict line
+goes to stderr. The exit status stays keyed to the worst check level
+either way.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -4037,7 +4044,7 @@ <h2 id="pythonnative.cli.pn.doctor_command" class="doc doc-heading">
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Parsed namespace with optional <code>platform</code>.</p>
+                <p>Parsed namespace with optional <code>platform</code> and <code>json</code>.</p>
               </div>
             </td>
             <td>
 
@@ -1620,6 +1620,23 @@
     </span>
   </a>
 
+    <nav class="md-nav" aria-label="Going lower level">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#a-minimal-fake-backend" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        A minimal fake backend
+      
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
 
         <li class="md-nav__item">
@@ -3544,6 +3561,23 @@
     </span>
   </a>
 
+    <nav class="md-nav" aria-label="Going lower level">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#a-minimal-fake-backend" class="md-nav__link">
+    <span class="md-ellipsis">
+      
+        A minimal fake backend
+      
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
 
         <li class="md-nav__item">
@@ -3819,6 +3853,7 @@ <h2 id="testing-async-code">Testing async code<a class="headerlink" href="#testi
 <a class="autorefs autorefs-internal" title="&lt;code class=&quot;doc-symbol doc-symbol-heading doc-symbol-function&quot;&gt;&lt;/code&gt;            &lt;span class=&quot;doc doc-object-name doc-function-name&quot;&gt;run_blocking&lt;/span&gt;" href="../../api/runtime/#pythonnative.runtime.run_blocking"><code>pn.run_blocking(coro)</code></a> directly.
 See <a href="../async/#testing-async-code">Testing async code</a>.</p>
 <h2 id="going-lower-level">Going lower level<a class="headerlink" href="#going-lower-level" title="Permanent link">&para;</a></h2>
+<h3 id="a-minimal-fake-backend">A minimal fake backend<a class="headerlink" href="#a-minimal-fake-backend" title="Permanent link">&para;</a></h3>
 <p><code>render</code> is a thin layer over
 <a class="autorefs autorefs-internal" title="&lt;code class=&quot;doc-symbol doc-symbol-heading doc-symbol-class&quot;&gt;&lt;/code&gt;            &lt;span class=&quot;doc doc-object-name doc-class-name&quot;&gt;Reconciler&lt;/span&gt;" href="../../api/reconciler/#pythonnative.reconciler.core.Reconciler"><code>Reconciler</code></a> and
 <a class="autorefs autorefs-internal" title="&lt;code class=&quot;doc-symbol doc-symbol-heading doc-symbol-class&quot;&gt;&lt;/code&gt;            &lt;span class=&quot;doc doc-object-name doc-class-name&quot;&gt;FakeBackend&lt;/span&gt;" href="../../api/testing/#pythonnative.testing.FakeBackend"><code>FakeBackend</code></a>. Tests that need to