Método
Qué mirar en el diff antes de aceptar una revisión
El diff no mide visibilidad: muestra qué líneas cambian y si ese cambio responde a la petición. Aprende a revisarlo con criterio antes de aceptar.
Antes de aceptar una revisión, en el diff se mira una sola cosa: qué cambia respecto a la versión anterior y si ese cambio encaja con lo que se pidió. El diff es un control de modificación, no una medida de visibilidad: no te dice hasta qué punto un contenido se ve en los buscadores, solo qué líneas se han tocado. En la práctica, si alguien del equipo propone un cambio en una página, abre el diff, lee las líneas añadidas y eliminadas, y pregúntate si cada una responde a una instrucción concreta. Si una línea cambia sin un motivo que puedas vincular a la petición, esa línea se discute antes de aceptar.
Por qué el diff no es una medida de visibilidad
Quien trabaja con contenidos tiende a mezclar dos controles distintos. El diff responde a la pregunta «¿qué ha cambiado en el texto?». La visibilidad responde a «¿cómo aparece ese texto a quien busca?». Son dos observaciones separadas y no se sustituyen entre sí. La pregunta sobre cómo se mide la visibilidad en IA pertenece al segundo control: no se deduce leyendo un diff. En RankAI mantenemos los dos planos separados, porque mezclarlos lleva a aceptar cambios por impresión en lugar de por verificación.
La lista de comprobación operativa de RankAI
Lo que sigue es una propuesta operativa de RankAI, no un estándar universal: sirve para que el control del diff sea repetible. Cada paso tiene un criterio verificable, de modo que la decisión no dependa del gusto de quien lee.
- Lee las líneas eliminadas antes que las añadidas. Criterio: para cada línea eliminada debes poder señalar la frase de la petición que la justifica. Si no la encuentras, la eliminación se sale de lo acordado y hay que avisar.
- Comprueba que cada añadido tenga una referencia en la petición. Criterio: ninguna línea añadida debe introducir afirmaciones, cifras o nombres que la petición no contemple. Si aparece un dato que nadie pidió, se elimina o se justifica de forma explícita.
- Revisa la coherencia entre título, apertura y cuerpo. Criterio: el cambio no debe desplazar el significado de la apertura respecto al título. Si el título promete una cosa y el texto nuevo dice otra, el diff es incoherente aunque cada línea por separado parezca correcta.
- Aísla los cambios que no son de texto. Criterio: espacios, formato y saltos de línea van aparte de los cambios de contenido. Un diff lleno de ruido visual esconde los cambios reales y hay que limpiarlo antes de leerlo.
- Deja constancia de la decisión. Criterio: después de aceptar debes poder decir, para cada bloque modificado, si se aceptó, se rechazó o se aplazó. Si no sabes reconstruir ese mapa, el control no ha terminado.
Lo que a menudo se escapa es que el diff no es un documento de calidad: es una fotografía de las diferencias. Un cambio puede estar técnicamente limpio, con pocas líneas tocadas y sin errores de formato, y aun así ser incorrecto respecto al objetivo editorial. Por eso nuestra propuesta separa dos juicios: la lectura del diff, que es mecánica y verificable línea a línea, y la valoración del contenido, que exige conocer la petición y el contexto de la página. Quien acepta una revisión mirando solo el color verde o rojo se salta el primer juicio y finge haber hecho el segundo. Un diff bien leído, en cambio, deja rastro: sabes qué líneas han cambiado, por qué y qué has decidido. Es esa trazabilidad, y no la impresión de haberlo leído todo, la que hace aceptable una revisión. Si falta, la revisión se reabre antes de seguir.
Un límite que conviene tener presente
El diff solo muestra lo que ha cambiado entre dos versiones: no dice si la modificación mejora la página para quien lee, ni si el texto será visible en un buscador. Esas preguntas requieren otros controles y hay que plantearlas por separado. Cuando una medida de visibilidad no está, el producto la muestra como N/D, nunca como cero: la ausencia de un dato no es un dato negativo. Con el diff pasa lo mismo: que una línea no aparezca en la petición no te autoriza a inventarte el motivo.
Para entender cómo trata RankAI estos controles separados, consulta la página de detalle.