Che documentazione deve lasciare un'installazione?
Abbastanza perché un estraneo la sappia mantenere fra due anni senza di te. Quattro documenti: il registro, il capitolato, il processo e le decisioni. Il registro è quello che conta di più, e le decisioni sono quelle che non vengono mai scritte.
Il registro
Quale tag sia dove, che cosa porti, quando sia stato montato, e quando sia stato sostituito.
È questa la consegna. I tag sono materiale di consumo e il registro è il patrimonio, e deve essere esportabile in una forma leggibile senza il software che l'ha prodotto.
Senza di lui, sostituire un tag significa indovinare, ritirare una postazione significa indovinare, e una verifica è impossibile.
Tienilo da qualche parte che sopravviva al progetto, il che di solito significa non in un foglio di calcolo sulla macchina di una persona sola.
Il capitolato
Il riferimento del chip e il tipo di tag del NFC Forum. Il supporto e l'adesivo. Il fornitore e la serie.
Abbastanza perché qualcuno possa riordinare la stessa cosa, e abbastanza per riconoscere quando una consegna non è la stessa cosa.
Comprendi il metodo di montaggio e la superficie, dato che un sostituto montato in modo diverso cederà in modo diverso.
E comprendi la ragione di qualsiasi cosa insolita, per esempio perché sia stato scelto un tag per metallo su una superficie che sembra di legno.
Il processo
Come si scrive, si verifica, si installa e si annota un tag, in ordine, come passi che qualcuno possa seguire.
In che cosa consista la verifica e che aspetto abbia un esito positivo.
Che cosa fare di un tag che fallisce a ciascuna fase.
È questo a permettere all'installazione di crescere senza di te, e la sua assenza è il motivo per cui le installazioni smettono di crescere quando chi le ha fatte se ne va.
Le decisioni e il perché
L'unico documento che nessuno scrive e quello che fa risparmiare più tempo dopo.
Perché il tag porti un collegamento invece di un contenuto. Perché l'indirizzo sia su questo dominio. Perché ci sia un ripiego stampato. Perché i tag non siano bloccati.
Ciascuna di queste è una decisione che un successore ribalterà se non ne conosce la ragione, e ogni ribaltamento è caro.
Basta una pagina di voci brevi. È l'assicurazione più economica del progetto e si scrive per ultima, di corsa, oppure per niente.
Domande frequenti
Qual è il documento più importante?
Il registro di quale tag sia dove e che cosa porti. I tag sono materiale di consumo e il registro è il patrimonio.
Perché documentare le decisioni?
Perché un successore che non ne conosce la ragione le ribalterà, e ogni ribaltamento costa più di quanto sia costato scrivere il perché.
Dove deve vivere il registro?
Da qualche parte che sopravviva al progetto e che esporti in un formato leggibile. Non un foglio di calcolo sulla macchina di una persona sola.
Quanto tempo deve prendere?
Qualche pagina. Il valore sta nell'esistere invece che nell'essere esaustivo.