Andrew Yim
236be6c580
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2.0 KiB
2.0 KiB
FAQ Database
Purpose: Organize frequently asked questions with answers.
Schema
| Property | Type | Options | Purpose |
|---|---|---|---|
| Question | title | - | The question being asked |
| Category | select | Product, Engineering, Support, HR, General | Question topic |
| Tags | multi_select | - | Specific topics (auth, billing, onboarding, etc.) |
| Answer Type | select | Quick Answer, Detailed Guide, Link to Docs | Response format |
| Last Reviewed | date | - | When answer was verified |
| Helpful Count | number | - | Track usefulness (optional) |
| Audience | select | Internal, External, All | Who should see this |
| Related Questions | relation | Links to related FAQs | Connect similar topics |
Usage
Create FAQ entries with properties:
{
"Question": "How do I reset my password?",
"Category": "Support",
"Tags": "authentication, password, login",
"Answer Type": "Quick Answer",
"Last Reviewed": "2025-10-01",
"Audience": "External"
}
Content Template
Each FAQ page should include:
- Short Answer: 1-2 sentence quick response
- Detailed Explanation: Full answer with context
- Steps (if applicable): Numbered procedure
- Screenshots (if helpful): Visual guidance
- Related Questions: Links to similar FAQs
- Additional Resources: External docs or videos
Views
By Category: Group by Category Recently Updated: Sort by Last Reviewed descending Needs Review: Filter where Last Reviewed > 180 days ago External FAQs: Filter where Audience contains "External" Popular: Sort by Helpful Count descending (if tracking)
Best Practices
- Use clear questions: Write questions as users would ask them
- Provide quick answers: Lead with the direct answer, then elaborate
- Link related FAQs: Help users discover related information
- Review regularly: Keep answers current and accurate
- Track what's helpful: Use feedback to improve frequently accessed FAQs