¿Qué documentación debe dejar un despliegue?
La suficiente para que alguien de fuera lo mantenga dentro de dos años sin ti. Cuatro documentos: el registro, la especificación, el proceso y las decisiones. El registro es el que más cuenta, y las decisiones son las que no se escriben nunca.
El registro
Qué etiqueta está dónde, qué lleva, cuándo se colocó y cuándo se sustituyó.
Ese es el entregable. Las etiquetas son consumibles y el registro es el activo, y tiene que poder exportarse en un formato legible sin el software que lo produjo.
Sin él, sustituir una etiqueta es adivinar, retirar un emplazamiento es adivinar, y una auditoría es imposible.
Guárdalo en un sitio que dure más que el proyecto, que normalmente significa no en una hoja de cálculo en el ordenador de una persona.
La especificación
La referencia del chip y el tipo de etiqueta del NFC Forum. El soporte y el adhesivo. El proveedor y el lote.
Lo suficiente para que alguien pueda volver a pedir lo mismo, y lo suficiente para reconocer cuándo una entrega no es lo mismo.
Incluye el método de montaje y la superficie, porque una sustituta colocada de otra forma fallará de otra forma.
E incluye el motivo de cualquier cosa poco habitual, como por qué se eligió una etiqueta para metal en una superficie que parece de madera.
El proceso
Cómo se escribe, se comprueba, se instala y se anota una etiqueta, en orden, como pasos que alguien pueda seguir.
En qué consiste la comprobación y qué aspecto tiene un aprobado.
Qué hacer con una etiqueta que falla en cada fase.
Es lo que permite que el despliegue crezca sin ti, y su ausencia es la razón de que los despliegues dejen de crecer cuando su autor se va.
Las decisiones y su porqué
El único documento que nadie escribe y el que más tiempo ahorra después.
Por qué la etiqueta lleva un enlace y no contenido. Por qué la dirección está en este dominio. Por qué hay un recurso impreso. Por qué las etiquetas no están bloqueadas.
Cada una de esas cosas es una decisión que quien venga detrás revertirá si no conoce el motivo, y cada reversión sale cara.
Basta con una página de entradas cortas. Es el seguro más barato del proyecto y se escribe el último, con prisa, o no se escribe.
Preguntas frecuentes
¿Cuál es el documento más importante?
El registro de qué etiqueta está dónde y qué lleva. Las etiquetas son consumibles y el registro es el activo.
¿Por qué documentar las decisiones?
Porque quien venga detrás y no sepa el motivo las revertirá, y cada reversión cuesta más de lo que costaba escribir la razón.
¿Dónde debe vivir el registro?
En un sitio que dure más que el proyecto y del que se pueda exportar a un formato legible. No en una hoja de cálculo en el ordenador de una persona.
¿Cuánto tiempo debería llevar esto?
Unas pocas páginas. El valor está en que exista y no en que sea exhaustivo.