Validar comprensibilidad del lenguaje
- Dominant language
- Shell
- Stars
- 1
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
## Qué es esta tarea
Hacer una revisión interna e iterativa del lenguaje de los informes generados: ¿se entienden sin experiencia en administración de sistemas? Es una validación del equipo, no la prueba formal con usuarios externos (esa es la tarea #215).
## Qué se debe hacer
- Leer los informes generados como si fueras alguien que sabe usar la terminal pero no es sysadmin
- Identificar términos técnicos sin explicación (ej: "OOM", "journalctl", "systemd unit")
- Verificar que cada concepto técnico tiene una frase explicativa entre paréntesis
- Verificar que los pasos de solución son seguibles sin conocimiento previo
- Ajustar el prompt para reducir jerga y mejorar claridad
- Documentar los cambios realizados y por qué
## Por qué importa
La comprensibilidad es la promesa central del producto (sección 2 del documento de proyecto): "que cualquier persona entienda qué pasó". La revisión interna es un filtro rápido antes de la prueba formal con usuarios reales (Fase 9). Si el equipo no entiende un informe, un usuario externo tampoco lo hará.
## Criterio de avance
Todos los informes generados usan lenguaje accesible. Cada término técnico tiene explicación entre paréntesis. Los pasos de solución son ejecutables por alguien con acceso a terminal y sin experiencia en sysadmin.
Contributor guide
Assessment
This issue has not been assessed yet.