You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[plan] Reorder Quick Start 'What's next?' section and make Public Preview notice more prominent on home page #43691
Reorder the "What's next?" section in Quick Start to lead with simpler follow-up steps before the 19-part blog series, and make the "Public Preview" notice more prominent on the home page.
Context
Discussion #43686 (Documentation Noob Tester report) flagged two related UX issues:
"What's next?" leads with a 19-part blog series — overwhelming for a brand-new user. Simpler next steps like "Creating Workflows" or "How Workflows Work" should come first.
"Public Preview" warning is easy to miss on the home page — appears in small text beneath the tagline, but is a significant caveat for production use.
docs/src/content/docs/index.mdx (elevate Public Preview notice)
Implementation Plan
Approach
Fix 1 — Reorder "What's next?"
Open quick-start.mdx and find the "What's next?" / next steps section.
Reorder links/cards so that beginner-friendly destinations (e.g., "Creating Workflows", "How Workflows Work") appear before the blog series link.
The blog series link should remain — just move it to the end of the list.
Fix 2 — More prominent Public Preview notice on home page
Open docs/src/content/docs/index.mdx.
Locate the existing "Public Preview" text.
Elevate it using a Starlight <Aside type="caution"> or similar callout component so it is visually prominent, rather than appearing as small body text.
Files to Modify
docs/src/content/docs/setup/quick-start.mdx
docs/src/content/docs/index.mdx
Acceptance Criteria
"What's next?" in Quick Start leads with simpler follow-up steps; blog series is last
The Public Preview notice on the home page uses a visible callout/badge that cannot be missed
Both pages render correctly (no broken MDX/markdown)
Generated by 📋 Plan Command · 27.1 AIC · ⌖ 10.7 AIC · ⊞ 4.9K · ◷ Comment /plan to run again
Activity
github-actions commentedon Jul 8, 2026
This issue was automatically closed because it expired on 2026-07-08T05:34:56.693Z.