directory changes and restructuring
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,57 @@
|
||||
# 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
|
||||
|
||||
Reference in New Issue
Block a user