better docs

1 files changed, 17 insertions, 12 deletions

diff --git a/docs/quirks.html b/docs/quirks.html
index c46fdb2..b9b1246 100644
--- a/docs/quirks.html
+++ b/docs/quirks.html
@@ -3,14 +3,14 @@
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>8. Quirks, dead code &amp; corrections — Animalese</title>
+<title>9. Quirks, dead code &amp; corrections — Animalese</title>
 <link rel="stylesheet" href="style.css">
 </head>
 <body>
 
-<nav class="crumb"><a href="index.html">Animalese pipeline</a> / 8. Quirks &amp; corrections</nav>
+<nav class="crumb"><a href="index.html">Animalese pipeline</a> / 9. Quirks &amp; corrections</nav>
 
-<h1>8. Quirks, dead code &amp; corrections</h1>
+<h1>9. Quirks, dead code &amp; corrections</h1>
 <p class="lede">Things a faithful port has to reproduce, things a clean reimplementation
 should drop, and where earlier notes were wrong.</p>
 
@@ -102,7 +102,9 @@ every neighbour is 0–5.</p>
 
 <h2>Corrections to earlier notes</h2>
 
-<p>The following supersede statements in <code>../extraction.md</code> as originally written.</p>
+<p>The following supersede statements from earlier working notes
+(<code>extraction.md</code>, since retired — its surviving content lives on
+<a href="disc.html">the disc page</a>).</p>
 
 <table>
 <tr><th>Was</th><th>Actually</th></tr>
@@ -110,9 +112,10 @@ every neighbour is 0–5.</p>
 <tr><td>"Bank 157 has only 83 instruments … that voice collapses every digraph sample
 above <code>0x53</code> onto one sound."</td>
 <td>Nothing above <code>0x53</code> is a digraph. The phonology engine's maximum output is
-<code>0x52</code>, plus <code>0x77</code>. Bank 157 covers the phonology range exactly; the
-missing block is the <a href="editor.html">editor's letter names</a>, unreachable at spec 3.
-The only real loss is <code>you</code>.</td></tr>
+<code>0x52</code>, plus <code>0x77</code>. Bank 157 covers the phonology range with one
+instrument to spare, the missing block is the <a href="editor.html">editor's letter
+names</a> (unreachable at spec 3), and nothing is lost: sequence 244 explicitly maps
+<code>you</code> to that 83rd instrument — a dedicated substitute, not a clamp.</td></tr>
 
 <tr><td>"43 of the 119 codes are unreachable through normal text … only ever hit by the
 anti-repetition random substitution."</td>
@@ -144,13 +147,15 @@ the config. See <a href="gating.html">gating</a>.</td></tr>
 <a href="editor.html">the editor path</a>.</td></tr>
 </table>
 
-<p>Everything else in <code>extraction.md</code> §1 was re-verified against the current tree
-and holds: the voice table, the 53 digraph entries, both vowel tables, the per-spec
-timbre values, and the spec→sequence→bank mapping.</p>
+<p>Everything else in the retired notes was re-verified against the current tree and
+holds: the voice table, the 53 digraph entries, both vowel tables, the per-spec timbre
+values, and the spec→sequence→bank mapping. The table contents, bank layouts and
+sequence bytecode were additionally verified byte-for-byte against a dumped disc image
+(see <a href="disc.html">the disc page</a>).</p>
 
 <div class="pager">
-  <span><a href="editor.html">← 7. The editor path</a></span>
-  <span><a href="reference.html">9. Reference tables →</a></span>
+  <span><a href="disc.html">← 8. Walking the disc image</a></span>
+  <span><a href="reference.html">10. Reference tables →</a></span>
 </div>
 
 </body>