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

1. Use clear questions: Write questions as users would ask them
2. Provide quick answers: Lead with the direct answer, then elaborate
3. Link related FAQs: Help users discover related information
4. Review regularly: Keep answers current and accurate
5. Track what's helpful: Use feedback to improve frequently accessed FAQs