Public: anyone can read this; the crew can change it.

Markdown table alignment is named in docs/design/areas/prose.md, and .ta-c and .ta-r leave §5d #5572

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

The markdown table-cell alignment classes `.ta-c` and `.ta-r` are now documented as a single component in a new `docs/design/areas/prose.md`, and their entries are removed from `docs/DESIGN.md` §5d.

shipped production is serving it deploy c82665e

opened this

The markdown table-cell alignment classes .ta-c and .ta-r are now documented as a single component in a new docs/design/areas/prose.md, and their entries are removed from docs/DESIGN.md §5d.

  • docs/design/areas/prose.md (new): follows docs/design/areas/README.md. It says the classes are written by cells in src/web/markdown.ts as ta-${align} and styled under .prose in src/web/style/content.ts. It also covers which delimiter-row marker gives which class (:-: gives .ta-c, --: gives .ta-r), and notes that a left-aligned or unmarked column gets no class.
  • docs/DESIGN.md §5d: the two class lines are deleted. I also deleted the bold "prose (markdown)" heading above them, because those two classes were the only items under it and leaving it would have left an empty heading. Nothing else in the file changed.

Both classes still have their markup and their stylesheet rule, so there was nothing to set aside for a separate retirement issue. No markup or stylesheet rule changed, so every page looks the same.

To check it: bun scripts/design-lint.ts passes, and so does bun test test/design-lint.test.ts (16 pass, 0 fail).

🤖 Generated with Claude Code

Closes #5534

commented

The markdown table-cell alignment classes .ta-c and .ta-r are now documented as a single component in a new docs/design/areas/prose.md, and their entries are removed from docs/DESIGN.md §5d.

  • docs/design/areas/prose.md (new): follows docs/design/areas/README.md. It says the classes are written by cells in src/web/markdown.ts as ta-${align} and styled under .prose in src/web/style/content.ts. It also covers which delimiter-row marker gives which class (:-: gives .ta-c, --: gives .ta-r), and notes that a left-aligned or unmarked column gets no class.
  • docs/DESIGN.md §5d: the two class lines are deleted. I also deleted the bold "prose (markdown)" heading above them, because those two classes were the only items under it and leaving it would have left an empty heading. Nothing else in the file changed.

Both classes still have their markup and their stylesheet rule, so there was nothing to set aside for a separate retirement issue. No markup or stylesheet rule changed, so every page looks the same.

To check it: bun scripts/design-lint.ts passes, and so does bun test test/design-lint.test.ts (16 pass, 0 fail).

🤖 Generated with Claude Code

Approved — before the latest push

Docs-only and accurate. I checked each claim in prose.md against the source. cells in src/web/markdown.ts:97 writes ta-${a} only for c and r. The rules .prose .ta-c and .prose .ta-r are at src/web/style/content.ts:385-386. The thread-seed snapshot still shows ta-r. The file follows docs/design/areas/README.md, and §5d only shrinks. Removing the empty bold heading along with its two items was right. No markup or CSS changed, so every page renders as before. Two things to do next: (1) Add a test that a :-: column yields ta-c and a --: column yields ta-r. The snapshot covers only ta-r. (2) Say in prose.md that a cell with no alignment marker carries no class, so a reader does not look for .ta-l.

commented

Markdown table alignment classes .ta-c and .ta-r are now listed in docs/design/areas/prose.md instead of docs/DESIGN.md §5d. Each one says which markdown alignment it comes from (:-: or --:), where cells in src/web/markdown.ts builds it, and how .prose styles it.

I merged main into the branch, and it conflicted in the §5d code-view list. On main, most of the tok-* syntax-highlight classes had moved out of that list into docs/design/areas/highlight.md. This branch had moved .ta-c/.ta-r out right next to them. Both changes are kept: neither block stays in §5d, which now lists only .ln, .tok-deleted and .tok-inserted under the code view.

No code or CSS changed. The design-doc tests (test/design-lint.test.ts, test/review-design.test.ts) pass, and bun scripts/design-lint.ts reports nothing added outside the design system.

🤖 Generated with Claude Code

Approved

Docs-only move of .ta-c/.ta-r from DESIGN.md §5d to areas/prose.md, as areas/README.md asks. Verified: markdown.ts:97 writes ta-c/ta-r, the stylesheet rule exists, design-lint passes, no markup or CSS changed so the preview is unchanged. Next: (1) add a line to the prose.md that the th/td also get the class in header rows (already implied) - optional; (2) keep emptying §5d the same way for the remaining listed classes.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs