update docs structure

Author: hellerve

docs/Cursor.html

@@ -71,7 +71,11 @@ <h1>
                     Cursor
                 </h1>
                 <div class="module-description">
-                    
+                    <p>is a cursor over the parser input: <code>pos</code> (byte offset),
+<code>line</code>, and <code>col</code>. Newline-aware: <code>\n</code> advances <code>line</code> and resets
+<code>col</code> to 1. Users mostly see <code>Cursor</code> values via <code>ParseErr</code> for error
+reporting.</p>
+
                 </div>
                 <div class="binder">
                     <a class="anchor" href="#=">
@@ -109,7 +113,7 @@ <h3 id="advance">
                     </pre>
                     <p class="doc">
                         <p>advances the cursor past one byte. If the byte is a
-newline, the line counter increments and col resets to 1.</p>
+newline, <code>line</code> increments and <code>col</code> resets to 1.</p>
 
                     </p>
                 </div>
@@ -469,7 +473,7 @@ <h3 id="zero">
                         (zero)
                     </pre>
                     <p class="doc">
-                        <p>the initial cursor: pos=0, line=1, col=1.</p>
+                        <p>is the initial cursor: <code>pos=0</code>, <code>line=1</code>, <code>col=1</code>.</p>
 
                     </p>
                 </div>

docs/ParseErr.html

@@ -71,7 +71,11 @@ <h1>
                     ParseErr
                 </h1>
                 <div class="module-description">
-                    
+                    <p>is a parser failure carrying byte/line/column position,
+an optional <code>unexpected</code> token, and an <code>expected</code> set of labels
+gathered from parsers that failed at that position. Render with
+<code>Parser.format-error</code>.</p>
+
                 </div>
                 <div class="binder">
                     <a class="anchor" href="#col">
@@ -149,7 +153,7 @@ <h3 id="empty-at">
                         (empty-at cur)
                     </pre>
                     <p class="doc">
-                        <p>creates a ParseErr at cur with no labels.</p>
+                        <p>creates a <code>ParseErr</code> at <code>cur</code> with no labels.</p>
 
                     </p>
                 </div>
@@ -189,7 +193,7 @@ <h3 id="expected-at">
                         (expected-at cur lbl)
                     </pre>
                     <p class="doc">
-                        <p>creates a ParseErr at cur with one expected label.</p>
+                        <p>creates a <code>ParseErr</code> at <code>cur</code> with one expected label.</p>
 
                     </p>
                 </div>

docs/Parser.Lexer.html

@@ -71,7 +71,9 @@ <h1>
                     Parser.Lexer
                 </h1>
                 <div class="module-description">
-                    
+                    <p>is a submodule of common-token parsers: whitespace
+handling, integers, identifiers, and literal symbols.</p>
+
                 </div>
                 <div class="binder">
                     <a class="anchor" href="#identifier">
@@ -89,9 +91,9 @@ <h3 id="identifier">
                         (identifier)
                     </pre>
                     <p class="doc">
-                        <p>parses a C-style identifier: a letter or underscore,
-followed by zero or more letters, digits, or underscores. Returns the
-matched text as a String.</p>
+                        <p>parses a C-style identifier: a letter or
+underscore, followed by zero or more letters, digits, or underscores.
+Returns the matched text as a <code>String</code>.</p>
 
                     </p>
                 </div>
@@ -111,8 +113,8 @@ <h3 id="integer">
                         (integer)
                     </pre>
                     <p class="doc">
-                        <p>parses an optional <code>-</code> sign followed by decimal digits as
-an Int. Fused into a single closure.</p>
+                        <p>parses an optional <code>-</code> sign followed by decimal
+digits as an <code>Int</code>. Fused into a single closure.</p>
 
                     </p>
                 </div>
@@ -132,7 +134,7 @@ <h3 id="lexeme">
                         (lexeme p)
                     </pre>
                     <p class="doc">
-                        <p>runs p, then skips trailing whitespace. Returns p's value.</p>
+                        <p>runs <code>p</code>, then skips trailing whitespace. Returns <code>p</code>'s value.</p>
 
                     </p>
                 </div>
@@ -152,7 +154,7 @@ <h3 id="symbol">
                         (symbol s)
                     </pre>
                     <p class="doc">
-                        <p>matches the literal string s, then skips trailing whitespace.</p>
+                        <p>matches the literal string <code>s</code>, then skips trailing whitespace.</p>
 
                     </p>
                 </div>
@@ -172,8 +174,9 @@ <h3 id="unsigned-int">
                         (unsigned-int)
                     </pre>
                     <p class="doc">
-                        <p>parses one or more decimal digits as an Int. Fused
-into a single closure for performance — does not go through bind/map.</p>
+                        <p>parses one or more decimal digits as an
+<code>Int</code>. Fused into a single closure for performance — does not go
+through <code>bind</code>/<code>map</code>.</p>
 
                     </p>
                 </div>

docs/Parser.UTF8.html

@@ -71,7 +71,10 @@ <h1>
                     Parser.UTF8
                 </h1>
                 <div class="module-description">
-                    
+                    <p>is a submodule of codepoint-level parsers layered on the
+byte-level core. Each codepoint advances the cursor by one column,
+regardless of byte width.</p>
+
                 </div>
                 <div class="binder">
                     <a class="anchor" href="#any-char">
@@ -89,8 +92,8 @@ <h3 id="any-char">
                         (any-char)
                     </pre>
                     <p class="doc">
-                        <p>consumes one UTF-8 codepoint, returning it as Char.
-Fails empty at end of input or on malformed UTF-8.</p>
+                        <p>consumes one UTF-8 codepoint, returning it as a
+<code>Char</code>. Fails empty at end of input or on malformed UTF-8.</p>
 
                     </p>
                 </div>