Skip to content

docs(design): draw the guide page, 1440 and 390 (TASK-757) - #3187

Closed
lilyshen0722 wants to merge 1 commit into
mainfrom
ux/task-757-guide-main
Closed

lilyshen0722 wants to merge 1 commit into
mainfrom
ux/task-757-guide-main

Conversation

@lilyshen0722

Copy link
Copy Markdown
Contributor

Written by Ux Lead, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

TASK-757 item 1 of 9: the guide page (/guides/:guideId, 2,250 views), drawn into the d215 artboard at 1440 and 390, light and dark.

  • New data-surface="guide" section: top-of-page and foot-of-page frames at both widths (data-state, so cap/measure_after.js and targets.json do not move).
  • Public-page primitives (.pub, .pubbar, .art, .cta) are added at the end of the artboard CSS so the landing, use-cases and legal frames can reuse them.
  • Styled after the connectors page: the same tokens, details.disc for questions, .b-c as the one cobalt action.
  • Content is taken from the live guide multi-agent-collaboration-platform; copy is trimmed, nothing added to the page that the live component does not render, except a section chip row (called out in the notes).

No app code changes; the lift PR comes after this merges. Based on main, not on #3184.

Screenshots (1440/390, light/dark) are in the Sharpen pod thread for this PR.

🤖 Generated with Claude Code

Public article shell: top bar, one 700px reading column, folded provenance,
question disclosures and a single cobalt call-to-action block. Top and foot
frames at both widths; data-state so the measure script skips them.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Co-authored-by: ux-lead <WyJ1eC1sZWFkIiwiZGVmYXVsdCJd@agents.commonly.invalid>
Agent-Model: claude/claude-opus-5-5/high
@coderabbitai

coderabbitai Bot commented Nov 1, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

Caution

Review failed

The pull request is closed.

Walkthrough

The D215 artboard adds a Guide page example for desktop and mobile layouts. It includes article content, provenance, FAQ disclosures, a call to action, and related links. The surface navigation now links to the Guide page.

Changes: Guide Page Design

Layer / File(s) Summary
Guide page layout and navigation
docs/design/artboards/d215/index.html
Adds public-page styles, desktop and mobile Guide page mockups, and a surface navigation link to the Guide page.

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Possibly related PRs

Merge Risk: Moderate · up to 22ba7

Readers cannot scroll through the guide mockup, and the new frames block target regeneration. Fix those issues before merging; the section chips also need to match the documented navigation behavior.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

@lilyshen0722

Copy link
Copy Markdown
Contributor Author

Closing without merging. The guide pages are marketing, which is now out of the product artboard queue: the guide pages carry search traffic, and their prerender, meta tags and structured data must not be touched by a shell rebuild. Marketing pages get only the AI-slop sweep and the shared tokens, and Growth owns any change there, checked with a before/after crawl.

The branch stays as a reference for that work.

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