Cosa documentare nell'IT

Negli articoli precedenti abbiamo affrontato due passaggi fondamentali: da un lato l’idea che il momento migliore per documentare sia quando tutto funziona, dall'altro il concetto che un’infrastruttura “sotto controllo” non è quella priva di problemi, ma quella in cui le informazioni sono disponibili, coerenti e utilizzabili quando servono.

A questo punto la domanda diventa inevitabile:
quali informazioni dovrebbero essere effettivamente documentate?

Non tutto ciò che riguarda l’informatica di un’organizzazione ha lo stesso valore nel tempo. Alcune informazioni sono accessorie, altre diventano rapidamente obsolete, altre ancora sono così tecniche da risultare inutili per chi deve prendere decisioni. Una buona documentazione non è un archivio completo, ma un insieme selezionato di informazioni che permettono di comprendere e governare un sistema.

In altre parole, documentare non significa “scrivere tutto”, ma distinguere ciò che è utile da ciò che è solo rumore.

Non tutto va documentato, ma alcune cose sono indispensabili

In molte realtà la documentazione nasce per accumulo: manuali, appunti, file sparsi, procedure scritte in momenti diversi, spesso da persone diverse. Il risultato è un insieme voluminoso ma poco utile.

Il punto non è la quantità, ma la capacità di rispondere a domande semplici nel momento in cui serve:

• Cosa abbiamo?
• Dove si trova?
• A cosa serve?
• Chi lo gestisce?
• Cosa succede se smette di funzionare?

Se una documentazione non aiuta a rispondere a queste domande, difficilmente sarà utile nei momenti critici.

Le informazioni davvero importanti

Esistono alcune categorie di informazioni che, indipendentemente dalla dimensione dell’organizzazione, hanno un valore strutturale. Non sono dettagli tecnici fini a sé stessi, ma elementi che definiscono la capacità di controllo e di intervento.

Inventario dei sistemi e degli apparati

Sapere cosa esiste è il punto di partenza.

Perché è importante:
Un inventario chiaro permette di avere consapevolezza dell’infrastruttura reale, non di quella “presunta”.

Cosa succede se manca:
Si perde il controllo nel tempo. Dispositivi dimenticati continuano a funzionare senza essere gestiti, aggiornati o sostituiti.

Contributo alla continuità operativa:
In caso di guasto o aggiornamento, sapere esattamente cosa è presente riduce tempi di diagnosi e incertezza decisionale.

Schema generale dell’infrastruttura

Non si tratta di un diagramma tecnico dettagliato, ma di una rappresentazione comprensibile dei collegamenti principali.

Perché è importante:
Aiuta a capire come i sistemi comunicano tra loro.

Cosa succede se manca:
Ogni intervento diventa un’analisi da ricostruire da zero. Le dipendenze non sono chiare.

Contributo alla continuità operativa:
Permette di individuare rapidamente i punti critici e di valutare l’impatto di un guasto.

Servizi erogati

Non conta solo ciò che esiste, ma ciò che viene utilizzato.

Perché è importante:
Rende visibile il valore reale dell’infrastruttura.

Cosa succede se manca:
Si perde il legame tra tecnologia e attività operative. Alcuni servizi vengono sottovalutati o dimenticati.

Contributo alla continuità operativa:
Aiuta a prioritizzare gli interventi in base all’impatto sui processi di lavoro.

Fornitori e riferimenti

Ogni infrastruttura dipende anche da soggetti esterni.

Perché è importante:
Permette di sapere chi contattare in caso di problemi.

Cosa succede se manca:
Nei momenti critici si perde tempo a ricostruire contratti, contatti o responsabilità.

Contributo alla continuità operativa:
Riduce i tempi di reazione quando è necessario attivare supporto esterno.

Credenziali e modalità di accesso amministrativo

È uno degli aspetti più delicati, ma anche uno dei più trascurati.

Perché è importante:
Garantisce la possibilità di intervenire sui sistemi quando necessario.

Cosa succede se manca:
Si rischia di dipendere da singole persone o da informazioni non condivise.

Contributo alla continuità operativa:
Assicura che l’accesso ai sistemi non sia legato alla presenza di un singolo individuo.

Procedure operative essenziali

Non tutte le attività devono essere documentate, ma quelle critiche sì.

Perché è importante:
Rende ripetibili le operazioni più importanti.

Cosa succede se manca:
Ogni intervento dipende dall’esperienza personale di chi lo esegue.

Contributo alla continuità operativa:
Permette di mantenere coerenza anche in caso di cambiamento del personale.

Backup e ripristino

Non basta sapere che i dati sono salvati, è necessario sapere come vengono recuperati.

Perché è importante:
Il valore reale del backup si misura nel ripristino.

Cosa succede se manca:
Si scopre troppo tardi che il backup non è utilizzabile o non è completo.

Contributo alla continuità operativa:
Riduce l’incertezza nei momenti di emergenza e accelera il ritorno alla normalità.

Dipendenze tra sistemi e servizi

Ogni sistema è collegato ad altri, spesso in modo non immediato.

Perché è importante:
Permette di capire cosa si interrompe quando qualcosa si guasta.

Cosa succede se manca:
Un problema apparentemente isolato può generare effetti a catena imprevedibili.

Contributo alla continuità operativa:
Aiuta a valutare correttamente gli impatti e a intervenire in modo mirato.

La documentazione come strumento di governo

In questo percorso emerge un punto centrale: la documentazione non è un archivio tecnico, ma uno strumento di governo dell’infrastruttura.

Molte organizzazioni non hanno un problema di tecnologia, ma di conoscenza distribuita e non strutturata.

Quando le informazioni sono frammentate, l’infrastruttura diventa dipendente dalle persone che la conoscono. Quando invece sono organizzate in modo essenziale e coerente, l’infrastruttura diventa comprensibile anche a chi non l’ha costruita.

Conclusione

Documentare non significa descrivere ogni dettaglio tecnico, ma conservare le informazioni necessarie affinché l’infrastruttura possa essere compresa, gestita ed evoluta nel tempo.

Una buona documentazione non elimina la complessità, ma la rende affrontabile. Non sostituisce l’esperienza, ma la rende condivisibile. E soprattutto, riduce la dipendenza dalle singole persone, trasformando la conoscenza da elemento individuale a patrimonio dell’organizzazione.