Mautic deja la documentacion en manos de una IA y la revisa un humano

El proyecto open source Mautic ha empezado a delegar en una herramienta de IA la escritura de las actualizaciones de su documentacion, con revision humana antes de publicar. En unos cuatro meses ha fusionado 129 pull requests de documentacion generados por Promptless. Los redactados a mano tardaban una media de 98 dias desde que se fusionaba el codigo hasta que salia la documentacion; los suyos, 27.

El problema no era de nadie en concreto. Mautic lo mantienen voluntarios que abren pull requests en mautic/mautic mientras compaginan su trabajo y otras tareas. Actualizar la documentacion es importante, pero casi nunca urgente, y se iba posponiendo. La documentacion de usuario y la de desarrollador se quedaron atras no por dias, sino por versiones enteras.

El flujo

Promptless se conecta a los repositorios de documentacion, tanto el de usuario como el de desarrollador, y a las distintas ramas que cada uno mantiene para las versiones soportadas de Mautic. Cuando alguien abre un PR de codigo, la herramienta redacta la actualizacion correspondiente. Si el PR de codigo aun no se ha fusionado, abre el de documentacion en borrador; cuando el de codigo entra, lo marca como listo para revision. Si el desarrollador añade cambios despues, el borrador se actualiza solo.

No pasaron directamente a la automatizacion completa. Primero dejaron que la herramienta observara los PRs y publicara sugerencias en su panel, y el equipo de educacion revisaba cada una antes de convertirla en un PR real. Cuando vieron que respetaba la guia de estilo y entendia la intencion del cambio, activaron el flujo automatico.

Lo que revisan las personas

Los desarrolladores ya no escriben la documentacion, pero si repasan el borrador y confirman que refleja lo que han construido. El equipo de educacion revisa gramatica, redaccion y estilo igual que con cualquier contribucion externa.

Promptless se equivoca. Una vez redacto una seccion nueva para un menu desplegable cuyas etiquetas ya se explicaban solas, asi que solo duplicaba contenido; el autor del PR de codigo lo detecto y la herramienta retiro el PR. Otra vez describio un boton que ya no existe y un limite que se habia eliminado del codigo; el mismo autor lo señalo, la herramienta reviso el repositorio y corrigio el borrador. Aprenden de esas correcciones y el repaso pesa menos con el tiempo, pero no lo saltan.

La brecha de versiones es el dato mas claro: la aplicacion iba por la 7.0 y la documentacion se habia quedado en la 5.2. Empezaron a converger en la 7.1 y para la 7.2 ya iban rapido, justo cuando arranco el flujo automatico.

Mautic no publica cuanto cuesta Promptless ni bajo que licencia se usa, y las cifras de ahorro son suyas, sin verificacion de terceros. Aun asi, el patron es facil de replicar en cualquier proyecto con varias ramas de mantenimiento: la IA como primer borrador y una persona con la ultima palabra.