Voice ForgeTHE DOCUMENTATION
v2.9.1
SOURCE REFERENCE Generated from the current plugindocs/examples/divulgacion-es/rules.md

divulgacion-es

1. Identity and context

  • Language and register: español, divulgativo y cercano
  • Genre and document types: entradas de blog y capítulos cortos que explican ideas de estadística
  • Purpose: explicar una idea de estadística con un ejemplo que el lector pueda seguir sin fórmulas
  • Readers: lectores generales sin formación técnica
  • Field and venues: blog personal y boletín
  • Conventions: títulos en minúscula salvo la primera palabra; comillas «»
  • Topics: promedios, probabilidad, encuestas, sesgos
  • Scope: textos de divulgación en español; no artículos académicos ni correos

2. Document architecture

Status: established

  • R01 Abre con un caso concreto o una pregunta, no con una definición.
    • strength: preferred
    • kind: constraint
    • applies: el primer párrafo de cada entrada
    • except: entradas que responden a una pregunta de un lector, que pueden abrir con esa pregunta citada
    • check: Lee la primera oración. PASS si presenta un caso, una escena o una pregunta. VIOLATION si define un término o anuncia el tema.
    • evidence: 20261003-1010 (promedios), 20261005-1830 (encuestas), 20261008-0915 (sesgos)
    • status: approved 2026-10-09

3. Argumentation and reasoning

Status: unknown

4. Paragraphs

Status: established

  • R02 Mantén los párrafos cortos, de dos a cinco oraciones.
    • strength: preferred
    • kind: tendency
    • applies: todo el texto
    • except: listas y citas en bloque
    • check: PASS si la mayoría de los párrafos tienen de dos a cinco oraciones. Un párrafo de una oración para dar énfasis no es una violación.
    • auto: max-paragraph-sentences 7
    • evidence: 20261003-1010 (promedios), 20261006-1200 (probabilidad), 20261008-0915 (sesgos)
    • status: approved 2026-10-09

5. Discourse and coherence

Status: unknown

6. Sentences and rhythm

Status: established

  • R03 Usa sobre todo oraciones cortas; reserva las largas para enumerar.
    • strength: preferred
    • kind: tendency
    • applies: all prose
    • except: citas textuales
    • check: Mira el texto completo. PASS si las oraciones de más de 30 palabras son raras.
    • auto: share-sentences-over 30 15
    • evidence: 20261005-1830 (encuestas), 20261006-1200 (probabilidad), 20261008-0915 (sesgos)
    • status: approved 2026-10-09

7. Vocabulary and register

Status: established

  • R04 Explica cada término técnico con palabras simples la primera vez que aparece.
    • strength: mandatory
    • kind: constraint
    • applies: términos como mediana, varianza, muestra, sesgo
    • except: palabras de uso común como promedio o porcentaje
    • check: Para cada término técnico, PASS si la misma oración o la siguiente lo explica con palabras simples.
    • evidence: stated 2026-10-02
    • status: approved 2026-10-02

8. Voice and metadiscourse

Status: established

  • R05 Trata al lector de tú, no de usted.
    • strength: preferred
    • kind: constraint
    • applies: all prose
    • except: none
    • check: PASS si el texto se dirige al lector con tú o no se dirige a él. VIOLATION por cada usted o ustedes dirigido al lector.
    • auto: no-regex \bustede?s?\b
    • evidence: stated 2026-10-02
    • status: approved 2026-10-02

9. Evidence and sources

Status: established

  • R06 Redondea las cifras y di de dónde salen.
    • strength: preferred
    • kind: preference
    • applies: cifras reales tomadas de una fuente
    • except: cifras de un ejemplo inventado, que se dicen tal cual
    • check: Para cada cifra real, PASS si está redondeada a lo que el lector necesita y nombra su fuente.
    • evidence: 20261003-1010 (promedios), 20261006-1200 (probabilidad), analysis:20261001-blog
    • status: approved 2026-10-09

10. Anti-patterns and constraints

Status: established

  • N01 Nunca uses la raya (—) ni la semirraya (–) como puntuación.

    • strength: prohibited
    • kind: constraint
    • applies: all prose
    • except: rangos de números como 1990–2000
    • check: PASS si ninguna raya se usa como puntuación.
    • auto: no-dashes
    • evidence: stated 2026-10-01
    • status: approved 2026-10-01
  • N02 Nunca uses comillas inglesas como primer nivel; usa «».

    • strength: prohibited
    • kind: constraint
    • applies: all prose
    • except: comillas dentro de una cita que ya va entre «»
    • check: PASS si toda cita o palabra marcada usa «» en el primer nivel.
    • auto: angle-quotes
    • evidence: stated 2026-10-01
    • status: approved 2026-10-01

Notes

Perfil ilustrativo, inventado para la documentación y las pruebas de Voice Forge. No es la voz de nadie.

← Back to the reference library

Find your next step