docs: update all documentation and add AI tooling configs
- Rewrite README.md with current architecture, features and stack - Update docs/API.md with all current endpoints (corporate, BI, client 360) - Update docs/ARCHITECTURE.md with cache, modular queries, services, ETL - Update docs/GUIA-USUARIO.md for all roles (admin, corporate, agente) - Add docs/INDEX.md documentation index - Add PROJETO.md comprehensive project reference - Add BI-CCC-Implementation-Guide.md - Include AI agent configs (.claude, .agents, .gemini, _bmad) - Add netbird VPN configuration - Add status report Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,52 @@
|
||||
# Tone of Voice Example: SaaS Onboarding Tool
|
||||
|
||||
**Context:** B2B SaaS for employee onboarding, target users are HR managers (stressed, overwhelmed, want to feel capable)
|
||||
|
||||
---
|
||||
|
||||
## Suggested Tone of Voice
|
||||
|
||||
### Tone Attributes
|
||||
|
||||
1. **Supportive & Reassuring**: HR managers are stressed about onboarding. Our tone should reduce anxiety, not add to it.
|
||||
2. **Professional but Warm**: B2B context requires professionalism, but warmth builds trust.
|
||||
3. **Clear & Concise**: Busy users need straightforward communication, no fluff.
|
||||
4. **Empowering**: Frame actions around user capability, not system features.
|
||||
|
||||
### Examples
|
||||
|
||||
**Error Message:**
|
||||
- ✅ "We couldn't find that email. Double-check for typos?"
|
||||
- ❌ "Error 404: User not found"
|
||||
|
||||
**Button Text:**
|
||||
- ✅ "Add your first employee"
|
||||
- ❌ "Create new record"
|
||||
|
||||
**Empty State:**
|
||||
- ✅ "Your onboarding dashboard is ready. Let's add your first employee to get started."
|
||||
- ❌ "No employees added yet"
|
||||
|
||||
**Success Message:**
|
||||
- ✅ "Perfect! Sarah's onboarding is set up. We'll send her the welcome email tomorrow at 9 AM."
|
||||
- ❌ "Employee record created successfully"
|
||||
|
||||
---
|
||||
|
||||
## Analysis
|
||||
|
||||
**Why This Tone Works:**
|
||||
- **Supportive**: "We couldn't find" (collaborative) vs "Error" (blaming)
|
||||
- **Professional but Warm**: Uses proper grammar but friendly language
|
||||
- **Clear**: Specific, actionable messages without jargon
|
||||
- **Empowering**: "Add your first employee" (user action) vs "Create new record" (system function)
|
||||
|
||||
**Alignment with User State:**
|
||||
- HR managers are stressed → Reassuring tone reduces anxiety
|
||||
- Want to feel capable → Empowering language focuses on their actions
|
||||
- Need efficiency → Clear, concise messaging respects their time
|
||||
- Professional context → Maintains appropriate formality with warmth
|
||||
|
||||
---
|
||||
|
||||
_Example demonstrating Tone of Voice definition for B2B SaaS product_
|
||||
Reference in New Issue
Block a user