Conversation
The design section answered what the tokens are (design system), how to choose between them (design guidelines) and how to swap them at runtime (theming) — but nothing answered the question that comes before all three: what shape should a dense page take at all. A screen can carry every field the endpoint returns, with filters, status tags and bulk actions, and still leave the reader with no idea what to look at first. Nothing is missing; the order is. New page at /src/ranui/information-architecture/ in all eight languages: the three questions that fix a page (primary information, supporting information, next action), why the shape follows the task rather than the payload, a catalogue of 19 expression skeletons chosen by the question in front of the reader, the six pairs that get swapped (timeline vs. steps, kanban vs. filter, calendar vs. timeline, card grid vs. table, graph vs. adjacency list, document vs. field grid), where each kind of information belongs, reading order, density, and how to keep task context. The "what ranui gives you at this layer" section is written for this library rather than transplanted: r-section/r-card for bands and entries, r-tabs for peer views of one object, r-disclosure-row for progressive disclosure, r-state-dot with its label — and the plain statement that ranui ships no table, tree, calendar, kanban or timeline, so building one means building it out of the tokens instead of a second visual system. The agent-facing source gets the same rules as DESIGN.md §12, which sits one level above §11 (Composition): §11 arranges a page whose shape is already settled, §12 settles it. Adapted from alswl's page-organisation guide (https://github.com/alswl/guides/blob/master/fe-page-guide-antd.md) from Ant Design Pro to ranui. Also fixes a rendering bug the new page surfaced: `_emphasis_` does not parse when a delimiter touches a CJK letter, so it reached the page as literal underscores. 24 spans across 10 Japanese and Korean pages rendered as `_と_`, `_전부_`, `_無効_`. They become `**` — which is what the Chinese pages already used for exactly this reason. Only the spans that genuinely fail CommonMark's flanking rules were rewritten; correctly rendering `_em_` spans are untouched. Verified: 1401 pages build, links/anchors/canonicals/sitemap verify clean, check:langs passes for all eight languages, and a full rescan of the rendered site finds no literal emphasis underscores left. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Cv5oe1ZXN73zVuGWFxNk2V
Deploying ran with
|
| Latest commit: |
c57fd6e
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://89f79cce.ran-4ty.pages.dev |
| Branch Preview URL: | https://docs-information-architectur.ran-4ty.pages.dev |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
The design section answered three questions — what the tokens are (design system), how to choose between them (design guidelines), how to swap them at runtime (theming) — and none of them answered the one that comes first: what shape should a dense page take at all.
A screen can carry every field the endpoint returns, with filters, status tags and bulk actions, and still leave the reader with no idea what to look at first. Nothing is missing; the order is.
What this adds
A new page,
/src/ranui/information-architecture/, in all eight languages. It covers:A "what ranui gives you at this layer" section written for this library, not transplanted:
r-section/r-cardfor bands and repeated entries,r-tabsfor peer views of one object,r-disclosure-rowfor progressive disclosure,r-state-dotalways with its label — and the plain statement that ranui ships no table, tree, calendar, kanban or timeline, so building one means building it out of the tokens rather than a second visual system.DESIGN.md§12 carries the same rules for agents. It sits one level above §11 (Composition): §11 arranges a page whose shape is already settled, §12 settles it.Adapted from alswl's page-organisation guide from Ant Design Pro to ranui.
Drive-by fix: CJK emphasis rendered as literal underscores
Verifying the new page in a browser turned up an existing bug.
_emphasis_does not parse when a delimiter touches a CJK letter, so it reached the reader as literal underscores —ライト_と_ダーク,_전부_를,トークンが_何か_. 24 spans across 10 Japanese and Korean pages were affected.They become
**, which is what the Chinese pages already used for exactly this reason. Only spans that genuinely fail CommonMark's flanking rules were rewritten — correctly rendering_em_spans (_왜_,_그 폭으로 크기를 바꾸는_) are untouched, and code spans, fenced blocks and link targets were masked out of the rewrite.list_file,read_fileincn/src/article/aiis an identifier, not emphasis, and was left alone.Verification
check:langs— 8 languages, 237 labels, all pages present and structurally matchedbuild— 1401 pagesverify— links, anchors, canonicals, assets and sitemap all consistenttsc --noEmitandvitest runpass.table-wrap, as on the sibling pages🤖 Generated with Claude Code
https://claude.ai/code/session_01Cv5oe1ZXN73zVuGWFxNk2V