Document enroll 'validate'

src/content/_index.html

@@ -88,6 +88,13 @@ og_type: "website"
               <div class="text-muted">Analyze what's included/excluded in the harvest and why.</div>
             </div>
           </div>
+          <div class="d-flex gap-3">
+            <div class="icon-pill"><i class="bi bi-check-square"></i></div>
+            <div>
+              <div class="fw-semibold">Validate</div>
+              <div class="text-muted">Confirm that a harvest isn't corrupt or lacking artifacts.</div>
+            </div>
+          </div>	  
         </div>
       </div>
       <div class="col-lg-7">
@@ -155,6 +162,7 @@ og_type: "website"
       <li class="nav-item" role="presentation"><button class="nav-link" id="qs3-tab" data-bs-toggle="tab" data-bs-target="#qs3" type="button" role="tab">Multi-site</button></li>
       <li class="nav-item" role="presentation"><button class="nav-link" id="qs4-tab" data-bs-toggle="tab" data-bs-target="#qs4" type="button" role="tab">Diff</button></li>
       <li class="nav-item" role="presentation"><button class="nav-link" id="qs5-tab" data-bs-toggle="tab" data-bs-target="#qs5" type="button" role="tab">Explain</button></li>
+      <li class="nav-item" role="presentation"><button class="nav-link" id="qs6-tab" data-bs-toggle="tab" data-bs-target="#qs6" type="button" role="tab">Validate</button></li>
     </ul>
 
     <div class="tab-content mt-3">
@@ -249,6 +257,18 @@ enroll explain /path/to/harvest.sops \
         </div>
        <div class="smallprint mt-3">'explain' tells you why something was included, but also why something was <em>excluded</em>.</div>
       </div>
+      <div class="tab-pane fade" id="qs6" role="tabpanel" aria-labelledby="qs6-tab">
+        <div class="codeblock">
+          <button class="btn btn-sm btn-outline-secondary copy-btn" data-copy-target="#qs6code"><i class="bi bi-clipboard"></i> Copy</button>
+          <pre class="terminal mb-0"><code id="qs5code"># Validate a harvest is correct.
+enroll validate /path/to/harvest
+
+# Check against the latest published version of the state schema specification
+enroll validate /path/to/harvest --schema https://enroll.sh/schema/state.schema.json
+</code></pre>
+        </div>
+	<div class="smallprint mt-3">'validate' makes sure the harvest's state confirms to Enroll's <a href="/schema.html">state schema</a>, doesn't contain orphaned artifacts and isn't missing any artifacts needed by the state. By default, it checks against the schema packaged with Enroll, but you can also check against the latest version on this site.</div>
+      </div>      
     </div>
   </div>
 </section>

src/content/docs.html

@@ -124,6 +124,7 @@ description: "How Enroll works: harvest, manifest, modes, and configuration."
         <section id="schema" class="scroll-mt-nav mb-5">
           <h2 class="section-title fw-bold">State schema</h2>
           <p class="text-secondary">Enroll writes a <code>state.json</code> file describing what was harvested. The canonical definition of that file format is the JSON Schema below.</p>
+	  <p class="text secondary">You can also validate a harvest state file against the schema by using <code>enroll validate /path/to/harvest</code>.</p>
 
           <div class="callout p-4">
             <div class="d-flex flex-wrap gap-2 align-items-center">