From 06916e5884843e49e32242b13f21c01e8ef3f05b Mon Sep 17 00:00:00 2001
From: ZDDC <caseywitt@proton.me>
Date: Wed, 20 May 2026 09:27:00 -0500
Subject: [PATCH] docs: drop alpha/beta channel chooser, point at canonical
 URLs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Match the May 2026 ZDDC simplification — channel mirrors (_stable,
_beta, _alpha) and partial-version pins (_v<X.Y>, _v<X>) are gone.
Each tool has one canonical URL (<tool>.html, symlink → current
stable) and a set of immutable per-version files.

index.html:
- Remove .channel-row CSS
- Replace the per-tool 3-channel row with one card linking to the
  canonical <tool>.html; cards are now clickable
- Drop "Each tool is published in three channels" paragraph; replace
  with "tracks current stable; pin on the releases page for
  reproducibility"
- Update apps: example to use 'stable' or 'v0.0.4' (drop beta/alpha
  and partial-pin options)
- Update header dropdown links + "Local: just download" links to
  canonical URLs
- Drop "channel build" wording in the "All releases" footer link

reference.html:
- Update hardcoded header dropdown links + Section 11 tool cards from
  archive_stable.html / browse_stable.html to archive.html / browse.html

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 index.html     | 41 ++++++++++++++---------------------------
 reference.html |  8 ++++----
 2 files changed, 18 insertions(+), 31 deletions(-)

diff --git a/index.html b/index.html
index 14eef87..7c3f71c 100644
--- a/index.html
+++ b/index.html
@@ -15,11 +15,6 @@
   <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet">
   <link rel="stylesheet" href="css/style.css">
   <style>
-    .channel-row { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-top: 0.75rem; font-size: 0.9rem; }
-    .channel-row a { display: inline-block; padding: 0.25rem 0.625rem; border-radius: 999px; text-decoration: none; border: 1px solid var(--color-border); color: var(--color-text); }
-    .channel-row a:hover { background: var(--color-bg-subtle); }
-    .channel-row .channel-stable { border-color: var(--color-accent); color: var(--color-accent); font-weight: 600; }
-    .channel-row .channel-beta, .channel-row .channel-alpha { color: var(--color-text-muted); }
     .install-grid { display: grid; grid-template-columns: 1fr; gap: var(--spacing-md); margin-top: var(--spacing-md); }
     .install-card { padding: var(--spacing-md); border: 1px solid var(--color-border); border-radius: 8px; background: var(--color-bg-subtle); }
     .install-card h3 { margin-top: 0; margin-bottom: 0.25rem; }
@@ -62,11 +57,11 @@
           </button>
           <div class="dropdown-menu">
             <div class="dropdown-menu__inner">
-              <a href="releases/archive_stable.html">
+              <a href="releases/archive.html">
                 <svg class="dropdown-menu-icon" viewBox="0 0 24 24"><path d="M20 6H4a2 2 0 00-2 2v10a2 2 0 002 2h16a2 2 0 002-2V8a2 2 0 00-2-2zm0 12H4V8h16v10zM4 2h16v2H4z"/></svg>
                 Archive Browser
               </a>
-              <a href="releases/browse_stable.html">
+              <a href="releases/browse.html">
                 <svg class="dropdown-menu-icon" viewBox="0 0 24 24"><path d="M10 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2h-8l-2-2z"/></svg>
                 Browse
               </a>
@@ -98,33 +93,25 @@
 
     <section style="margin-top: var(--spacing-2xl);">
       <h2>Try the tools</h2>
-      <p>Each tool is published in three channels. <strong>Stable</strong> is versioned and immutable; <strong>beta</strong> and <strong>alpha</strong> are mutable previews of in-flight work.</p>
+      <p>Each tool is a single self-contained HTML file. The link below always tracks the current stable; pin to a specific version on the <a href="releases/">releases page</a> for reproducibility.</p>
 
       <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: var(--spacing-lg); margin-top: var(--spacing-lg);">
 
-        <div class="tool-card">
+        <a href="releases/archive.html" class="tool-card" style="text-decoration: none; display: block;">
           <div class="tool-card__title">Archive Browser</div>
           <div class="tool-card__desc">Search the formal record. Filter by tracking number, discipline, revision, status, or free text; group rows by transmittal to see each deliverable's lifecycle; export the current selection as a ZIP. Read-only — the archive is preserved as-issued.</div>
-          <div class="channel-row">
-            <a href="releases/archive_stable.html" class="channel-stable">stable</a>
-            <a href="releases/archive_beta.html" class="channel-beta">beta</a>
-            <a href="releases/archive_alpha.html" class="channel-alpha">alpha</a>
-          </div>
-        </div>
+          <div class="tool-card__link">Open Archive Browser →</div>
+        </a>
 
-        <div class="tool-card">
+        <a href="releases/browse.html" class="tool-card" style="text-decoration: none; display: block;">
           <div class="tool-card__title">Browse</div>
           <div class="tool-card__desc">File-tree navigator for the whole project. Edit markdown in place with live preview, YAML front matter, and a table of contents pane; download any markdown source as DOCX, HTML, or PDF on demand; classify inbound files to ZDDC names, draft transmittals, and manage the project tree end-to-end.</div>
-          <div class="channel-row">
-            <a href="releases/browse_stable.html" class="channel-stable">stable</a>
-            <a href="releases/browse_beta.html" class="channel-beta">beta</a>
-            <a href="releases/browse_alpha.html" class="channel-alpha">alpha</a>
-          </div>
-        </div>
+          <div class="tool-card__link">Open Browse →</div>
+        </a>
 
       </div>
 
-      <p style="margin-top: var(--spacing-lg); color: var(--color-text-muted);">Append <code class="inline">?v=alpha</code> (or <code class="inline">?v=0.0.4</code>, etc.) to any URL to switch versions for a single request — useful for sharing a link to an exact build. Direct local-folder access requires a Chromium-based browser (the File System Access API is unavailable in Firefox / Safari). <a href="releases/">Browse all versions →</a></p>
+      <p style="margin-top: var(--spacing-lg); color: var(--color-text-muted);">Append <code class="inline">?v=v0.0.4</code> to any URL to load a specific version for a single request — useful for sharing a link to an exact build. Direct local-folder access requires a Chromium-based browser (the File System Access API is unavailable in Firefox / Safari). <a href="releases/">Browse all versions →</a></p>
     </section>
 
     <!-- zddc-server (inline, replaces the previous separate page) -->
@@ -191,7 +178,7 @@ Role definitions cascade like everything else; a child <code class="inline">.zdd
           <p class="when" style="margin-top: 0.6rem;"><strong>To override a tool</strong> at any path: drop a real <code class="inline">.html</code> file there — that file wins over the baked-in version. <strong>To pin a different version</strong>, write an <code class="inline">apps:</code> entry in any <code class="inline">.zddc</code> file along the path:</p>
 <pre><code># &lt;project&gt;/.zddc
 apps:
-  browse: stable         # or beta / alpha / v0.0.4 / v0.0 / v0
+  browse: stable         # latest stable, or v0.0.4 to pin an exact version
   archive: https://my-fork.example/archive.html</code></pre>
           <p class="when" style="margin-top: 0.6rem;">URL sources are fetched once and cached in <code class="inline">&lt;ZDDC_ROOT&gt;/_app/</code>. To force a re-fetch, delete the cache file. Closer-to-leaf <code class="inline">.zddc</code> entries override parent ones.</p>
         </div>
@@ -200,8 +187,8 @@ apps:
           <h3>Local: just download the .html file</h3>
           <p class="when">No server, no install — open in any modern browser.</p>
           <ul class="install-points">
-            <li><a href="releases/archive_stable.html">archive.html</a></li>
-            <li><a href="releases/browse_stable.html">browse.html</a></li>
+            <li><a href="releases/archive.html">archive.html</a></li>
+            <li><a href="releases/browse.html">browse.html</a></li>
           </ul>
           <p class="when" style="margin-top: 0.6rem;">Right-click → Save As. Each tool is a self-contained HTML file with everything inlined; works from <code class="inline">file://</code> or any static host.</p>
         </div>
@@ -214,7 +201,7 @@ apps:
         <li><a href="reference.html">Technical Reference</a> — the full ZDDC convention: filename format, tracking numbers, revisions, status codes, folder naming, transmittal workflow.</li>
         <li><a href="https://codeberg.org/VARASYS/ZDDC/src/branch/main/zddc/README.md#access-control-the-zddc-cascade">Access control reference</a> — cascade rules, common deployment shapes (paired open/closed projects + third-party-vendor folders), anti-patterns, a five-minute verify-it-works recipe, the federal-readiness gap analysis with NIST control references, and the OPA-compatible decider configuration.</li>
         <li><a href="federal.html">For federal evaluators</a> — non-technical walk-through of what's already in place, the supported deployment shape, what an integrator adds during ATO, and the two-track build plan. Procurement-friendly entry point that links back to engineering detail.</li>
-        <li><a href="releases/">All releases</a> — every version and channel build of every tool, with per-version pin URLs.</li>
+        <li><a href="releases/">All releases</a> — every version of every tool, with per-version pin URLs.</li>
         <li><a href="https://codeberg.org/VARASYS/ZDDC">codeberg.org/VARASYS/ZDDC</a> — source code, issue tracker, contributor docs.</li>
       </ul>
     </section>
diff --git a/reference.html b/reference.html
index e02c9f1..db7b593 100644
--- a/reference.html
+++ b/reference.html
@@ -40,11 +40,11 @@
           </button>
           <div class="dropdown-menu">
             <div class="dropdown-menu__inner">
-              <a href="releases/archive_stable.html">
+              <a href="releases/archive.html">
                 <svg class="dropdown-menu-icon" viewBox="0 0 24 24"><path d="M20 6H4a2 2 0 00-2 2v10a2 2 0 002 2h16a2 2 0 002-2V8a2 2 0 00-2-2zm0 12H4V8h16v10zM4 2h16v2H4z"/></svg>
                 Archive Browser
               </a>
-              <a href="releases/browse_stable.html">
+              <a href="releases/browse.html">
                 <svg class="dropdown-menu-icon" viewBox="0 0 24 24"><path d="M10 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2h-8l-2-2z"/></svg>
                 Browse
               </a>
@@ -1238,13 +1238,13 @@ request until you populate it..."</div>
         <p>Two single-file HTML applications — each is complete and self-contained. Save them locally and they work forever, without internet, without updates, without a subscription. Together they cover the full ZDDC workflow: <strong>archive</strong> for searching and exporting the formal record; <strong>browse</strong> for navigating, editing, and managing the project tree.</p>
 
         <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: var(--spacing-lg); margin-top: var(--spacing-lg);">
-          <a href="releases/archive_stable.html" class="tool-card" style="text-decoration: none; display: block;">
+          <a href="releases/archive.html" class="tool-card" style="text-decoration: none; display: block;">
             <div class="tool-card__title">Archive Browser</div>
             <div class="tool-card__desc">Search and filter the formal record. Filter by tracking number, discipline, revision, status, or free text. Group rows by transmittal to see the lifecycle of any deliverable. Download the current selection as a ZIP. Read-only — the archive is preserved as-issued.</div>
             <div class="tool-card__link">Open Archive Browser</div>
           </a>
 
-          <a href="releases/browse_stable.html" class="tool-card" style="text-decoration: none; display: block;">
+          <a href="releases/browse.html" class="tool-card" style="text-decoration: none; display: block;">
             <div class="tool-card__title">Browse</div>
             <div class="tool-card__desc">File-tree navigator for the project. Edit markdown in place (live preview, YAML front matter pane, table of contents). Download any markdown source as DOCX, HTML, or PDF on demand. Drop in files, classify them to ZDDC names, draft transmittals, and prepare deliverables — every workflow happens here.</div>
             <div class="tool-card__link">Open Browse</div>