Files
odoo-expertos.com/docs/VOICE.md
T
2026-08-28 10:11:11 -03:00

122 lines
4.8 KiB
Markdown

# Brand Voice & Content Standards — Odoo Expertos
> Reference for all content agents writing or rewriting pages. Batch agents read this before touching any copy.
---
## Core Tone
**Expert. Factual. Consultative.**
Odoo Expertos speaks as a senior ERP consultant advising a B2B buyer — not as an alarmist ad. The reader is an IT manager, CFO, or Operations Director evaluating a 3-5 year ERP investment.
| Attribute | Yes | No |
|---|---|---|
| Authority | "Odoo 17 requires minimum 4 GB RAM per worker process" | "The BEST solution that will TRANSFORM your business!" |
| Evidence | "Per Odoo's public pricing page: Odoo.sh starts at €9.90/user/month" | "70% cost savings" (unsourced) |
| Urgency | A secondary CTA after factual content | H1 urgency ("ROBAN A TUS CLIENTES AHORA") |
| Expertise | Specific module names, version numbers, config steps | Generic "ERP transformation" filler |
| Citability | Short direct-answer blocks (134-167 words, self-contained) | Long preambles before the actual answer |
---
## Article Structure (all languages)
### Opening pattern (AI-citable)
Every article opens with a 40-60 word direct answer to its primary keyword query. No preamble. No "In this guide we will explore…".
```
[Keyword query]: [Direct answer in 1-2 sentences]. [Quantified specifics where available]. [One actionable next step].
```
Example for `mejor-hosting-odoo-2026`:
> El mejor hosting Odoo en 2026 depende del tamaño de tu empresa: para equipos de hasta 30 usuarios, Odoo.sh (desde €9,90/usuario/mes) ofrece actualizaciones automáticas y soporte oficial; para más de 50 usuarios, un VPS gestionado en Hetzner o DigitalOcean reduce el coste en un 40-60% según la configuración pública de Odoo.sh. Empieza comparando los planes en [odoo.sh pricing](https://www.odoo.sh/pricing).
### H2 format
Convert declarative H2s to questions where the page answers them. The ES "¿Odoo Cloud vs Hosting Propio?" pattern is the reference.
```
Good: ¿Qué infraestructura mínima necesita Odoo 17?
Bad: Infraestructura para Odoo 17
```
### Length targets
| Page type | Minimum words | Target words |
|---|---|---|
| Thin article (rewrite) | 1,500 | 1,800 |
| Category hub | 800 | 1,200 |
| Comparison page | 1,600 | 2,000 |
| How-to / setup guide | 1,800 | 2,200 |
### Evidence rules
Every factual claim needs one of:
- A link to a public data source (Odoo.com pricing, G2, Capterra, Gartner, provider pricing page)
- A methodology disclosure ("in our lab test environment with 50 concurrent users")
- Removal if neither is possible
**Prohibited claim patterns:**
- `X% ahorro/mejora/ROI` without a source URL in the same sentence
- `N,NNN reseñas verificadas` without a link to the review platform
- Fabricated case study losses or wins ("perdí $180,000", "ganamos $500,000")
- "nuestro equipo evaluó durante tres meses" without a methodology link
---
## Attribution
All content published under: **Equipo Odoo Expertos**
- `<meta name="author" content="Equipo Odoo Expertos">`
- Schema: `"author": {"@type": "Organization", "@id": "https://www.odoo-expertos.com/#organization"}`
- Visible byline (required once author pages exist): `Por Equipo Odoo Expertos · [datePublished]`
**Do not use:**
- "Dr. María Elena Rodríguez" or any fabricated individual
- "Apex AI Research Labs LLC"
- Generic "Admin" or no byline
---
## Per-language content rules
### Spanish (root — ES)
- Primary language for all new content. Fix ES canonical first; PT/FR duplicates auto-resolve.
- Titles: `[keyword principal] — [beneficio concreto] | Odoo Expertos` (max 60 chars)
- Do not use "IA" in English-target content (use "AI")
### English (EN)
- Slugs must be English (`/odoo-ai/` not `/odoo-ia/`; `/odoo-hosting/` is OK)
- No Spanish words in H1/H2/body under `lang="en"`
- Attribution in English: "Odoo Expertos Team"
### German (DE)
- Slugs in German where new (`/odoo-ki/` for AI)
- Schema strings translated: "Inicio" → "Startseite", "Hosting Odoo" → "Odoo Hosting"
- `hreflang="es"` points to root ES URL — never `/de/`-prefixed Spanish slug
### French / Portuguese (FR/PT)
- Category hub pages `/fr/odoo-hosting/`, `/pt/odoo-hosting/` to be built (currently 404)
- Content in target language, not translated-from-machine Spanish
### Arabic (AR)
- RTL correct (`dir="rtl"`, Noto Sans Arabic) — do not alter
- Author attribution: "فريق أودو إكسبرتوس"
---
## Prohibited patterns (quick checklist for agents)
```
[ ] Combat/war metaphors in H1, H2, or CTA
[ ] Emoji in H2 headings (⚔️ 🔥 etc.)
[ ] Unsourced percentage claims
[ ] Fabricated review counts
[ ] "Apex AI Research Labs LLC" in author/schema
[ ] "Dr. María Elena Rodríguez" in byline/schema
[ ] Spanish content under lang="en" or lang="de"
[ ] Title > 60 chars
[ ] Meta description identical to any other page
[ ] og:locale mismatch (e.g. es_ES on a de page)
```