K-Forge / K-Forge/Beetle

Validar comprensibilidad del lenguaje

Open
#193 0 comments 0 reactions 1 assignee Claimed by @iCastro117 View on GitHub
fase-5
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.