Skip to content

feat(docs): release 0.16.0 with a sidebar built from Equality's Nav parts - #212

Open
matthewmr-eqty wants to merge 3 commits into
docs/grd-193-nav-pagefrom
feat/grd-193-docs-sidebar
Open

matthewmr-eqty wants to merge 3 commits into
docs/grd-193-nav-pagefrom
feat/grd-193-docs-sidebar

Conversation

@matthewmr-eqty

@matthewmr-eqty matthewmr-eqty commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

Review focus

Merging publishes @eqtylab/docs 0.16.0, which needs Equality 5.1.0. Stacked on #211, which is stacked on #210: review only the last two commits. Start with DocsNavList.tsx, then NavTree.astro.

Need

Docs sites should get their sidebar from Equality, so it matches Studio and fixes land in one place.

Problem

The docs sidebar was its own <details> tree, with its own script, styles and current-row colour.

Change

  • The sidebar renders on NavListExpandable and NavListItem; the old group script goes.
  • Rows are 36px, and the current row is grey, matching search's selected result.
  • Links to other sites get Equality's ↗ and screen-reader text.
  • The site card, header links and landing links hover with the same tint as the rows.
  • Links and inline code in tables and alerts are styled again.

Evidence

docs tests (218 + 7), the build, lint, Prettier and astro check pass on this branch.

Not covered

A folder header does nothing until the sidebar's script loads, at the page's first idle moment or half a second at most.

Part of GRD-193 · GRD-81

🤖 Generated with Claude Code

@matthewmr-eqty
matthewmr-eqty added this pull request to stack #213 October 30, 2026 20:12
@matthewmr-eqty
matthewmr-eqty force-pushed the feat/grd-193-docs-sidebar branch from dfbc6d6 to a8d615c Compare October 30, 2026 20:30
@matthewmr-eqty
matthewmr-eqty marked this pull request as draft October 30, 2026 20:41
@matthewmr-eqty
matthewmr-eqty marked this pull request as ready for review October 30, 2026 20:53
matthewmr-eqty and others added 3 commits October 30, 2026 16:54
…arts

Need: readers of every docs site should get the same sidebar as Equality's Nav, with folders that open and close.
Problem: the docs sidebar was a hand-rolled details tree with its own script, colours and row sizes.
Solution: DocsNavList renders the sidebar and drawer from NavList and NavListExpandable, opening the folders that hold the current page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Need: readers should see that a link in a table or alert is a link.
Problem: tables and alerts render through Equality and are marked as chrome, so the prose styles skipped everything inside them.
Solution: links and inline code inside tables and alerts take the prose link and code styles.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… values intact

Need: Readers without JavaScript and screen reader users need every sidebar link and its states.
Problem: A closed folder could never open without JavaScript, `aria-*: true` from config rendered as an empty value, and two links with one label shared a key.
Solution: A noscript rule shows every folder open, `aria-*` keeps "true", and row keys include their position.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@matthewmr-eqty
matthewmr-eqty force-pushed the feat/grd-193-docs-sidebar branch from e254a18 to 8830fdb Compare October 30, 2026 20:54

This branch has not been deployed

No deployments
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