Una página puede tener años y seguir siendo correcta
La documentación se queda obsoleta en silencio y se audita por fecha, lo que marca las páginas que nadie necesitaba cambiar y se pierde la página que quedó mal el martes pasado.
La edad es un mal indicador. Una página conceptual escrita hace dos años puede ser perfectamente exacta, mientras una guía de inicio rápido editada el mes pasado puede estar mal porque un valor por defecto cambió debajo.
Estar mal es una relación entre dos cosas: lo que el código hace ahora y lo que la página dice que hace. Comprobarlo implica leer ambos. La lectura es estrecha: nombres de parámetros, valores por defecto, formas de retorno y el orden requerido.
Marcar con la contradicción citada es lo que hace esto usable. Una lista de páginas posiblemente obsoletas se ignora. Una lista que dice que esta línea dice X y el código ahora hace Y se corrige.
Cómo se ejecuta el ActionFlow en el lienzo
Dos insumos alimentan el flujo. Un nodo GitHub entrega los cambios fusionados desde la última comprobación. Un nodo Notion o HTTP Request entrega las páginas de documentación publicadas.
Un nodo Filter reduce los cambios a los que tocan una superficie pública (firmas, valores por defecto, configuración, tipos públicos), porque un refactor interno no puede dejar una página mal.
Un nodo Loop recorre los cambios restantes. Por cada uno, un nodo Generate Object devuelve los pasajes de documentación que describen el comportamiento cambiado, citados.
Una segunda pasada de Generate Object juzga cada pasaje contra el cambio y devuelve uno de tres estados: contradicho con la cita, incompleto o no afectado.
La respuesta de tres estados es lo que mantiene corta la salida. La mayoría de los pasajes vuelven no afectados y nunca llegan a nadie.
Un nodo Filter conserva los hallazgos contradichos e incompletos. Un nodo Sort pone primero las contradicciones, porque esas son las que están engañando de forma activa a los lectores.
Un nodo GitHub abre un issue por cada página afectada, con la cita y el cambio. Un nodo Slack publica el conteo en el canal de documentación.
El flujo no edita ninguna página. La corrección la hace una persona, con la contradicción delante.
Nodos que usa este ActionFlow
- GitHub (Integration): los cambios fusionados desde la última comprobación.
- Notion (Integration) con HTTP Request (Util): las páginas de documentación tal como se publicaron.
- Filter (Data): reduce a los cambios que tocan una superficie pública.
- Loop (Control): una pasada por cambio, no una pasada sobre todo.
- Generate Object (AI Core): los pasajes que describen el comportamiento cambiado, citados.
- Generate Object (AI Core): contradicho, incompleto o no afectado, por pasaje.
- Sort (Data): primero las contradicciones.
- GitHub (Integration): un issue por página afectada, con cita y cambio.
Preguntas frecuentes
Empieza a crear flujos de IA
Crea una cuenta gratuita, abre una plantilla o un lienzo en blanco y ejecuta tu primer ActionFlow.
Boletín
Recibe actualizaciones del producto
Nodos nuevos, agents y notas de producto. Solo enviamos correo cuando merece la pena abrirlo.