Scrittura strutturata: Retorica e processo

Recensioni dei lettori

Questo libro approfondisce la costruzione retorica dei linguaggi di markup e il modo in cui possono essere strutturati per migliorare la comunicazione con i vari pubblici. Pur offrendo una solida panoramica dei linguaggi di markup avanzati come DITA e OWL, si basa molto sulla storia del markup invece di concentrarsi sui metodi pratici di organizzazione. L'autore sottolinea l'importanza delle aspettative del pubblico nel determinare ciò che è considerato contenuto organizzato.

⬤ Panoramica completa dei linguaggi di markup avanzati
⬤ preziosi approfondimenti sugli aspetti retorici dell'organizzazione dei contenuti
⬤ discute l'importanza del pubblico e delle aspettative
⬤ introduce un meta-linguaggio per il markup.

⬤ Limitati consigli pratici sulla suddivisione e l'organizzazione delle informazioni
⬤ eccessiva attenzione alla storia dei linguaggi di markup
⬤ potrebbe non soddisfare le esigenze di chi cerca una guida più pratica.

(basato su 1 recensioni dei lettori)

Titolo originale:

Structured Writing: Rhetoric and Process

Contenuto del libro:

La scrittura strutturata non è mai stata così importante o confusa. È facile perdersi in un mare di acronimi e parole d'ordine: semantica, XML, metadati, DITA, struttura, DocBook, ipertesto, Markdown, argomenti, XSLT, riutilizzo, LaTeX, silos, HTML, all'infinito. Structured Writing taglia i ponti con il rumore, spiegando cos'è la scrittura strutturata e come si possono usare strutture diverse per raggiungere scopi diversi. Si concentra su come suddividere e gestire la complessità dello sviluppo e della distribuzione dei contenuti per garantire una retorica efficace e processi efficienti.

Introduzione: definisce la scrittura strutturata, la relazione tra retorica e processo e l'importanza di suddividere correttamente la complessità.

Domini della scrittura strutturata: introduce i quattro domini della scrittura strutturata: media, documento, argomento e gestione e mostra come la comprensione di questi domini possa aiutare a costruire strutture che supportino una scrittura di qualità.

Processo, retorica e struttura: descrive come la struttura supporta sia i processi sia la retorica.

Algoritmi: esplora i principali algoritmi di scrittura strutturata, tra cui il single sourcing, il riuso, il linking, il contenuto attivo, il contenuto generato e la pubblicazione.

Strutture: approfondisce le strutture, compresi i blocchi, le strutture ampie e le strutture componibili. Esamina anche i metadati, la gestione della terminologia e la conformità.

Linguaggi: un'indagine sui linguaggi attualmente utilizzati per la scrittura strutturata, che vanno da linguaggi leggeri come Markdown e reStructuredd104 a linguaggi pesanti come DITA e DocBook. Poi esamina l'estensione e la limitazione dei linguaggi.

Gestione: esamina i sistemi di gestione dei contenuti ed esplora come supportare la collaborazione, evitare la duplicazione e verificare i contenuti.

Design: esamina come identificare la complessità e come suddividerla in modo appropriato durante la progettazione di un sistema, quindi esamina come selezionare i processi e gli strumenti necessari per supportare le esigenze di contenuto dell'organizzazione.