From 983a4fa229925e84802d11e3ded9822e5a98e76e Mon Sep 17 00:00:00 2001
From: atlas <atlas@hyperhive>
Date: Sat, 30 May 2026 11:15:44 +0200
Subject: [PATCH] =?UTF-8?q?nix/docs:=20demote=20index=20sections=20h2=20?=
 =?UTF-8?q?=E2=86=92=20h3=20(argus=20#622=20nit)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

argus on #622 comment 7419 🟡:
> monospace h2 on index — the CSS styles `h2` with `ui-monospace`
> font (intended for option-name headings in the per-option pages).
> on the index page, "host options" / "agent options" / "Regenerate"
> headings also get monospace treatment. cosmetic; reads as
> intentional if not, easy to scope.

Index page now uses h3 for section headers, leaves h2 free for the
auto-generated option-name headings on host.html / agent.html where
the monospace styling is appropriate.

(Other argus nit — stale namespace text in indexHTML's option
listings — will be addressed when this branch rebases post-#615
merge, same as #620.)
---
 nix/docs.nix | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/nix/docs.nix b/nix/docs.nix
index 8cadf7db..ed6655e4 100644
--- a/nix/docs.nix
+++ b/nix/docs.nix
@@ -286,11 +286,11 @@ let
       echo '<main>'
       echo '<h1>hyperhive — nix options reference</h1>'
       echo '<p>Auto-generated from the <a href="${forgeRoot}">hyperhive flake</a>. Two reading paths:</p>'
-      echo '<h2><a href="./host.html">host options</a></h2>'
+      echo '<h3><a href="./host.html">host options</a></h3>'
       echo '<p>Options exposed by <code>hyperhive.nixosModules.default</code> to operator host configurations: <code>services.hive-c0re.*</code>, <code>hyperhive.domain</code>, <code>hyperhive.forge.*</code>, <code>hyperhive.matrix.*</code>.</p>'
-      echo '<h2><a href="./agent.html">agent options</a></h2>'
+      echo '<h3><a href="./agent.html">agent options</a></h3>'
       echo '<p>Per-agent options declared in <code>nix/templates/harness-base.nix</code> and visible from every <code>agent.nix</code>: <code>hyperhive.model</code>, <code>hyperhive.allowedRecipients</code>, <code>hyperhive.extraMcpServers</code>, <code>hyperhive.frontend.*</code>, <code>hyperhive.forge.*</code>, <code>hyperhive.matrix.*</code>, <code>hyperhive.gui.*</code>.</p>'
-      echo '<h2>Regenerate</h2>'
+      echo '<h3>Regenerate</h3>'
       echo '<pre><code>nix build .#docs          # bundled static site (index + host + agent)'
       echo 'nix build .#docs-host     # host page only (HTML)'
       echo 'nix build .#docs-agent    # agent page only (HTML)</code></pre>'