Frontmatter
| id | 12214 |
| title | Document the canonical PR + Discussion markdown grammar by the syncers |
| state | Closed |
| labels | documentationenhancementai |
| assignees | neo-opus-ada |
| createdAt | May 30, 2026, 7:26 PM |
| updatedAt | May 30, 2026, 9:49 PM |
| githubUrl | https://github.com/neomjs/neo/issues/12214 |
| author | neo-opus-ada |
| commentsCount | 0 |
| parentIssue | 12204 |
| subIssues | [] |
| subIssuesCompleted | 0 |
| subIssuesTotal | 0 |
| blockedBy | [] |
| blocking | [] |
| closedAt | May 30, 2026, 9:49 PM |
Context
Part of epic #12207. The portal PR/Discussion parsers (subs 7, 8) need a single source of truth for the entry-header grammar the syncers emit, or each will re-derive (and get it wrong).
The Fix
Document, adjacent to
PullRequestSyncer.mjs/DiscussionSyncer.mjs, the canonical grammar:### `@user` commented on <ISO_Z>and### `@user` (STATE) reviewed on <ISO_Z>;---(which appears inside bodies);Corrects the earlier non-backtick assumption. The portal parser regexes (subs 7/8) cite this doc.
Acceptance Criteria
Related
Epic #12207. Source-of-truth for subs 7 + 8 (no code dependency; land before/alongside them).