Dashboardcraftgenerate-publish parser docs markers

generate-publish parser docs markers

Category: gotcha
Confidence: 1.00
ID: 01a07f3e-b52e-7672-b348-193400593c4a
Project ID: e16af391-c497-4837-b681-c849a5514499
Cross-project: No
Recalled in other projects: 0
Source session: 0ZdHwgWRLVf122BpR
Created: 2026-09-08 01:39:53
Updated: 2026-09-08 04:20:11

Content

Trap: counting only exact generated-doc markers looks sufficient because a valid BEGIN/END pair is unique, but duplicate or malformed marker-like fragments (such as <!-- BEGIN GENERATED TITLE GRAMMAR -- >) leave the generated region ambiguous. Fix: reject missing, duplicate, malformed, or marker-like BEGIN/END delimiters before replacement or comparison; require one ordered authoritative pair and regression-test valid markers plus malformed extras.

Move to: