La documentazione è più di un sito web

Wiki Italiano

Perché la documentazione dovrebbe essere progettata per la lettura online, l'uso offline, la stampa e la conservazione a lungo termine, invece di essere trattata come qualcosa destinato solo al web.


Della documentazione si parla spesso come se la sua forma finale fosse soltanto una scheda del browser. Questa ipotesi è comoda, ma incompleta. Una buona documentazione di solito deve funzionare in più contesti: lettura online, lettura offline, stampa, esportazione PDF, insegnamento, riunioni di revisione e conservazione a lungo termine.

Quando la documentazione viene trattata come esclusivamente web, i team tendono a ottimizzare navigazione, collegamenti rapidi ed elementi interattivi, trascurando però la portabilità. Questo rende il contenuto più difficile da riutilizzare nella formazione, più difficile da archiviare e più difficile da condividere in contesti istituzionali dove l’esportazione PDF o i fascicoli stampati restano importanti.

Il supporto alla stampa ha anche un valore di accessibilità. Alcuni lettori memorizzano meglio le informazioni sulla carta. Alcuni flussi di revisione si svolgono ancora in stanze dove i materiali stampati sono pratici. Alcuni contesti archivistici o di approvvigionamento richiedono output stampabili stabili. Supportare la stampa non è quindi nostalgia. Fa parte del rendere la documentazione più utile in contesti reali.

LetBooks ora lo tratta in modo esplicito. La piattaforma documentale deve funzionare online e offline, e la stampa o l’output PDF sono considerati modalità d’uso supportate. Per questo il modello di stampa mantiene contenuto, attribuzione, avvisi di copyright e disclaimer, rimuovendo invece il rumore di navigazione, l’interfaccia di ricerca e gli altri elementi interattivi che sulla carta non aiutano.

Questa politica riflette anche una mentalità di conservazione. Un sistema documentale che può essere stampato in modo pulito è più facile da archiviare, citare, distribuire nei workshop e usare nei contesti educativi. In questo modo dipende meno da una singola superficie di erogazione.

La documentazione è quindi più di un sito web, perché la conoscenza che contiene deve sopravvivere a più di una modalità di lettura.