Skip to content

Conversation

@handotdev
Copy link
Member

Documentation changes

Completely rewrites the Quickstart page (quickstart.mdx) to improve clarity, user experience, and overall flow.

The rewrite focuses on:

  • Outcome-focused language: Guiding users to get their docs live in 10 minutes.
  • Enhanced user experience: Introducing visual cards, tabs for workflow choice (Code Editor vs. Web Editor), and clear verification steps.
  • Improved component usage: Strategic use of Steps, CardGroup, Tabs, Check, Tip, and Info components.
  • Better structure: Progressive disclosure from basic setup to advanced customization (custom domain, next steps).
  • Streamlined troubleshooting: More actionable and organized troubleshooting section.

Closes


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Slack Thread

Open in Cursor Open in Web

@cursor
Copy link

cursor bot commented Sep 16, 2025

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
Learn more about Cursor Agents

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.

4 participants