Casi nadie disfruta documentando, pero la documentación no es un extra: es parte del producto, tan parte como el código. Lo descubrí cuando el README de mi plugin de Jitsi para Moodle superó las 600 líneas y dejó de servir. Por qué la evitamos (la maldición del conocimiento), por qué una herramienta brillante con mala documentación pierde frente a una mediocre con buena documentación, las cuatro necesidades que cubre una buena doc, por qué una doc desactualizada es peor que ninguna, y un giro muy de 2026: ahora la documentación también la leen los agentes de IA. Lo que publiqué hoy es solo un primer paso; vendrán guías paso a paso.