Doc updates

src/docs.html

@@ -72,7 +72,7 @@
           </div>
           <div class="mt-3 small text-secondary">
             Prefer the canonical docs?
-            <a class="link-secondary" href="https://git.mig5.net/mig5/enroll" target="_blank" rel="noreferrer">README on Forgejo</a>.
+            <a class="link-secondary" href="https://git.mig5.net/mig5/enroll#readme" target="_blank" rel="noreferrer">README on Forgejo</a>.
           </div>
         </div>
       </div>

src/index.html

@@ -81,11 +81,11 @@
 ├── playbook.yml
 ├── roles/
 │   ├── cron/
+│   ├── etc_custom/
 │   ├── firewall/
 │   ├── nginx/
 │   ├── openssh-server/
 │   ├── users/
-│   ├── etc_custom/
 └── README.md</pre>
           </div>
           <div class="smallprint mt-3">Tip: for multiple hosts, use <code>--fqdn</code> to generate inventory-driven, data-driven roles.</div>
@@ -187,7 +187,7 @@
         <h2 class="section-title display-6 fw-bold mb-2">Quickstart</h2>
       </div>
       <div class="col-lg-5 text-lg-end">
-        <a class="btn btn-outline-dark" href="https://git.mig5.net/mig5/enroll" target="_blank" rel="noreferrer"><i class="bi bi-journal-text"></i> Full README</a>
+        <a class="btn btn-outline-dark" href="https://git.mig5.net/mig5/enroll#readme" target="_blank" rel="noreferrer"><i class="bi bi-journal-text"></i> Full README</a>
       </div>
     </div>
 
@@ -196,6 +196,7 @@
       <li class="nav-item" role="presentation"><button class="nav-link" id="qs2-tab" data-bs-toggle="tab" data-bs-target="#qs2" type="button" role="tab">Remote</button></li>
       <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>
     </ul>
 
     <div class="tab-content mt-3">
@@ -264,7 +265,22 @@ enroll diff \
   --webhook-header 'X-Enroll-Secret: ...' \
   --exit-code</code></pre>
         </div>
+        <div class="smallprint mt-3">E-mail notifications are also supported. Run it on a systemd timer to alert to drift!</div>
       </div>
+      <div class="tab-pane fade" id="qs5" role="tabpanel" aria-labelledby="qs5-tab">
+        <div class="codeblock">
+          <button class="btn btn-sm btn-outline-secondary copy-btn" data-copy-target="#qs5code"><i class="bi bi-clipboard"></i> Copy</button>
+          <pre class="terminal mb-0"><code id="qs5code"># Explain what's in a harvest
+enroll explain /path/to/harvest
+
+# JSON format, and using a SOPS-encrypted harvest
+enroll explain /path/to/harvest.sops \
+  --sops \
+  --format json
+</code></pre>
+        </div>
+	<div class="smallprint mt-3">'explain' tells you why something was included, but also why something was <em>excluded</em>.</div>
+      </div>      
     </div>
   </div>
 </section>
@@ -329,7 +345,7 @@ enroll diff \
         <p class="text-muted mb-0">Use your preferred packaging. An AppImage is also available.</p>
       </div>
       <div class="col-lg-4 text-lg-end">
-        <a class="btn btn-outline-dark" href="https://git.mig5.net/mig5/enroll" target="_blank" rel="noreferrer"><i class="bi bi-link-45deg"></i>Other install steps</a>
+        <a class="btn btn-outline-dark" href="https://git.mig5.net/mig5/enroll#install" target="_blank" rel="noreferrer"><i class="bi bi-link-45deg"></i>Other install steps</a>
       </div>
     </div>
 

upload.sh

@@ -5,6 +5,8 @@ set -eou pipefail
 SRC="src"
 DEST="/opt/www/enroll.sh"
 
+cp -a ~/git/enroll/enroll/schema/state.schema.json src/schema/state.schema.json
+
 rsync -aHPvz ${SRC}/ root@lupin.mig5.net:${DEST}/
 
 ssh root@lupin.mig5.net "chown -R web:web ${DEST}"