Write a help page
Add an MDX file underwww/docs/guides/, with a title and description at the top. Explain what someone can do, then give the steps using the names shown in Goop. Add the page to the navigation in www/docs/docs.json.
Guides are handwritten. A generator does not replace them when the app changes.
Refresh generated references
From the repository root, run:www/docs/design/ui-motion.html. Generated files say where they came from. Their surrounding descriptions still need editorial review.
Add a design example
Use Button as a starting point. Describe the state being shown, include a working example, and say whether it ships in the app or is a proposal. Keep the source file beside the example so it can change with the design. To refresh the existing motion gallery, replacewww/docs/design/ui-motion.html with the updated self-contained HTML file, then run the generator. It preserves the original controls inside an isolated frame.

