Skip to content

docs(qa): Docs 3.0 QA round 2 — header tabs, footer, nav colors, alignment - #170

Closed
soamdesai-tfh wants to merge 1 commit into
mainfrom
soam/developer-docs-qa-51c376
Closed

docs(qa): Docs 3.0 QA round 2 — header tabs, footer, nav colors, alignment#170
soamdesai-tfh wants to merge 1 commit into
mainfrom
soam/developer-docs-qa-51c376

Conversation

@soamdesai-tfh

Copy link
Copy Markdown
Contributor

Second design-QA pass against the World Website Handoff Figma ("Homepage - live" annotated frame + the updated `Developer Docs / Desktop 1728px` design frames).

The six requested fixes

  1. Align main content and hero width (homepage) — the Mintlify header container was `max-w-8xl` with 48px gutters (logo at ~169px) while the hero/content sit at 96px. The navbar (both rows) now uses the 1728px design frame with 96px gutters, so logo, tabs, hero, and content share the same left edge. Docs pages pull the sidebar wrapper to the same frame (sidebar text lands at 96px under the logo).
  2. New header design — took the sanctioned fallback plus polish: added Resources and Support as dropdown tabs (native `menu` tabs), with the design's hairline divider separating them from the page tabs, and restyled the tab bar to the design language — ink labels, black pill on the active tab (inverted in dark mode), no underline, search entry as the quiet bordered pill. The full floating single-row pill header would require fragile CSS surgery on Mintlify's two-row DOM, so it was skipped per the "if that's too complicated" note.
    • Resources: World Tech Blog / Open Source / Whitepaper / Ecosystem
    • Support: Telegram Support Channel / Email Support / Mini Apps FAQ
    • The old global sidebar anchors (Telegram/Email/GitHub) moved into these menus — the design's sidebar shows no anchors. Shout if you want them back.
  3. Missing footer — docs pages now render a footer via `footer.links`, restyled to the design's single row: `™ 2026 World` left, six ink links right, aligned to the 96px gutters. Social icons are hidden per the design (one-line revert if unwanted). "Powered by Mintlify" was left untouched. The homepage keeps its hand-built footer.
  4. Chat window removed — the floating draggable assistant launcher (bottom-left) is hidden via CSS (there is no docs.json toggle for it); the assistant stays reachable from the header.
  5. World Tech link — now `https://world.org/blog?blog_type=world-tech\` in both visibility twins, underlined per the design.
  6. Sidebar selected color — neutral pill per the design (`#F3F2F0` bg, `#181818` text, 6px radius) instead of theme blue, with a dark-mode equivalent; the blue Proof-of-Human badge swap is dropped to stay monochrome.

Detail pass from the design frames

Since the Figma comments were unreachable this session (see note below), I diffed the design frames against the live implementation directly:

  • World Tech Updates rows: hairline dividers above each row and below the last (`#E1DFDA`), 40px row padding, description max-width 886px, "Go to World Tech" underlined with 48px top margin
  • Hero: sub max-width 487px (wraps like the mock), 24px gap under the title
  • Developer stories: cards 756px at 1536 content width with a 24px gap; the track now bleeds into the right gutter so the third card peeks past the content edge exactly as in the mock (cards land at x = 96 / 876 / 1656 at 1728px)
  • Product cards: icons 40px → 32px, row gap 113px
  • Section rhythm: hero → cards 160px, then 240px between sections

Not done / for review

  • Figma comment details — Soam's seat can't read comments via API, and the Claude-in-Chrome session workflow wasn't available this run. If any comment-level nits aren't covered by the above, they'll need one more pass.
  • Newsletter — still commented out pending a public subscribe endpoint (worldcoin/company-website#4481).
  • Resources/Support menu contents — the design shows the dropdowns closed, so the entries are my best mapping; happy to swap in the intended lists.

Verified locally with `mint dev` at 1728px/desktop/mobile, light + dark, plus `mint broken-links` and `cspell` (both clean).

…alignment

Design QA fixes against the World Website Handoff Figma (Homepage - live,
node 78456-89219):

- Align the navbar container with the page content: 1728px frame with
  96px gutters at desktop, so the logo, tabs, hero, and content share
  the same left edge (docs pages pull the sidebar wrapper to match).
- Add Resources and Support dropdown tabs to the navigation, separated
  from the page tabs by a hairline divider per the new header design.
  Their menus absorb the old global sidebar anchors (Telegram, email,
  GitHub), which the design drops from the sidebar.
- Restyle tabs to the design language: ink labels, black pill for the
  active tab (inverted in dark mode), no underline indicator; search
  entry restyled to the quiet bordered pill.
- Add the missing footer on docs pages via footer.links, restyled to
  the design's single row: ™ 2026 World left, six ink links right.
- Hide the floating assistant chat launcher; the assistant remains
  reachable from the header.
- Update the Go to World Tech link to /blog?blog_type=world-tech (both
  visibility twins) and underline it per the design.
- Sidebar: selected item is now the neutral pill (#F3F2F0 bg, #181818
  text, 6px radius) instead of theme blue; drop the blue badge swap.
- Homepage detail pass from the design frame: hero sub width 487px,
  World Tech Updates rows get hairline dividers and 40px padding,
  story cards 756px/24px gap with right-gutter bleed, card icons 32px,
  section spacing to 160/240/240.
@mintlify

mintlify Bot commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
world 🟢 Ready View Preview Sep 10, 2026, 12:26 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@soamdesai-tfh

Copy link
Copy Markdown
Contributor Author

Superseded by the split series #171 #172 #173 #174 #175 #176 — same changes, one PR per QA fix, each with before/after screenshots in the description. This branch stays as the reference for the combined state.

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