Idea principal

La especificación, la documentación de soporte, el documento de encuadre se defienden a menudo por su claridad: los entiende todo el mundo, sirven en una reunión, se comparten con los equipos, se usan sin competencia técnica. Son cualidades reales, pero son cualidades de acceso, no cualidades de información.

La razón de ser de esta capa es una restricción de lectores: la mayoría de los Product Managers, comerciales y agentes de soporte no trabajan en el repositorio. Hacía falta entonces un objeto intermedio, menos fiable que el código pero legible por quienes deciden. Mientras esa restricción se mantuvo, la capa en lenguaje natural era la menos mala de las soluciones disponibles — y nadie tenía que elegir entre fiabilidad y legibilidad, ya que solo una de las dos era alcanzable.

De ahí se sigue: el día en que el acceso a la fuente deja de estar reservado a quienes saben leerla, el argumento que justificaba la capa desaparece, mientras que la capa sigue en su sitio.

Por qué es importante

Es lo que impide leer el abandono progresivo de la documentación como una relajación. La capa no se defendía por sí misma, compensaba una incapacidad de acceso; cuando la compensación se vuelve opcional, el artefacto pierde su fundamento sin que nadie lo haya decidido.

También da una prueba aplicable a cualquier documento intermedio: ¿a qué incapacidad de acceso responde? Si la respuesta es "a ninguna", duplica una información que existe en otro sitio, mejor mantenida.

Matices y límites

El acceso no lo es todo. Un documento en lenguaje natural lleva también la intención y el contexto de negocio, que el repositorio no contiene — esa parte no desaparece cuando cae la barrera de acceso.

Y poder leer el código a través de una herramienta no es lo mismo que entenderlo: la barrera se desplaza hacia la cultura técnica en lugar de borrarse.

Preguntas abiertas

• ¿Qué parte de una especificación depende del contexto de negocio y, por tanto, sobrevive al levantamiento de la barrera de acceso?