julian
17c08e6392
- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24) - apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004) - apps/web: React 19 + Vite 8 (ESM) - libs/shared/api-interface: Zod contract base - Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit - WDS artifacts: - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs) - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact) - Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md - AGENTS.md + README.md como entrada para devs/agentes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
77 lines
1.7 KiB
Markdown
77 lines
1.7 KiB
Markdown
# Tone of Voice - Output Template
|
|
|
|
Use this template to document the final Tone of Voice in the Product Brief.
|
|
|
|
```markdown
|
|
## Tone of Voice
|
|
|
|
**For UI Microcopy & System Messages**
|
|
|
|
### Tone Attributes
|
|
|
|
1. **[Attribute 1]**: [Brief description]
|
|
2. **[Attribute 2]**: [Brief description]
|
|
3. **[Attribute 3]**: [Brief description]
|
|
|
|
### Examples
|
|
|
|
**Error Messages:**
|
|
- ✅ "Hmm, that doesn't look like an email. Check for typos?"
|
|
- ❌ "Error: Invalid email format"
|
|
|
|
**Button Text:**
|
|
- ✅ "Let's get started"
|
|
- ❌ "Submit"
|
|
|
|
**Empty States:**
|
|
- ✅ "Nothing here yet. Ready to add your first item?"
|
|
- ❌ "No results found"
|
|
|
|
**Success Messages:**
|
|
- ✅ "You're all set! We've sent a confirmation to your email."
|
|
- ❌ "Operation completed successfully"
|
|
|
|
### Guidelines
|
|
|
|
**Do:**
|
|
- [Tone-appropriate practice 1]
|
|
- [Tone-appropriate practice 2]
|
|
- [Tone-appropriate practice 3]
|
|
|
|
**Don't:**
|
|
- [Tone-inappropriate practice 1]
|
|
- [Tone-inappropriate practice 2]
|
|
|
|
---
|
|
|
|
*Note: Tone of Voice applies to UI microcopy. Strategic content (headlines, feature descriptions, value propositions) uses the Content Creation Workshop based on page-specific purpose and context.*
|
|
```
|
|
|
|
## Example Microcopy Format
|
|
|
|
When presenting examples, use this comparison format:
|
|
|
|
```
|
|
Example UI Microcopy:
|
|
|
|
Error Message:
|
|
❌ Generic: "Error: Invalid input"
|
|
✅ Our Tone: [Rewritten in proposed tone]
|
|
|
|
Button Text:
|
|
❌ Generic: "Submit"
|
|
✅ Our Tone: [Rewritten in proposed tone]
|
|
|
|
Empty State:
|
|
❌ Generic: "No results found"
|
|
✅ Our Tone: [Rewritten in proposed tone]
|
|
|
|
Form Label:
|
|
❌ Generic: "Email address"
|
|
✅ Our Tone: [Rewritten in proposed tone]
|
|
|
|
Success Message:
|
|
❌ Generic: "Operation successful"
|
|
✅ Our Tone: [Rewritten in proposed tone]
|
|
```
|