Lo que recibes, por escrito

Por qué esta página no es una referencia de API

No vendemos un producto, así que aquí no hay una API pública que documentar. Lo que sí producimos, en cada proyecto, es la documentación de los sistemas que construimos y luego operamos por cuenta del cliente. Eso es lo que describe esta página.

Importa más de lo que parece. La razón principal por la que una automatización muere en silencio unos meses después del lanzamiento es que nadie escribió cómo funciona, y la única persona que lo sabía ya no está.

Qué incluye cada proyecto

Cuando entregamos algo, viene acompañado de:

• una nota de arquitectura que explica qué hace el sistema, con qué se comunica y por qué tiene esa forma
• runbooks para las incidencias que despiertan a alguien a las tres de la mañana, escritos para que los siga quien no lo construyó
• registros de decisiones con los compromisos que asumimos y lo que descartamos, para que un cambio futuro no reabra debates ya cerrados
• un inventario de cuentas, credenciales y accesos, que muestra exactamente qué hay, dónde y en manos de quién
• un documento de traspaso, si en algún momento quieres operarlo por tu cuenta

Dónde vive

En tus sistemas, no en los nuestros. La documentación que solo vive en el wiki de una agencia es un rehén, no un activo. Va donde tu equipo ya guarda las cosas, en el formato que tu equipo ya usa.

Es tuya por completo, junto con el código y las definiciones de infraestructura, desde el primer sprint y no al final del proyecto.

Si lo internalizas

Algunos clientes nos mantienen operando un sistema indefinidamente. Otros lo internalizan cuando ya es estable. Ambas opciones nos parecen bien, y la segunda no es un fracaso que intentemos evitar haciéndonos difíciles de sustituir.

Cuando quieras asumirlo, redactamos el traspaso como es debido y acompañamos a tu equipo hasta que pueda operarlo sin nosotros. Sin dependencia forzada, sin rescates y sin descubrir que una credencial crítica solo existía en nuestro gestor de contraseñas.

Preguntas antes de empezar

Si quieres ver cómo es nuestra documentación antes de comprometerte a nada, pídelo. Te enseñamos un ejemplo anonimizado en una llamada. Es razonable querer comprobarlo.