Skip to content

Review follow-up 11: spec page composition (relations and features in columns, a facts and revisions panel beside them) - #71

Merged
jbspeakr merged 6 commits into
mainfrom
claude/project-thread-ehsdpe
Oct 23, 2026
Merged

jbspeakr merged 6 commits into
mainfrom
claude/project-thread-ehsdpe

Conversation

@jbspeakr

@jbspeakr jbspeakr commented Oct 22, 2026 •

Copy link
Copy Markdown
Collaborator

Requested by Jan · project thread

What this changes

Review follow-up 11: the composition of the 41 spec pages. Before, each page was one long list: revisions, then relations, then features. This PR builds on #69, which is merged, and keeps its drawing in the head.

Two columns under the head. Relations and features take the wide column. A panel beside them holds the page's figures (revisions, relations and features, counting up with Facts.astro, M3) and the revision timeline (its line draws in, M13). On wide screens the panel stays in view as the reader scrolls, like the panel on a breach page. Below 60rem the panel comes after the relations.

Relations in columns. The relation groups pack into columns (columns: 19rem), so a long group leaves no gap next to a short one. A group heading is now only the verb phrase ("Builds on", "Is built on by"), because the page title already names the spec. The Source link follows its note instead of taking its own line.

Features by topic. Only MCP Authorization defines features so far. They are grouped by topic (Discovery, Registration and so on), with the same column packing. A thin bar in the level inks shows how many features are MUST, SHOULD and MAY, and the counts are written out beside it, so the bar does not rely on colour alone.

No zero for missing data. The other 40 pages have no recorded features. Their panel says that in one sentence. It does not show "Features 0" or an empty section, because unknown is not unsupported.

Smaller changes. The withdrawn or expired notice moves into the main column, in smaller type. docs/design.md and the accessibility statement add the spec page to M3 and M13. tasks.md gets R-11.

Page height at 1440 px: MCP Authorization drops from 5,316 to 3,529 px, Token Exchange from 2,021 to 1,526 px, and WIMSE S2S from 2,124 to 1,643 px. On phones everything stacks in one column, so the pages are only slightly shorter.

Screenshots

These are from astro preview with reduced motion, so the animations are in their end state.

Before (main) After
mcp-authorization, desktop-light
mcp-authorization, desktop-dark
rfc8693, desktop-light
rfc8693, desktop-dark
wimse-s2s, desktop-light
wimse-s2s, desktop-dark
rfc8693, phone
wimse-s2s, phone
mcp-authorization, phone

The screenshots were committed once for stable URLs and removed in the next commit, so the squashed diff has no images.

Code checklist

  • pnpm check passes, and the enforced budgets pass. The page adds no JavaScript beyond the existing count-up script in Facts.astro.
  • Pages still read fully without JavaScript.
  • Both themes checked. spec-page.spec.ts gets two new tests: the panel sits beside the main column on wide screens and after it on phones, and a spec with no features shows the sentence and no zero. The existing FR-008 and FR-014 tests pass unchanged, and so does axe. The spec baseline is meant to change, so this PR needs the refresh-screenshots label. The standards phone baselines also fail locally, but they fail on main too with this container's Chromium.

🤖 Generated with Claude Code

https://claude.ai/code/session_01HjyoQhmK85j5jqTFVYFDEh

…evisions in a panel beside them

The spec pages read as one long list. Relations and features now take the
wide column and pack into columns; a sticky panel beside them holds the
figures (count-up, M3) and the revision timeline (rail draw-in, M13). A spec
with no recorded features says so in the panel instead of showing a zero.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HjyoQhmK85j5jqTFVYFDEh
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HjyoQhmK85j5jqTFVYFDEh
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HjyoQhmK85j5jqTFVYFDEh
@jbspeakr
jbspeakr force-pushed the claude/project-thread-ehsdpe branch from 63ce693 to ca4c82f Compare October 22, 2026 21:13
@jbspeakr jbspeakr changed the title WP8: Add decorative plate to spec pages and section roots Review follow-up 11: spec page composition (relations and features in columns, a facts and revisions panel beside them) Oct 22, 2026
@jbspeakr jbspeakr added the refresh-screenshots Regenerate Playwright screenshot baselines with CI's Chromium and commit them to the PR branch label Oct 22, 2026 — with Claude
@jbspeakr jbspeakr self-assigned this Oct 22, 2026
@github-actions github-actions Bot removed the refresh-screenshots Regenerate Playwright screenshot baselines with CI's Chromium and commit them to the PR branch label Oct 22, 2026
CI's axe run caught the current-revision chip mid-fade on the tinted panel,
below the contrast threshold. The rail still draws in (M13); the entries no
longer fade.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HjyoQhmK85j5jqTFVYFDEh
@jbspeakr jbspeakr added the refresh-screenshots Regenerate Playwright screenshot baselines with CI's Chromium and commit them to the PR branch label Oct 22, 2026 — with Claude
Generated by the screenshots workflow for #71.
@github-actions github-actions Bot removed the refresh-screenshots Regenerate Playwright screenshot baselines with CI's Chromium and commit them to the PR branch label Oct 22, 2026
Resolves the motion catalogue conflict: M12 takes main's wording (the count
of checks appears last), M13 keeps the spec page revisions row.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HjyoQhmK85j5jqTFVYFDEh
@jbspeakr
jbspeakr merged commit 6212a92 into main Oct 23, 2026
1 check passed
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.

2 participants