Architettura dei contenuti

L’architettura dei contenuti determina cosa mettere e dove nel vostro database.

È sempre meglio pianificare la struttura di un database prima di iniziare a scrivere, invece di improvvisare strada facendo.

Ponetevi domande come:

  • Quali prodotti devo documentare?
  • In cosa differiscono tra loro? Cosa hanno in comune?
  • Fanno parte di una o più linee prodotto?
  • Ci sono funzionalità opzionali da documentare? Quante?
  • Queste funzionalità sono note in anticipo?
  • I manuali sono specifici per ogni cliente? Per ogni ordine? O standard per tutti i clienti?
  • Quali informazioni posso riutilizzare per tutti i prodotti? Quali all’interno di una linea di prodotto? Quali sono specifiche per un singolo prodotto?
  • Quali informazioni legali o di proprieta’ intellettuale, quali avvertenze di sicurezza o altri testi standard mi servono?

Questo elenco non è per nulla completo. Altre domande a cui bosogna rispondere:

  • Di quali immagini e illustrazioni ho bisogno?
  • In quale formato?
  • Mi servono immagini diverse per i vari output (pensate a dimensioni, risoluzione, palette colori)?

E inoltre:

  • Qual è la struttura interna dei miei documenti? Sono vincolato da una normativa o da uno standard?
  • Quali metadati voglio utilizzare? Devo creare un’ontologia? Ne esiste già una?