Skip to content

docs: Add FAQ section#303

Open
meichuanyi wants to merge 1 commit into
JoshuaC215:mainfrom
meichuanyi:docs-add-faq
Open

docs: Add FAQ section#303
meichuanyi wants to merge 1 commit into
JoshuaC215:mainfrom
meichuanyi:docs-add-faq

Conversation

@meichuanyi

Copy link
Copy Markdown

This PR adds a comprehensive FAQ section to the README, covering:

  • Project overview and comparison with similar frameworks
  • Core concepts and architecture
  • Getting started guide
  • LLM provider support
  • Key features and use cases
  • License and help resources

The FAQ helps users quickly understand the project and find answers to common questions.

JoshuaC215 pushed a commit that referenced this pull request Jun 30, 2026
- #261: the contributor's real question in #259 (how to supply IndexConfig
  at the initialize_store() call site when it needs an embedding function,
  not an .env string) was never answered. Rewrote the draft to answer it:
  put model name + dims in settings, build IndexConfig inside
  initialize_store() (config-driven, off by default), with a snippet.
- SKILL.md: add "answer the contributor's actual question first" pattern —
  check linked issues for an unanswered ask before jumping to test/lint.
- #298, #303 marked Approved per Joshua.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ALYJSRixXCfLsmb2Koc1Hi
@JoshuaC215

Copy link
Copy Markdown
Owner

Hey @meichuanyi — thanks for putting this together! An FAQ could be useful, but 147 lines is a lot to add to the README, and some of it (the framework comparisons especially) I'd need to go through carefully for accuracy and overlap with what's already documented.

Could you trim it to the few questions that genuinely come up a lot, and double-check the claims against the current code/docs? If it grows beyond that, a dedicated page under docs/ might be a better home than the README. Appreciate the contribution!

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.

2 participants