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

The file view is a component in docs/design/areas/code.md, and .blob-view leaves §5d #5510

Merged opened this

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

Merged

`.blob-view` now lives in its own area file, and docs/DESIGN.md §5d loses its one line for it.

shipped production is serving it deploy 23f74da

opened this

.blob-view now lives in its own area file, and docs/DESIGN.md §5d loses its one line for it.

  • New docs/design/areas/code.md: it names .blob-view in a code span, set out like the other area files. The entry says what the class is for: on a Markdown file, it wraps the Source/Rendered .seg toggle at the end of the file's bar. It says what the class does to it: sets it 8px off the line count, with its segments at 12.5px. It also names the function that draws it, renderBlob in src/web/pages/repo.ts.
  • docs/DESIGN.md §5d: only the ` - .blob-view line under "style/content.ts, code view" is deleted. The .ln and .tok-*` lines around it stay where they were.

I did not change any markup or stylesheet rule (src/web/style/content.ts:348–349 and the markup in repo.ts are as they were), so every page that draws the file view looks the same.

bun scripts/design-lint.ts passes. The design tests (test/design-lint.test.ts, which includes the check that every defined class is documented, plus design-audit and design-map) all pass: 24 tests across 3 files.

To try it: open a Markdown file in the code browser on the preview; the Source/Rendered toggle should look the same as on production.

🤖 Generated with Claude Code

Closes #5498

commented

.blob-view now lives in its own area file, and docs/DESIGN.md §5d loses its one line for it.

  • New docs/design/areas/code.md: it names .blob-view in a code span, set out like the other area files. The entry says what the class is for: on a Markdown file, it wraps the Source/Rendered .seg toggle at the end of the file's bar. It says what the class does to it: sets it 8px off the line count, with its segments at 12.5px. It also names the function that draws it, renderBlob in src/web/pages/repo.ts.
  • docs/DESIGN.md §5d: only the ` - .blob-view line under "style/content.ts, code view" is deleted. The .ln and .tok-*` lines around it stay where they were.

I did not change any markup or stylesheet rule (src/web/style/content.ts:348–349 and the markup in repo.ts are as they were), so every page that draws the file view looks the same.

bun scripts/design-lint.ts passes. The design tests (test/design-lint.test.ts, which includes the check that every defined class is documented, plus design-audit and design-map) all pass: 24 tests across 3 files.

To try it: open a Markdown file in the code browser on the preview; the Source/Rendered toggle should look the same as on production.

🤖 Generated with Claude Code

Approved

Docs-only move: .blob-view is documented in docs/design/areas/code.md and its line leaves §5d. The class still exists at style/content.ts:348-349 and repo.ts:839, so nothing visible changes, and the entry matches the CSS (8px margin, 12.5px segments). Next: (1) move the other code-view classes (.ln, .tok-) into code.md too, so §5d stops being a second home for that area; (2) add a line to code.md saying where the tok- classes are generated (highlight-html.ts).

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs