Skip to content

fix: tabbed-set rendering and doc edit links - #27

Merged
slin1237 merged 2 commits into
mainfrom
fix/tabbed-set-markdown-gap
Aug 1, 2026
Merged

fix: tabbed-set rendering and doc edit links#27
slin1237 merged 2 commits into
mainfrom
fix/tabbed-set-markdown-gap

Conversation

@slin1237

@slin1237 slin1237 commented Aug 1, 2026

Copy link
Copy Markdown
Member

Two doc-page fixes, verified against the production build under wrangler pages dev:

1. Markdown after tabbed sets rendered as literal text (### PD Disaggregation Workers, ## Step 1: Start SMG)

parseTabGroups consumes the blank lines that follow a === "Tab" block, so the emitted <div class="doc-tabbed-set">… markup and the next source line were joined by a single newline. CommonMark treats a raw-HTML block as continuing until a blank line, so whatever directly followed a tab widget was swallowed into the HTML block and emitted verbatim. The fix emits a blank line after the tab-set markup, terminating the HTML block.

2. Edit/Raw links pointed at the old repo

DocMarkdown.svelte built github.com/lightseekorg/smg/edit/main/docs/… URLs; the content now lives in this repository. Links now target smg-project/smg-docs/edit/main/src/lib/content/… (raw-URL path verified to return 200).

Verification (isolated worktree, port 4180)

  • /smg/getting-started: zero literal ### in the DOM (scripts stripped); PD Disaggregation Workers renders as <h3>, Step 1: Start SMG as <h2>
  • Zero literal headings on /smg/concepts/routing/pd-disaggregation, /smg/getting-started/kv-events-cache-aware-routing, /smg/reference
  • New edit href present; zero lightseekorg/smg/edit URLs remain
  • pnpm build / pnpm lint clean; wrangler log free of errors

🤖 Generated with Claude Code

slin1237 added 2 commits July 31, 2026 22:15
parseTabGroups consumes the blank lines that follow a tab block, so the
emitted <div> markup and the next source line were joined with a single
newline. CommonMark treats that as one continuing raw-HTML block, which
swallowed whatever came next; headings after tabbed sets rendered as
literal '### ...' text. Emit a blank line after the tab-set markup so
the HTML block terminates and the following markdown parses.

Signed-off-by: Simo Lin <25425177+slin1237@users.noreply.github.com>
The Edit/Raw links on doc pages still targeted lightseekorg/smg's docs/
tree; the content now lives in this repository under src/lib/content/.

Signed-off-by: Simo Lin <25425177+slin1237@users.noreply.github.com>
@slin1237
slin1237 merged commit cc41958 into main Aug 1, 2026
5 checks passed
@slin1237
slin1237 deleted the fix/tabbed-set-markdown-gap branch August 1, 2026 05:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant