Leer el contrato antes de ejecutar.

Runbook ilustrativo para revisar un resumen de registros. El código explica una función; la terminal es evidencia estática. Los ejemplos no ejecutan comandos sobre tu equipo.

La implementación mínima

Las líneas destacadas nombran el total y el promedio. Una entrada vacía conserva total cero y promedio ausente; no fabrica una observación.

preparar_resumen.py · Python
def resumir(registros):
    cantidades = [fila["cantidad"] for fila in registros]
    total = sum(cantidades)
    if not cantidades:
        return {"total": 0, "promedio": None}
    return {"total": total, "promedio": total / len(cantidades)}
Ejemplo ilustrativo. Las líneas 3 y 6 explican el cálculo; el botón copia el código sin números de línea.

Una salida que se puede copiar

Usa la terminal para mostrar texto exacto, unidades y contexto. El botón copia la salida sin añadir números de línea.

saldo por bolsillo · ejemplo ilustrativo 
       rango   bolsillos        total COP
  ------------  ---------  ---------------
  menos de $100        349            5.120
    más de $1M          5    14.434.490
Datos ilustrativos. La columna que importa va señalada, no en negrita.

El mismo argumento, varios lenguajes

Las pestañas agrupan ejemplos relacionados. No sustituyen capítulos con preguntas distintas.

Código que también se puede leer

Elige un lenguaje. El coloreado conserva exactamente el texto que copias.

HTML
<article class="nota">
  <h2>Una decisión con contexto</h2>
  <p>La evidencia se conserva completa.</p>
</article>
CSS
:root {
  --espacio: 24px;
}
.nota {
  display: grid;
  gap: var(--espacio);
  color: var(--tinta);
}
JavaScript
// Datos de ejemplo, sin solicitudes
const registros = [12, 8, 5];
const total = registros.reduce((suma, n) => suma + n, 0);
console.log("Total:", total);
TypeScript
type Registro = { nombre: string; valor: number };
const ejemplo: Registro = { nombre: "Diseño", valor: 12 };
function leer(r: Registro): number {
  return r.valor;
}
JSON
{
  "edicion": "cuaderno",
  "paginas": 9,
  "sonido": false,
  "fuente": null
}
Python
# Ejemplo local
registros = [12, 8, 5]
def total(valores):
    return sum(valores)
print("Total:", total(registros))
SQL
-- Consulta ilustrativa
SELECT equipo, SUM(importe) AS total
FROM movimientos
WHERE estado = 'confirmado'
GROUP BY equipo
ORDER BY total DESC;
Shell
# Comprobaciones locales
python3 scripts/build.py
python3 scripts/validate.py
echo "Listo para revisar"
Salida
OK     documento generado     44 recetas
WARN   fuente pendiente       2 registros
ERROR  ejemplo rechazado      1 recurso externo

Fallos y límites visibles

Un aviso tiene significado escrito y un icono; el color acompaña el estado. La animación se cancela con movimiento reducido.