Documentazione tecnica PDF o HTML: il formato web e gli output non sono la stessa scelta
Un buyer apre una cartella di schede tecniche in PDF. Cerca un dato necessario per valutare un prodotto, ma i nomi dei file non gli dicono quale documento consultare. Quando finalmente trova una scheda plausibile, resta un’altra domanda: è la versione corrente? Pubblicare gli stessi file in un’altra sezione del sito non risolve necessariamente il problema. Occorre rendere riconoscibile l’informazione cercata e chiarire quale documento faccia fede.
Per scegliere tra documentazione tecnica PDF o HTML conviene separare tre decisioni: dove il lettore individua il dato, quale documento gli serve per il proprio compito e come riconosce la versione corretta. Una pagina web e un PDF possono avere funzioni diverse senza che ogni informazione debba esistere in entrambi. Possono anche convivere, a condizione che il passaggio dall’una all’altro non lasci dubbi su contenuto e aggiornamento.
La scelta editoriale non coincide con il formato di output
Nel contesto dei contenuti pubblicati su GOV.UK, il Government Digital Service sostiene che le informazioni nei PDF siano più difficili da trovare, usare e mantenere rispetto ai contenuti HTML. È una motivazione per l’orientamento editoriale del proprio sito, non una misurazione dei percorsi d’acquisto nei siti B2B. Lo stesso intervento segnala che un PDF realizzato senza sufficiente cura può presentare problemi di accessibilità: non ne segue che una pagina HTML sia accessibile per il solo fatto di essere HTML.
La documentazione di DITA-OT descrive una possibilità differente: mediante i project file si possono specificare più deliverable, ciascuno con un contesto di origine, una destinazione e un formato di pubblicazione, tra cui HTML e PDF. Questa capacità risponde alla domanda «quali output possiamo produrre?», non alla domanda «quale output serve a questo buyer?». Non assicura neppure che due pubblicazioni contengano gli stessi dati o che una sia riconosciuta come versione autorevole.
Le due indicazioni si possono leggere insieme senza trasformarle in una regola universale. Pubblicare contenuti consultabili sul web è una decisione sull’esperienza informativa; produrre più formati è una decisione sul processo di pubblicazione. Prima di scegliere uno strumento o pianificare una conversione, serve stabilire quali domande il lettore deve risolvere sul sito e quando, invece, deve poter consultare un documento definito.
Assegnare un compito a ogni contenuto
Si immagini una scheda che contiene l’ingombro di una macchina. Se il buyer deve conoscere quel dato per decidere se approfondire, può essere utile renderlo individuabile nella pagina del prodotto, con il contesto necessario per interpretarlo. Se deve esaminare l’intera scheda approvata, il documento scaricabile può restare un elemento distinto del percorso. Questa è una proposta di organizzazione da verificare sui contenuti e sugli utenti dell’impresa, non una prova che un formato migliori sempre la reperibilità.
Il confronto utile non è fra due estensioni di file in astratto, ma fra il compito che si vuole agevolare e la responsabilità che si assume pubblicando l’informazione.
| Compito del lettore | Soluzione da valutare | Questione da chiarire |
|---|---|---|
| Individuare un dato prima di un contatto | Una pagina HTML che presenti il dato nel contesto del prodotto | Se il dato è sufficiente per orientarsi e dove si verifica la versione |
| Consultare una scheda tecnica definita | Il PDF previsto dal processo documentale | Se il lettore riconosce documento, ambito e revisione corretti |
| Orientarsi sul sito e poi esaminare il documento | Pagina di ingresso e PDF associato | Se il passaggio tra i due è chiaro e non crea dati discordanti |
La terza possibilità richiede particolare attenzione: non basta aggiungere un pulsante per scaricare un file. La pagina deve aiutare a capire perché quel documento è pertinente; il documento, a sua volta, deve essere identificabile senza dipendere dalla pagina che lo presenta. Se la pagina riporta alcuni dati della scheda, occorre decidere quali siano necessari per orientarsi e chi li aggiornerà quando cambia il documento.
Un buyer che cerca un’informazione prima di chiedere un’offerta non dovrebbe dover indovinare se la risposta sia nella pagina del prodotto, nella documentazione o in un passaggio successivo. Nel digital marketing b2b, pagine di prodotto e documentazione possono essere pensate insieme ai percorsi per richieste e contatti tecnici: collocare il dato nel punto in cui serve è una decisione sull’architettura delle informazioni, oltre che sul formato.
Stampa, consultazione senza connessione e uso da dispositivi diversi possono entrare nella valutazione, ma vanno trattati come esigenze da accertare presso i lettori, non come motivi già dimostrati per preferire un formato. Anche l’accessibilità va verificata sui contenuti effettivamente pubblicati. La domanda pratica è quali condizioni debba soddisfare ciascun output nel percorso previsto, non quale formato possieda automaticamente tutte le qualità desiderate.
Decidere quale versione fa fede
Quando la pagina riprende un dato presente nel PDF, nasce una responsabilità editoriale precisa. Se la scheda viene aggiornata e la pagina no, il lettore può trovare due valori diversi senza sapere quale usare. Il rischio non dipende dalla presenza di due formati in sé: dipende dall’assenza di una regola su chi modifica i contenuti, chi li approva e quale pubblicazione costituisce il riferimento.
Un’impostazione possibile è dichiarare che la scheda approvata è il riferimento e che la pagina ne presenta soltanto i dati utili all’orientamento. Un’altra è gestire i contenuti da una fonte controllata e pubblicarli in più output. La funzionalità multi-output documentata da DITA-OT mostra che questa produzione è possibile, ma non definisce da sola il flusso di approvazione né impedisce divergenze: contesti di origine e contenuti pubblicati vanno comunque controllati. La scelta tra i due assetti dipende da come l’impresa mantiene oggi le informazioni, non dal nome del formato finale.
Per rendere praticabile la regola, ogni contenuto prioritario dovrebbe avere un responsabile identificato e un modo comprensibile di riconoscere la versione applicabile. Potrebbero servire un identificativo, una revisione o un’indicazione di aggiornamento, secondo il sistema documentale già in uso; non conviene aggiungere etichette che nessuno mantiene. Se la pagina espone un dato tratto da una scheda, l’aggiornamento della scheda dovrebbe prevedere anche una verifica della pagina. Se invece i due contenuti hanno scopi e ambiti differenti, la differenza va resa esplicita, anziché mascherata da titoli quasi uguali.
La verifica più semplice è provare a rispondere, per un caso concreto, a tre domande: quale contenuto vede per primo il buyer, dove trova il dato che gli serve e quale pubblicazione deve considerare valida se incontra una differenza? Se chi gestisce il sito e chi approva la documentazione danno risposte diverse, la scelta tra PDF e HTML non è ancora completa.
Partire dai contenuti che contano nel percorso
Una revisione proporzionata può cominciare dalle informazioni che l’impresa ritiene importanti prima di una richiesta tecnica o commerciale. Per ciascuna, si scelga un compito osservabile: trovare un dato, capire se un prodotto è pertinente, individuare la scheda corretta. Si controlli poi il percorso esistente senza dare per scontato che il problema sia il PDF: potrebbero essere poco chiari il nome del documento, la pagina che lo presenta o il riferimento alla versione.
Se emerge che un dato essenziale rimane nascosto fra più schede, si può valutare una pagina HTML che lo esponga nel contesto appropriato e indirizzi al documento completo. Se invece il compito è recuperare una scheda ben identificata, può essere più utile rendere chiara la sua collocazione e il suo stato che riscriverla sul web. In entrambi i casi, prima di estendere la soluzione, vale la pena osservare alcuni lettori reali mentre cercano l’informazione e chiedere loro quale versione userebbero. È una verifica del percorso, non una promessa di risultati sulla visibilità o sulle conversioni.
Il risultato atteso per il primo gruppo di contenuti è una decisione concreta, non un programma di conversione totale: per ogni informazione prioritaria, annotare il compito del lettore, il formato necessario per svolgerlo e il riferimento alla versione corretta. Da lì diventa possibile capire quali PDF mantenere, dove una pagina aggiunge una funzione distinta e quali passaggi richiedono soprattutto una gestione documentale più chiara.
