Repository navigation
docs: add Universal design principles page and Verdicts hero - #50
Open
anahernandez-dev wants to merge 4 commits into
Open
anahernandez-dev wants to merge 4 commits into
anahernandez-dev wants to merge 4 commits into
Conversation
- Add a Universal design principles page (Principles 1–7 and the Guardrail), pinned between Introduction and Foundations - Add header images to Universal design principles and Verdicts; the Verdicts hero is emitted by build-verdicts-page.mjs so the page stays in sync with verdicts:check - Data tables: right-align numeric columns and their labels Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A new build was pushed to Chromatic! 🚀 |
- Remove Strategy links; they weren't tied to a defined org-level list - Principle 3: use wayfinding and student queue examples - Principle 5: say what the teacher wants in the example; clarify and trim Rules out items - Quote the user's Big 4 question so it reads apart from the design check - Clarify Principle 2's "numbers" item, Principle 7's Big 4 check, and the Guardrail's student data item Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Principle 2: add Rules out for unranked problems and links that make users hunt; drop the item Principle 4 already covers - Principle 5: say "without extra steps"; rework Rules out around skippable setup and clarity over step count; plain-language Big 4 check - Principle 6: "any part of the product" instead of naming products - Principle 7: drop the draft note; "Messages" not "Error messages" so it matches the principle's own definition of errors - Use a user-role prefix on every example; drop "in classrooms" and a second-person slip in Principle 3; shorten the intro Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This branch has not been deployed
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.
What changed
New page: Universal design principles
__docs__/universal-design-principles.mdxcovers Principles 1–7 and the Guardrail. Each section has a description, an example, what it rules out, and a Big 4 check..storybook/preview.tsx→storySort.order).Verdicts hero image
__docs__/verdicts.mdxis generated, so the image is added inscripts/build-verdicts-page.mjs, and the page was regenerated withpnpm verdicts:page.pnpm verdicts:checkpasses.Why
Universal design principles moves from a Google Doc into the guidelines, so designers and the MCP docs tools can use it alongside Foundations, Components and Patterns.
The table column alignment fix that was here moved to its own PR, #51.
Changes since the first review
Still to confirm
Checked
pnpm typecheckandpnpm verdicts:checkpass.syl-darktheme.🤖 Generated with Claude Code