Explicación Simple (Simple Explanation)

Habilidad de Explicación Simple (SES)

Da la respuesta primero, en palabras llanas. Añade profundidad en capas que el lector pueda saltar. Nunca sacrifiques la verdad por la simplicidad.

La forma: respuesta, luego mecánica, luego detalle

Ordena la explicación por lo que el lector necesita, no por cómo lo aprendiste tú:

1. La respuesta. Una o dos oraciones llanas que respondan directamente a la pregunta o enuncien el punto. Un lector que se detiene aquí tiene una imagen correcta — más pequeña, nunca equivocada.
2. Cómo y por qué. La mecánica detrás de la respuesta: la causa, la estructura, la regla en funcionamiento.
3. El detalle. Números, parámetros, casos límite, excepciones, prueba. La parte que la mayoría de los lectores salta — y la parte que aún debe estar ahí cuando alguien vuelva a buscarla.

Mantén la forma con estas reglas:

• Termina cada capa antes de empezar la siguiente. Nunca intercales resumen y detalle.
• Haz las capas visibles y saltables: un salto de párrafo, un encabezado en negrita, una etiqueta, un título o un expandible cuando el medio lo permita.
• Una salvedad que cambie la respuesta pertenece junto a la respuesta. Los riesgos de seguridad, pérdida de datos, cambios disruptivos y costos reales nunca se colocan en una capa inferior.
• Los pasos se mantienen en orden de dependencia. Organiza la prosa alrededor de un procedimiento — resultado y condiciones previas primero, luego los pasos numerados, luego los casos de fallo — pero nunca reordenen los pasos por importancia.
• La profundidad sigue a la pregunta. Una respuesta en un chat puede necesitar una capa; un documento de diseño puede necesitar cuatro. Nunca alargues una explicación para llenar la forma.

Las palabras

• Empieza con el actor y el verbo: "la caché devuelve datos obsoletos", no "los datos obsoletos pueden ser devueltos".
• Usa un nombre para una cosa, el mismo nombre cada vez. Cambiar de nombre se lee como cambiar de cosa.
• Prefiere la palabra corta común: usa, inicia, ayuda, muestra — no utilizar, comenzar, facilitar, demostrar.
• Pon una idea en cada oración. Trata 20 palabras como un límite; divide en lugar de apilar cláusulas.
• Pon la condición antes de la acción: "Si la compilación falla, verifica el archivo lockfile" — no al revés.
• Define un término en media oración donde el lector lo encuentre. No adelantes contexto.
• Convierte sustantivos abstractos de nuevo en verbos: "analiza el registro", no "realiza un análisis del registro".
• Elimina rellenos, intensificadores y elogios vacíos: muy, robusto, sin fisuras, potente, completo, "es importante señalar".
• Da números en lugar de adjetivos: "de 40 s a 6 s" es mejor que "drásticamente más rápido".

El mínimo: simple, nunca menos verdadero

• Conserva cada hecho, número, advertencia y salvedad. Simplificar mueve el detalle a una capa inferior; nunca lo elimina.
• No inventes ejemplos, evidencia o confianza que la fuente no tenga. Cuando algo sea desconocido, dilo claramente.
• Trata una analogía como un puente, no como una prueba. Si el lector se apoyará en ella, di dónde se rompe.
• Cuando la simplicidad y la exactitud entren en conflicto, la exactitud gana — luego sigue trabajando para hacer que la versión exacta sea simple.

Ejemplo

Antes — verdadero, completo, difícil de usar:

Una transacción es una secuencia de sentencias tratada como una unidad de trabajo indivisible — iniciada implícitamente en la primera sentencia y terminada por COMMIT o ROLLBACK — un constructo que importa porque muchas operaciones de varios pasos solo son correctas cuando se ejecutan atómicamente.

Después — los mismos hechos, en capas:

Una transacción es un grupo de sentencias que todas tienen éxito o todas fallan juntas.

Comienza en la primera sentencia y termina con COMMIT (conservar los cambios) o ROLLBACK (deshacerlos).

La agrupación es importante porque algunas operaciones solo son correctas como un todo: una transferencia que debita una cuenta sin acreditar la otra dejaría dinero perdido.

Verifica antes de entregar

• ¿La primera oración responde a la pregunta?
• ¿Puede el lector detenerse después de cualquier capa y seguir siendo correcto?
• ¿Las advertencias y las salvedades que cambian la respuesta están en la capa superior?
• ¿Hay alguna palabra más corta o más común que conserve el significado?
• ¿Sobrevivieron todos los hechos, números y salvedades?