Address review: list-based table headers, robust @page/@ref checks

- Build markdown table headers from column lists instead of string concat
- Use re.search with MULTILINE for @page detection (handles leading whitespace)
- Strip code blocks before scanning for @ref targets (avoids false positives)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sbryngelson

toolchain/mfc/lint_docs.py

@@ -211,13 +211,13 @@ def check_page_refs(repo_root: Path) -> list[str]:
     page_ids = {"citelist"}  # Doxygen built-in
     for md_file in doc_dir.glob("*.md"):
         text = md_file.read_text(encoding="utf-8")
-        m = re.match(r"@page\s+(\w+)", text)
+        m = re.search(r"^\s*@page\s+(\w+)", text, flags=re.MULTILINE)
         if m:
             page_ids.add(m.group(1))
 
     errors = []
     for md_file in sorted(doc_dir.glob("*.md")):
-        text = md_file.read_text(encoding="utf-8")
+        text = _strip_code_blocks(md_file.read_text(encoding="utf-8"))
         rel = md_file.relative_to(repo_root)
         for match in REF_RE.finditer(text):
             ref_target = match.group(1)

toolchain/mfc/params/generators/docs_gen.py

@@ -457,16 +457,13 @@ def generate_parameter_docs() -> str:  # pylint: disable=too-many-locals,too-man
             lines.append("### Patterns")
             lines.append("")
             # Build header dynamically based on which optional columns are needed
-            hdr = "| Pattern | Example | Description"
-            sep = "|---------|---------|------------"
+            cols = ["Pattern", "Example", "Description"]
             if pattern_has_symbols:
-                hdr += " | Symbol"
-                sep += "-|-------"
+                cols.append("Symbol")
             if pattern_has_constraints:
-                hdr += " | Constraints"
-                sep += "-|------------"
-            lines.append(hdr + " |")
-            lines.append(sep + "-|")
+                cols.append("Constraints")
+            lines.append("| " + " | ".join(cols) + " |")
+            lines.append("| " + " | ".join("-" * max(3, len(c)) for c in cols) + " |")
 
             for pattern, examples in sorted(patterns.items()):
                 example = examples[0]
@@ -499,15 +496,12 @@ def generate_parameter_docs() -> str:  # pylint: disable=too-many-locals,too-man
             # Check if any param in this family has a math symbol
             full_has_symbols = any(get_math_symbol(n) for n, _ in params)
 
-            hdr = "| Parameter | Type | Description"
-            sep = "|-----------|------|------------"
+            cols = ["Parameter", "Type", "Description"]
             if full_has_symbols:
-                hdr += " | Symbol"
-                sep += "-|-------"
-            hdr += " | Constraints"
-            sep += "-|------------"
-            lines.append(hdr + " |")
-            lines.append(sep + "-|")
+                cols.append("Symbol")
+            cols.append("Constraints")
+            lines.append("| " + " | ".join(cols) + " |")
+            lines.append("| " + " | ".join("-" * max(3, len(c)) for c in cols) + " |")
 
             for name, param in params:
                 type_str = _type_to_str(param.param_type)