chore: add FAQ to better-auth docs

[ymc9]

Summary by CodeRabbit

• Documentation
  • Added FAQ section with troubleshooting steps for "Error: non exhaustive match" when running the generate command, including package configuration override instructions and dependency reinstallation guidance.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
zenstack-new-site	Ready	Preview	Comment	Nov 29, 2025 11:32pm

[coderabbitai]

Walkthrough

Added an FAQ section to the Better Auth integration documentation providing a workaround for the "Error: non exhaustive match" encountered when running zen generate. The FAQ includes package.json overrides for chevrotain and instructions for reinstalling dependencies, inserted in two locations within the document.

Changes

Cohort / File(s)	Summary
Documentation: Better Auth FAQ versioned_docs/version-3.x/recipe/auth-integration/better-auth.md	Added FAQ section with troubleshooting steps for "Error: non exhaustive match" error, including chevrotain dependency override example and node_modules reinstall instructions; placed in two locations within the document.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'chore: add FAQ to better-auth docs' accurately and concisely describes the main change: adding FAQ content to the better-auth documentation file.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch chore/better-auth-faq

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c7ef05c and 09576a2.

📒 Files selected for processing (1)

• versioned_docs/version-3.x/recipe/auth-integration/better-auth.md (1 hunks)

🧰 Additional context used

🪛 LanguageTool

versioned_docs/version-3.x/recipe/auth-integration/better-auth.md

[grammar] ~156-~156: Use a hyphen to join words.
Context: ...AQ - Why do I get the error "Error: non exhaustive match" when running "zen gene...

(QB_NEW_EN_HYPHEN)

🔇 Additional comments (1)

versioned_docs/version-3.x/recipe/auth-integration/better-auth.md (1)

154-169: Well-structured FAQ with clear workaround.

The FAQ section is well-organized, provides helpful context about the dependency conflict, and gives clear remediation steps. Placement after the integration examples and before the sample project is logical and improves documentation discoverability.