Guía de estilo

Referencia única de estilo visual y editorial.

Propósito

Esta página define el sistema de diseño y redacción del sitio. Es la referencia obligatoria para crear o actualizar cualquier documento.

Sirve para: - Validar el tema visual (theme.scss). - Reutilizar componentes estándar. - Mantener consistencia entre secciones y autores.

Convenciones editoriales

  • Títulos claros, descriptivos y operativos.
  • Abrir procesos con un resumen ejecutivo.
  • Usar listas y pasos numerados siempre que sea posible.
  • Párrafos cortos (máx. 3–4 líneas).
  • Lenguaje directo, operativo y sin ambigüedad.

Personajes: Las aventuras de Seiton Zen

Los personajes de la historieta “Las aventuras de Seiton Zen” son un recurso pedagógico y narrativo oficial del sitio Manual Seiton. Se usan para explicar procesos, errores comunes, buenas prácticas y criterios de decisión.

Objetivo de uso

  • Acelerar comprensión (ejemplos concretos y memorables).
  • Reducir ambigüedad en “qué hacer” vs “qué no hacer”.
  • Humanizar el contenido sin perder rigor operativo.

Dónde se usan

  • Introducciones y resúmenes de procesos (1 viñeta/escena breve).
  • Secciones de Errores frecuentes, Buenas prácticas y Casos típicos.
  • Callouts específicos (preferentemente tip, caution, warning o important).
  • Páginas de onboarding (“Cómo usar el sitio”, roles, cultura).

Cómo se escriben (tono)

  • Mantener tono profesional-operativo; el humor es ligero y siempre subordinado a la claridad.
  • Un personaje = una idea: evitar diálogos largos.
  • Evitar sarcasmo, ridiculización de personas/roles o frases que generen fricción cultural.

Convención de formato (patrón recomendado)

Usa este patrón para insertar una escena o comentario breve:

::: {.callout-tip}
**Seiton Zen dice:** “Regla simple: si no hay evidencia registrada, no existe.”

- **Aplica cuando:** cierre de actividad / auditoría.
- **Evidencia mínima:** ticket + responsable + fecha.
:::

Para errores frecuentes:

::: {.callout-caution}
**Error común (Seiton Zen):** cerrar sin validar criterios de aceptación.

- **Consecuencia:** retrabajo y quejas.
- **Prevención:** checklist de cierre.
:::

Reglas de consistencia visual

  • Insertar personajes con moderación: máximo 1 intervención por pantalla (aprox. cada 600–900 palabras) salvo que la página sea formativa.
  • Reutilizar el mismo “arquetipo” para el mismo mensaje (por ejemplo, el personaje que representa calidad siempre refuerza criterios de aceptación).

Accesibilidad y buenas prácticas

  • Si incluyes imágenes/viñetas: siempre agregar alt descriptivo y evitar texto importante “solo en la imagen”.
  • Nunca sustituir pasos del proceso por narrativa: la narrativa acompaña, no reemplaza.

Jerarquía tipográfica

H1 — Título de página

Introducción breve que explique el objetivo del documento.

H2 — Sección principal

Contenido de alto nivel.

H3 — Subsección

Detalle operativo.

H4 — Detalle puntual

Uso excepcional.

Resumen ejecutivo (plantilla obligatoria para procesos)

Note

Propósito: Qué se busca lograr con este proceso.

Aplica a: Áreas / roles involucrados.

Dueño del proceso: Rol responsable.

KPIs clave: SLA Calidad Tiempo

Callouts estándar

Info: Contexto o definición.

Note

Nota: Aclaración operativa.

Tip

Tip: Buena práctica, recomendación o atajo que mejora eficiencia o calidad.

Warning

Advertencia: Riesgos o errores frecuentes.

Caution

Precaución: Situaciones que requieren especial cuidado para evitar impactos operativos, financieros o de cumplimiento.

Important

Importante: Regla no negociable.

Cards de navegación

Empieza aquí

  • Introducción
  • Cómo usar el sitio
  • Control de cambios

Procesos clave

  • Cadena de valor
  • Procesos por área
  • Roles y responsabilidades

Badges (KPIs / estados)

KPIs: SLA 24h 98%

Estado: Vigente En revisión

Listas recomendadas

Checklist

Procedimiento

  1. Recibir solicitud.
  2. Validar requisitos.
  3. Ejecutar proceso.
  4. Registrar evidencia.
  5. Cerrar y notificar.

Tablas

Matriz RACI

Actividad R A C I
Ejecutar Operaciones Dirección Comercial Finanzas

Diagramas (Mermaid)

flowchart LR
A[Inicio] --> B{¿Completo?}
B -- No --> C[Solicitar info]
B -- Sí --> D[Ejecutar]
D --> E[Cerrar]

Estándares y excepciones

ImportantEstándar
  • Flujo normal documentado.
  • Evidencia obligatoria.
WarningExcepciones
  • Requieren autorización.
  • Deben documentarse.

Control de cambios (plantilla)

Versión Fecha Cambio Autor
0.1 2025-12-16 Creación inicial Seiton

Snippets reutilizables

::: {.callout-note}
**Propósito:** …
**Aplica a:** …
**Dueño:** …
**KPIs:** <span class="seiton-kpi">…</span>
:::
::: {.seiton-card}
### Título
- Enlace 1
- Enlace 2
:::

Checklist de publicación

Back to top