L'artigiano di Babele

Prospettive professionali per il 2012

2012-01-19T23:25:00.000+01:00

Sono iscritto ad un sito italiano di job-seeking che mi invia quasi ogni giorno un report con offerte di lavoro inerenti alla mia professione.

Il sito seleziona le offerte in base ad alcune parole chiave: redattore tecnico, manualistica, technical writer, documentazione tecnica, ... e altre ancora.

Dall'inizio del mese di Gennaio 2012 ho ricevuto 244 proposte di lavoro.

Una buona parte di queste proposte si ripete nei diversi report (anche in base alla combinazione delle suddette parole chiave), una parte sono probabilmente solo degli "annunci civetta", altre contengono descrizioni del profilo desiderato abbastanza "fumose" e poco credibili... quindi diciamo che se oggi fossi interessato a cambiare lavoro, delle 244 indicazioni ricevute forse solo 30 potrebbero effettivamente risultare interessanti.

Ma supponiamo che fossero anche solo 10 le proposte veramente degne di attenzione.

Personalmente riterrei comunque lusinghiero ricevere 10 proposte di lavoro "vere" in meno di 20 giorni, perchè ciò vorrebbe dire che esiste una domanda del mercato assoluatamente non banale, specie se confrontata con altri settori.

Nel 2011, USNews aveva classificato quella del Technical Writer come una delle 50 professioni più appetibili sul mercato USA, con buone prospettive di crescita nei prossimi 10 anni.

Io vorrei focalizzarmi sulla figura del Comunicatore Tecnico, che concepisco come estensione ed evoluzione di quella del Technical Writer.

In generale, nell'ambito della comunicazione tecnica, gravitano delle competenze che non si possono circoscrivere alla sola costruzione di contenuti testuali (tech. writing) ma "sconfinano" in ambiti affini, quali l'illustrazione grafica o la definizione dei contenuti Web o la realizzazione di contenuti multimediali di vario tipo, dalla presentazione al video tutorial, fino alla definizione e conduzione di interi progetti di comunicazione tecnica di un'azienda.

Spesso le aziende vorrebbero tutte queste competenze riunite in una sola persona; per quanto sia desiderabile essere flessibili e capaci di coprire diversi fronti, non sempre si possono raggiungere livelli di eccellenza in ogni direzione.

Tuttavia ritengo che la carta vincente della professione di Comunicatore Tecnico risieda proprio nel fatto di essere uno specialista "verticale" ma tendenzialmente "cross-settoriale" e "cross-mediale", quindi in teoria adatto a coprire diverse esigenze di comunicazione, a diversi livelli, in diversi ambiti professionali.

Uso di proposito l'avverbio "tendenzialmente" perchè sono consapevole che esistono settori specifici, come ad esempio quello del Medical Writing, in cui per uno come me sarebbe difficile poter "sconfinare".

Ma sono confidente che la complessità sempre crescente della tecnologia che ci circonda, sempre più pervasiva di ogni aspetto della nostra esistenza, rafforzerà la domanda di "buona comunicazione", ad ogni livello.

E il problema di come "farsi vela" e intercettare "il vento" della domanda è un problema assolutamente aperto.

All'evento COM&TEC di Bologna del 24 Novenbre, forse il più importante o tra i principali del settore, ho contato, a spanne, circa un centinaio di operatori, con skill professionali estremamente articolati. Immaginiamo di moltiplicare per 50 tale numero e ragioniamo sulla base di circa 5.000 unità che, a vari livelli e con diverse specializzazioni, occupano l'area della Comunicazione Professionale/Tecnica.

Non dispongo di dati puntuali ed aggiornati (qualsiasi contributo in tal senso è ben accetto), ma "sento" che sarebbero "numeri piccoli", per un paese occidentale, anche se fossero moltiplicabili per 4 o 5.

Questo mi induce a pensare che ci sia spazio e modo per far crescere questa professione, anche se poi certi servizi professionali sono di fatto già globalizzabili e quindi tener d'occhio solo numeri circoscritti ai confini nazionali è utile solo per semplificare il ragionamento.

Di contro, la crisi economica che sta ridefinendo la misura di tutte le cose, non è certo facilitante per una professione che si basa sulla presenza di aziende in grado di progettare/produrre/vendere tecnologia ed innovazione.

Da questi elementi dissonanti emergerà una tendenza ed una prospettiva professionale che sarà tanto più interessante quanto più possibile riusciremo a condividere l'idea che la "buona comunicazione" non è solo un costo ma può essere uno dei motori del successo di un'azienda e dei suoi prodotti.

Iniziamo il 2012 evitando gli errori più banali

2012-01-14T12:43:00.009+01:00

Per iniziare bene il 2012, ecco una collezione di errori da includere nella nostra Black List ideale.

Ce la offre una società statunitense, la Writing Assistance Inc. (WAI), che fornisce servizi di comunicazione tecnica ad ampio spetttro. Il sito Web della WAI è interessante e mi riprometto di fornirvi una breve recensione quanto prima.

Ed ecco 7 errori da tenere a mente, perchè questo è proprio lo spirito di una BL: tutto ciò che c'è nella BL, semplicemente non va fatto!

ESSERE IMPRECISI

Spesso vi ho raccontato che la Qualità è nei dettagli e sembra che anche in WAI siano d'accordo con me.

NON USARE UN TEMPLATE
In molti pensano di saper usare i software di video-scrittura, ma quando apri un loro documento ti rendi conto che non usano formattazioni di alcun tipo e nemmeno gli stili predefiniti, ignorano i margini, l'interruzione di pagina ed il correttore ortografico ma, soprattutto, improvvisano qualsiasi tipologia di documento e non utilizzano alcun Template ben definito... Risultato? Documenti inguardabili, di difficile lettura, male organizzati nello stile e nei contenuti. Che vi posso dire? Come recitava Nanni Moretti in un celeberrimo film: "... continuiamo così... facciamoci del male...". Prossimamente vi dirò dove potete trovare migliaia di Template scaricabili gratuitamente... se imparerete ad usarli, capirete la differenza.

IGNORARE IL LETTORE

Nella comunicazione tecnica si scrive per spiegare concetti complessi a qualcuno, quindi il lettore e le sue esigenze dovrebbero essere il fulcro della nostra impostazione; quando ciò non accade, i risultati difficilmente saranno apprezzabili.

SCRIVERE SENZA UNA PIANIFICAZIONE

E' il modo migliore per sprecare tempo ed energia. Raccogliere i dati grezzi, classificarli, disegnare una mappa mentale degli argomenti fondamentali, abbozzare un indice, iniziare una prima stesura, verificare lo schema iniziale e magari modificarlo, estendere o limitare lo sviluppo di una o più parti rispetto alla prima stesura... e altro ancora. Una pianificazione è sempre necessaria; una o più riletture, magari con l'aiuto di una check-list, sono indispensabili, difficilmente è "buona la prima", a meno che non siate dotati di una genialità esasperata. E poi si può diventare più ambiziosi e pianificare altri aspetti della produzione della documentazione aziendale o del suo processo di validazione. Lavorare ignorando tutto ciò equivale a svuotare il mare con il cucchiaio... tutto sommato non molto divertente!

USARE LE CONTRAZIONI (E GLI ACRONIMI)

A volte l'uso di sigle contratte ed acronimi è inevitabile ma è buona norma non abusarne.

FARE DELLE ASSUNZIONI TROPPO FORTI

Talvolta polemizzo non poco con i miei colleghi tecnici i quali sostengono che "... questo non c'è bisogno di spiegarlo troppo nei dettagli, tanto si capisce... e poi chi legge questo documento è un utente esperto...".

Chi, a fronte della difficoltà che deve essere affrontata nella divulgazione di un concetto complesso si nasconde dietro queste tesi, cerca semplicemente di non farsi carico della suddetta difficoltà.
Salvo poi imprecare contro la scarsa chiarezza della documentazione disponibile quando sono "loro" a trovarsi dall'altra parte della barricata!
Un buon manuale non deve partire dall'ipotesi che il lettore sia un super-esperto. Certi documenti, come i Manuali di Installazione o le Check-List di Collaudo, devono essere addirittura "a prova di scimmia".

CORREGGERE DA SOLI I PROPRI SCRITTI
E' l'errore più frequente, spesso indotto dal fatto di non disporre di un aiuto, di "un altro paio di occhi" che possano esaminare i nostri scritti. Con l'esperienza e l'allenamento si tende a sbagliare meno, ma difficilmente si rilevano tutti i prorpi errori, specie se si trascorre molto tempo su un documento. Quando è possibile, fate rileggere i vostri documenti a qualcuno di cui vi fidate e sarete sorpresi dalle correzioni che vi erano sfuggite!

BUON 2012 a tutti!

Un esercizio di riscrittura magistrale

2011-12-28T00:05:00.003+01:00

Vi ho parlato spesso di Luisa Carrada e di quante buone idee ho "rubato" leggendo il suo blog. Oggi vi segnalo un'altra gemma, particolarmente in linea con gli spunti che vi ho più volte proposto sull'attività di riscrittura e che potete visionare all'interno di questa sezione del blog.

La riscrittura non è un'attività sporadica o emergenziale, che magari viene praticata perchè un vostro cliente vi ha fatto notare un difetto. E' un'attività che allena la mente alla scrittura, una specie di "ginnastica" che va fatta possibilmente tutti i giorni, perchè quasi mai la "prima versione" di un testo è la migliore.

Luisa parte da un testo francamente poco riuscito e in 4 blocchi lo rende efficace, leggero, significante... usando circa 300 caratteri in meno.

Provate ad esercitarvi ogni giorno. Prendete un testo che avete appena scritto o magari uno che "riposa" da alcuni giorni. Provate a riconsiderarlo e riscriverlo, eliminando parole inutilmente complicate o ridondanti, asciugando immagini e metàfore, concentrandovi sul nocciolo della comunicazione che deve arrivare al lettore.

Per diventare bravi come Luisa ci vuole tempo e talento... ma per migliorare un pò ogni giorno, ci vuole solo esercizio.

Usiamo parole comprensibili e saremo tutti più felici

2011-12-27T00:06:00.009+01:00

Non saprei dire da quanto tempo annoto in modo maniacale tutte le "brutte parole" che leggo nei documenti di ogni tipo, negli articoli dei giornali, nei foglietti illustrativi dei medicinali o negli avvisi esposti negli uffici pubblici.

Quest'ultimo è forse il caso più comune ed odioso.

In un ufficio pubblico, che sia la ASL piuttosto che una sede INPS o similari, troviamo persone non necessariamente bi-laureate, spesso anziane, che hanno bisogno di ricevere un servizio talvolta urgente ed è francamente intollerabile che venga proposto loro un linguaggio "iniziatico", che invece di faciltarli li ostacola.

Devo dire che negli ultimi tempi ho notato dei miglioramenti, segno che una certa sensibilità inizia a farsi strada.

Ma una "buona comunicazione" come si costruisce?

E' difficile dire tutto quello che si deve fare, MA DI CERTO so che alcune cose NON SI DEVONO FARE e che ci sono molte parole che NON DOVREMMO PIU' USARE! Qualche esempio?

REDIGERE
Lasciate ai notai l'uso desueto di questo termine; SCRIVERE è molto più comprensibile, al limite COMPILARE se vi riferite ad un modulo pre-stampato.

EQUIPOLLENTE
Potete usare EQUIVALENTE o PARI e non sarete per questo meno intelligenti...

ALIQUOTA

E che sarà mai? Una semplice PERCENTUALE, cioè una certa quantità in rapporto ad una quantità intera che si può suddividere in 100 parti uguali.

CORRESPONSIONE

... ovvero un PAGAMENTO... di sicuro più comprensibile.

E tutto ciò è solo l'inizio. Proverò a raccontarvi le mie impressioni sull'argomento, aggiungendo di volta in volta nuovi elementi alla nostra Black List delle parole/espressioni inutilmente complicate, con la speranza che questo possa aiutarci a comunicare meglio.

BUONE FESTE!

2011-12-24T01:21:00.000+01:00

E' molto che non scrivo, in questo periodo sono stato impegnatissimo e ho dovuto trascurare il blog. In compenso sto sviluppando diversi articoli di diversa ispirazione e spero di poterveli proporre quanto prima.

Per ora, tanti auguri di Buone Feste e di un felice 2012, pieno di serenità, salute e lavoro.

Il mio regalo per voi è un'acrostico, un giochino in versi ispirato alla quotidianità del mio lavoro.

E magari qualcuno di voi ci si potrà anche riconoscere.

A presto!

Saper scrivere... l'Accordo di Riservatezza (NDA): quinta ed ultima parte

2011-11-27T15:26:00.003+01:00

Siamo al quinto post dedicato alla redazione di un NDA, dopo aver già esposto le tematiche principali in 4 post precedenti:

Saper scrivere... l'Accordo di Riservatezza (NDA): prima parte
Saper scrivere... l'Accordo di Riservatezza (NDA): seconda parte
Saper scrivere... l'Accordo di Riservatezza (NDA): terza parte
Saper scrivere... l'Accordo di Riservatezza (NDA): quarta parte

In quest'ultimo post vorrei accennare brevemente a due aspetti e precisamente:

- alle sanzioni che quantificano il danno derivante dalla violazione dell'NDA

- ai limiti di applicabilità dell'accordo

Per quanto riguarda le sanzioni, il caso più probabile è quello in cui il SR venga meno agli obblighi sottoscritti (per dolo o per incuria) e l'Azienda decida a quel punto di far valere i termini dell'accordo in un tribunale.

In tal caso, nel rispetto degli articoli del Codice che già regolano i temi della contrattualistica, spetta al gudice valutare l'effettivo danno derivato dalla violazione, onde evitare grottesche ed esagerate richieste dell'Azienda.
In questo solco, il giudice dispone di un'ampia discrezionalità, spesso finalizzata ad esprimere valutazioni equitative in grado di contemperare gli eccessi di rivendicazione del danno.

Fissare nell'NDA una somma orientativamente congrua che deve essere riconsociuta alla parte danneggiata, potrebbe definire una specie di "soglia minima" o più lascamente di "soglia di riferimento" che dovrebbe indurre il giudice ad una valutazione che sia per lo meno non inferiore o troppo distante da tale limite.

La formula che vi propongo potrebbe essere questa:

Nel caso in cui il Soggetto Ricevente vìoli gli obblighi di riservatezza di cui al presente accordo e tale violazione sia ad esso imputabile, sarà tenuto a corrispondere all'Azienda la somma di ……… Euro, fatto salvo il risarcimento del danno ulteriore.

Tale formulazione tende a fissare un limite inferiore, lasciando ovviamente il giudice libero di valutare ulterioriormente in base ai fatti.

Ovviamente, è opportuno definire una somma ragionevole.
Se volete proteggere un software che potrebbe generare un giro d'affari annuo di 500.000 Euro, non potete inserire nell'accordo una tale cifra, perchè essa deriva da un'aspettativa ipotetica non dimostrabile.

Ma se la licenza di questo software costa 20.000 Euro, imporre nell'accordo una cifra tra i 10.000 ed i 20.000 Euro potrebbe essere considerato ragionevole.

In tal caso, fissare una cifra troppo bassa (1000 Euro) non rappresenterebbe un deterrente credibile; se fosse fissata una cifra di 100.000 Euro, il giudice potrebbe ritenere tale indicazione comunque eccessiva e non tenerne conto o addirittura fonte di nullità dell'accordo, classificandola come "clausola vessatoria".

Ovviamente, apporre una clausola di questo tipo vi espone al rischio che il SR si rifiuti di sottoscrivere l'accordo, con conseguenze che devono essere valuate di caso in caso e che non ci interessa indagare.

Ed ora concludiamo riflettendo sugli aspetti legati ai limiti di applicabilità di un NDA.
Come tutti gli accordi di natura privatistica, devono essere formulati senza violare le norme generali della materia/dell'ambito in cui quel tipo di accordo ha senso e che sono già stabilite nel Codice Civile.

Questo fatto può essere espresso in questo modo:

Il presente Accordo di Riservatezza è regolato in ogni suo aspetto dalla legge italiana, con particolare riferimento agli articoli 1337 e 2598 del Codice Civile.

Vediamo alcune altre clausole standard che potreste trovare in qualsiasi NDA:

Gli impegni assunti con il presente Accordo di Riservatezza non troveranno applicazione qualora la legge obbligasse il SR a rivelare alle pubbliche autorità le informazioni ricevute ai sensi del presente accordo.

Gli impegni assunti con il presente Accordo di Riservatezza non troveranno applicazione per tutte le Informazioni Riservate che l'Azienda deciderà di rendere pubbliche e liberamente disponibili nelle più diverse forme (contenuti Web, campagne pubblicitarie, documenti di qualsiasi tipo, conferenze, seminari, …).

Di seguito invece una clausola che potrebbe sollevare obiezioni:

Il presente NDA è valido e vincolante dal momento in cui le prime Informazioni Riservate siano state rese disponibili dall'Azienda ed avrà efficacia anche dopo la cessazione, per qualsiasi motivo, dei rapporti tra le Parti.

Qui sembra essersi ribaltato il punto di vista, cioè sembra che l'accordo debba continuare ad essere valido, per un tempo indefinito, anche dopo la cessazione di ogni rapporto tra i contraenti. Come abbiamo già visto in precedenza è invece opportuno fissare limiti temporali ragionevoli in tal senso.

Io personalmente non metterei una clausola di questo tipo in un NDA.

Altri elementi utili? Si.

Il trattamento dei dati personali e sensibili che possono essere eventualmente coinvolti nella dinamica di questo accordo, dovrà avvenire nel pieno rispetto della normativa vigente in materia (D.L. n° 196 del 30 Giugno 2003).

Eventuali comunicazioni tra Le Parti relative al presente accordo dovranno pervenire ai seguenti indirizzi:
…………..
…………….

E con questo abbiamo concluso questo giro d'orizzonte relativo ad un tema che, spero, sia stato interessante.

Sottolineo ancora una volta che non sono un Avvocato e che se volete realizzare un NDA inattaccabile, una consulenza legale è la strada maestra... ma non obbligatoria, perchè seguendo lo schema che vi ho proposto e con un minimo di informazioni aggiuntive che si possono ormai trovare anche in rete, potete quanto meno impostare un NDA sufficentemente robusto per tutelare il vostro business o sarete in grado di valutare meglio la soluzione che vi proporrà il vostro Avvocato.

Open House COM&TEC a Bologna: una bella esperienza

2011-11-24T21:34:00.001+01:00

Sono ancora sul treno che mi sta riportando a Roma, di ritorno dall'evento Open House organizzato dalla COM&TEC a Bologna. Era la prima volta che vi partecipavo ed stata una bella full-immersion nelle tecnologie e metodologie per la Comunicazione Tecnica. Spero di avere tempo e modo di scrivere più di un post, nel prossimo futuro, su argomenti che sto approfondendo per motivi professionali. Il meeting di oggi mi ha dato più di qualche idea. Ora sto per arrivare a Termini. Ciao.

Black List... ovvero cosa non fare, cosa non scrivere, cosa evitare

2011-11-14T00:59:00.000+01:00

Da stasera apro una nuova sezione nel blog, dove raccoglierò indicazioni relative a tutto ciò che non si deve fare quando si scrive un documento.

E' un approccio un pò diverso, un punto di vista alternativo e molto pragmatico. Spesso quando scriviamo un documento facciamo errori, alcuni marginali, altri inaccetabilmente grossolani.

E' estremamente comune rilevare delle lacune, spesso gratuite, in documenti dai contenuti magari apprezzabili, ma che sarebbero stati meglio valorizzati se tali errori non fossero stati presenti.

La Black List è uno dei "ferri del mestiere" che bisogna tenere a portata di mano, un repository di osservazioni che si arricchisce strada facendo e che via via ci guida a ridurre il tasso di errore o per lo meno a non ripetere, diabolicamente, sempre gli stessi passi falsi.

Spero di potervi indicare delle cose interessanti e spero vi (ci) possa tornare utile.

Una Guida utile per entrare in Linkedin

2011-11-11T20:15:00.002+01:00

Navigando in uno dei gruppi che frequento su Linkedin, mi sono imbattuto in una Quick Guide veramente ben fatta, utile per tutti coloro che vogliono iscriversi a questo importante social-network professionale e che, al momento della definizione del proprio profilo, possono trovarsi in difficoltà nell'interpretare le diverse opzioni disponibili.

Gli autori/divulgatori della guida sono Gian Paolo Ghilardi e Paolo Bruno.

Ve la segnalo per due motivi.

In primo luogo perchè è un ottimo esempio di come si scrive una Quick Guide: ben disegnata, essenziale, sintetica e completa, espressa in una lingua comprensibile, senza avvitamenti iper-tecnicistici o riferimenti esoterici a conoscenze iniziatiche.

Inoltre, in più di un'occasione e da diverse persone, ho registrato la necessità di qualche chiarimento sulla gestione del profilo Linkedin e stavo io stesso iniziando a scrivere una mini-guida sull'argomento... ma visto che ne ho trovata una già pronta, mi ritengo gioiosamente sollevato dall'incarico.

Gian Paolo ha fatto un ottimo lavoro, approfittatene.

Usability per Mobile Device

2011-10-29T11:31:00.000+02:00

Una mia "amica di blog", Barbara Zen, è partita dal post che ho scritto il 23 Ottobre ed ha proposto il suo punto di vista sul tema della usability delle applicazioni per i Mobile Device.

Barbara, oltre ad essere sempre "sul pezzo" per ciò che riguarda il mondo della comunicazione e le sue 1000 dimensioni, ha la rara qualità di scrivere sempre cose interessanti, coniugando chiarezza, sintesi e buone idee.

Adesso scappate via dal mio blog e andate a leggerla!... Poi magari tornate... perchè tornate... si? :-)

CrossIdeas assume personale tecnico!

2011-10-25T16:32:00.002+02:00

CrossIdeas ha necessità di aggiungere al proprio organico 3 figure tecniche con competenze informatiche.

Il candidato dovrà aver maturato un'esperienza di almeno 1 anno, fino ad un massimo di 2/3 anni, nel ruolo di sviluppatore di applicazioni software in Java e in particolare di applicazioni Web.

Il candidato ideale dovrà avere comprovate conoscenze di:

Java (J2EE, EJB, JSF)
Hibernate
Spring

Sono notevolmente gradite eventuali conoscenze anche in ambito:

JBoss
Oracle
MySQL
PostgreSQL

Potete inviare i vostri CV a:
job@crossideas.com

Vi attendiamo!

I Mobile Device impongono testi brevi ed efficaci: è qui la festa?

2011-10-23T13:51:00.000+02:00

Verso la fine di Settembre, Jakob Nielsen, il guru della Web usability, ha pubblicato uno studio inerente alla struttura dei testi adatti ad essere visualizzati sullo schermo di un terminale Mobile, che sia uno Smartphone o un Tablet PC.

La "ciccia" di questo studio, che riprende anche delle analisi precedenti, può essere riassunta in 3 punti:

- il lettore di un terminale Mobile dispone in genere di poco tempo e di un basso livello di attenzione, perchè spesso lo utilizza durante i ritagli di tempo (mentre è in attesa per prendere l'aereo o il treno, in una pausa di un evento sportivo, ...)

- la comprensione di un testo sugli schermi di tale dispositivi è almeno 2 volte più difficile rispetto allo schermo ordinario di un PC

- indipendentemente dal tipo di terminale, dal SO, dalla specifica applicazione o dalla lingua utilizzata, rimane immutata la necessità di organizzare le informazioni testuali nel modo più sintetico, semplice e diretto possibile.

E allora diciamo che sono contento. Perchè quando vi rompo le scatole con le mie "fissazioni" (sintesi, rilettura ossessiva, eliminazione del superfluo, proofreading, Qualità della scrittura) vuol dire che ho ragione.

E visto che ho ragione, insisto. Ecco una selezione dei post più mirati sull'argomento:

Micro esercizio di riscrittura

Ancora sul proofreading... gutta cavat lapidem!

Revisone di un testo: attenti al Diavolo!... o ai particolari...

Perchè usare 74 parole quando ne bastano 45?

Esercizio di riscrittura n° 2

La Qualiità della documentazione tecnica: Chiarezza e Sintesi

Saper scrivere... l'Accordo di Riservatezza (NDA): quarta parte

2011-10-16T23:26:00.000+02:00

Siamo alla quarta puntata del serial inerente alla scrittura dell'Accordo di Riservatezza (NDA) e, per chi non l'avesse fatto, non sarebbe male dare un'occhiata ai 3 post precedenti:

Saper scrivere... l'Accordo di Riservatezza (NDA): prima parte
Saper scrivere... l'Accordo di Riservatezza (NDA): seconda parte
Saper scrivere... l'Accordo di Riservatezza (NDA): terza parte

Oggi ci occupiamo di un punto chiave, cioè della DURATA di tali accordi.

Questa è una questione molto delicata. Specificare una durata palesemente eccessiva, potrebbe portare, in caso di contenzioso, ad una probabile impugnazione. Se qualcuno, pur di poter lavorare, è costretto a firmare una clausola che lo impegna a rispettare determinati obblighi per 5 o più anni, è evidente che tale clausola potrebbe essere giudicata vessatoria e quindi inficiare la validità dell'accordo sottoscritto.

D'altro canto, una clausola che indichi una durata troppo breve vanificherebbe l'obiettivo primario del NDA, cioè la tutela di informazioni critiche che l'Azienda deve condividere col Soggetto Ricevente.

In altri termini, tale durata dovrà essere determinata con criteri ragionevoli che prendano in considerazione tutti gli interessi coinvolti. La durata deve essere anche valutata in base all'ambito specifico d'applicazione.

Per un'Azienda che produce software, un periodo di 12 mesi può essere già sufficente, considerando l'elevato tasso di obsolescenza di qualsiasi soluzione nel campo ICT.

Per un'azienda che produce tecnologie nell'ambito della ricerca bio-medica potrebbe essere necessario stabilire un periodo di certo più esteso.

La formulazione di una clausola di questo tipo può risultare particolarmente sintetica:

Il presente Accordo di Riservatezza rimarrà valido per un periodo di 2 (due) anni dalla data odierna.

Una formulazione più articolata, che indica esplicitamente oltre alla durata alcune limitazioni specifiche, può essere la seguente:

Il SR si impegna, per un periodo di 24 mesi a far data dalla firma del presente accordo, a non intrattenere con parti terze, anche indirettamente, trattative e/o contatti di alcun tipo e/o in qualsiasi forma, aventi ad oggetto la realizzazione di progetti/prodotti/servizi presso i clienti acquisiti dall'Azienda e con i quali la stessa intrattiene relazioni commerciali e di partnership.

Come abbiamo detto, un NDA deve tutelare l'Azienda nella fase "pre-contrattuale", quando tra l'Azienda e il SR non si è ancora instaurato alcun rapporto professionale definito.

Ma in alcuni casi è possibile definire degli accordi che possano agire anche nei rapporti già "contrattualizzati", cioè agenti anche nei confronti dei dipendenti o di consulenti già acquisiti.

In tali casi, l'NDA deve andare a coprire un periodo di tempo successivo all'eventuale cessazione del contratto in vigore al momento della firma. Un esempio di seguito:

Il presente Accordo di Riservatezza rimarrà valido per un periodo di 12 mesi (1 anno) anno a partire dalla data di cessazione del rapporto professionale attualmente in essere tra l'Azienda e il SR.

Questo esempio testimonia la flessibilità che può essere conferita a questo tipo di accordi, in funzione della combinazione delle clausole proposte. A presto, per l'ultimo post sull'argomento.

Saper scrivere... l'Accordo di Riservatezza (NDA): terza parte

2011-10-09T13:12:00.006+02:00

In due post precedenti ho parlato degli Accordi di Riservatezza (No Disclosure Agreement):

Saper scrivere... l'Accordo di Riservatezza (NDA): prima parte
Saper scrivere... l'Accordo di Riservatezza (NDA): seconda parte

Vi ho poi indicato una classificazione delle condizioni delineabili in questo tipo di accordi, strutturata in 4 tipologie principali:

1) clausole regolanti le informazioni condivise e il loro trattamento

2) clausole inerenti ai doveri dei dipendenti e dei collaboratori

3) clausole relative alla durata degli obblighi definiti nel NDA

4) clausole che quantificano il danno derivante dalla violazione degli accordi

In questo post analizzeremo brevemente la tipologia 2.

Il SR, nella fase pre-contrattuale, potrebbe avvalersi di dipendenti e collaboratori nell'analisi delle informazioni ricevute dall'Azienda. E' evidente che in tal caso sorge l'esigenza di disciplinare, anche per tali soggetti, l'utilizzo delle informazioni suddette.

Un primo criterio di cautela consiste nello specificare che il SR dovrà limitare l'accesso alle informazioni ai soli dipendenti che abbiano effettivamente necessità di conoscerle:

Il SR dovrà porre in essere le misure più idonee affinchè i dati di natura riservata non entrino in possesso di altri soggetti. Qualora per il SR sia necessario condividere la conoscenza di tali dati con collaboratori e dipendenti, dovrà limitare al minimo possibile il numero di persone coinvolte e dovrà vigilare affinchè anche questi soggetti si attengano alla sostanza dell'accordo in oggetto. Sarà poi compito del SR mettere in atto tutti i presidi adatti a rispettare tale impegno, specificando gli obblighi di riservatezza assunti e la loro estensione, nonchè i processi operativi (es. attraverso apposite procedure interne) finalizzati al rispetto di tali limitazioni.

Adottando una clausola di questo tipo e perseguendo le suddette politiche, qualora, in modo casuale o doloso, le informazioni riservate vengano diffuse violando gli obblighi dell'accordo, il SR potrà evidenziare la propria buona fede e potrà eventualmente rivalersi nei confronti del dipendente per i danni derivanti da tali violazioni.

Al prossimo post per continuare ad approfondire l'argomento.

Saper comunicare... ci vorrebbe uno "pratico"!

2011-09-30T12:54:00.000+02:00

"...Io non mi sento italiano... ma per fortuna o putroppo lo sono..."

(Giorgio Gaber)

E' ancora recente il "casus horribilis" del comunicato stampa attribuito al Ministro Gelmini, relativamente all'esperimento sui neutrini "più veloci della luce", condotto congiuntamente dal CERN di Ginevra e dall'Istituto Nazionale di Fisica Nucleare del Gran Sasso. Evito di diffondere ulteriore ironia sulla proterva sciatterìa di chi dovrebbe sapere e non sa, anche perchè infierire su coloro che sono già vessati da un destino avverso non è il mio sport preferito.

Ma vi segnalo un ottimo articolo scritto da Marco Stancati, una specie si saggio breve, anzi brevissimo, sulla "comunicazione consapevole ed efficace" incentrato su questo episodio. Leggetelo. E' estremamente brillante. Spero che sia l'occasione per riflettere sul fatto che la "comunicazione" non è un concetto astratto o un orpello, ma è una roba fatta di cose concrete, di parole, di concetti precisi, di regole, di competenza, di studio... appunto!

Come si dice qui a Roma... "...ce vorebbe uno pratico!...".

Vi segnalo un Webinar sull'Information Mapping

2011-09-28T17:33:00.001+02:00

Per chi è interessato alla comunicazione tecnica, potrebbe essere interessante seguire il Webinar promosso dalla WRITEC dal titolo:

Information Mapping®: redazione e gestione di informazioni complesse

Verrà erogato domani, 29 Settembre 2011, dalle ore 17.00 alle 18.00 e sarà condotto da Vilma Zamboli.

Il corso fornirà un overview sull'utilizzo di Information Mapping®, un metodo creato per semplificare la comunicazione e gestire il flusso delle informazioni in situazioni complesse. Saranno illustrati i pilastri del metodo e verranno presentati i casi di studio che descrivono la sua applicazione in settori differenti tra loro e su documenti di varia natura.

Se volete registrarvi al Webinar, potete accedere a questo link.

Io ci sarò... a domani.

Saper scrivere... l'Accordo di Riservatezza (NDA): seconda parte

2011-09-25T21:51:00.004+02:00

Nel post precedente abbiamo parlato degli Accordi di Riservatezza (No Disclosure Agreement) che possono tutelare un'azienda nell'interscambio di informazioni con un soggetto terzo, principalmente in una fase "pre-contrattuale" ma anche eventualmente in quella "post-contrattuale".

In un NDA possono essere specificate numerose clausole vincolanti, che possiamo provare a classificare in 4 tipologie principali:

1) clausole regolanti le informazioni condivise e il loro trattamento
2) clausole inerenti ai doveri dei dipendenti e dei collaboratori
3) clausole relative alla durata degli obblighi definiti nel NDA
4) clausole che quantificano il danno derivante dalla violazione degli accordi

Da ora in avanti indicheremo le due parti protagoniste dell'accordo come Azienda e Soggetto Ricevente (SR).

Cominciamo ad esaminare le clausole di tipo 1.

In primo luogo è essenziale circoscrivere quali dati possano e debbano essere resi noti al SR. I contraenti devono cioè indicare esplicitamente quali informazioni/documenti devono essere considerati di carattere confidenziale per evitare fraintendimenti che renderebbero inefficace la tutela prevista. Di seguito una possibile formulazione:

Per “Informazioni Riservate” si dovranno intendere tutte le informazioni e i materiali mostrati o consegnati nel corso di incontri, colloqui o altri tipi di contatto tra le Parti, siano esse state fornite oralmente, per iscritto, tramite mezzo elettronico o altro mezzo. In particolare si identificano come Informazioni Riservate:

-   Informazioni/Documenti di Tipo 1
-    Informazioni/Documenti di Tipo 2
-       ..............
-   Informazioni/Documenti di Tipo N

Successivamente vanno identificate le modalità di trattamento dei dati e il livello di riservatezza che dovrà essere mantenuto. In un NDA non ci si limita ad indicare le condotte "passive" (che possono ridursi nell'astenersi dal divulgare impropriamente le informazioni) ma si estende anche a quelle "attive", cioè la predisposizione di misure idonee ad evitare la diffusione anche involontaria di tali informazioni.

In tal senso, un'opzione molto diffusa fa riferimento alla necessità di osservare la stessa diligenza utilizzata per la gestione delle proprie informazioni confidenziali:

Il SR si impegna a mantenere riservata e strettamente confidenziale qualsiasi informazione ricevuta dall'Azienda, proteggendo tali informazioni con lo stesso grado di cura e attenzione che il SR normalmente utilizza nella protezione delle proprie informazioni riservate e di proprietà, ma in nessun caso con grado
inferiore a quello di una cura ragionevole e diligente.

Un opzione più stringente consiste nell'indicare dettagliatamente le procedure che garantiscano la riservatezza dei dati, ad esempio nel caso in cui le informazioni siano in forma digitalizzata:

Il SR si impegna a mantenere le informazioni ricevute dall'Azienda protette in un repository non connesso ad alcuna rete telematica e protetto da opportuni presidi crittografici (dati cifrati con: INDICARE LA TECNOLOGIA UTILIZZATA).

Si può anche prevedere un divieto non solo di diffusione delle informazioni a terzi, ma anche di utilizzo diverso da quello per cui le informazioni sono state rilasciate:

Il SR si impegna a non divulgare a soggetti terzi le informazioni ricevute. La divulgazione delle Informazioni Riservate a soggetti esterni all'Azienda dovrà essere preventivamente autorizzata da quest'ultima e, comunque, tali soggetti (collaboratori, consulenti, partners commerciali, …) verranno informati circa il presente accordo e gli impegni che dallo stesso derivano.

Infine si devono disciplinare modalità e tempistiche per la restituzione dei documenti ricevuti, nel caso in cui si interrompano le relazioni professionali tra SR ed Azienda:

Qualora l'Azienda lo richiedesse, il SR si impegna a restituire o distruggere tutta la documentazione ricevuta (esclusa quella alla cui tenuta il SR sia obbligato da norme di legge).

Quest'ultimo orientamento può essere notevolmente rafforzato ed esteso anche a tutte le informazioni eventualmente derivate da quelle ricevute direttamente dall'azienda:

Qualora l'Azienda lo richiedesse, il SR si impegna a fare in modo che tutti i documenti (note/bozze/analisi/immagini/presentazioni/report o altro), elaborate sulla base delle Informazioni Riservate ricevute dall'Azienda, vengano distrutte.

Come vedete, le sei clausole proposte già fanno intravedere una trama abbastanza robusta finalizzata ad impedire che il SR possa fare un uso improprio delle informazioni acqusite. Ma ovviamente molte varianti sul tema sono possibili, almeno quante ne potrebbe suggerire il vostro avvocato!

Al prossimo post per approfondire qualche aspetto inerente alle clausole di tipo 2.

Saper scrivere... l'Accordo di Riservatezza (NDA): prima parte

2011-09-15T22:09:00.000+02:00

Quando un'azienda entra in contatto con un consulente esterno o fornisce la possibilità ad un laureando di sviluppare una tesi sperimentale incentrata su tecnologie/applicazioni sviluppate in azienda, si pone nella necessità di condividere dei dati che sarebbe opportuno non divulgare all'esterno.

Nella prima fase "informale" di contatto tra l'azienda e tali soggetti, non si istanzia un rapporto professionale "contrattualizzato" che, generalmente, prende corpo solo in un secondo momento (come nel caso dello studente che viene assunto solo se la sperimentazione oggetto della tesi va a buon fine).

In una seconda fase, quando interviene un contratto tra le parti, l'azienda può inserire nel medesimo tutta una serie di calusole di salvaguardia (già peraltro previste dal Codice Civile) per tutelarsi da indebiti comportamenti sleali finalizzati ad attività che, per semplicità concettuale, potremmo definire di "spionaggio industriale".

Ma nella prima fase, quando appunto non c'è ancora un contratto tra le parti, come può cautelarsi?

In tal caso, possono essere siglate delle "intese pre-contrattuali" che, per la loro natura e la loro formulazione, hanno efficacia immediatamente vincolante, indipendentemente dall'esito delle negoziazioni o dalla conclusione del contratto definitivo.

Tali intese sono generalmente denominate "accordi di riservatezza" (Confidentialty Agreement) o "accordi di non divulgazione" (No Disclosure Agreement (NDA)).

Lo scopo principale di un NDA consiste nell'obbligare le parti ad assumere particolari condotte (attive o passive) in genere riconducibili al generale dovere di correttezza e buona fede (art. 1337 c.c.), ma che possono anche andare aldilà di tale limite.

Ad esempio, un NDA potrebbe porsi come obiettivo quello di tutelare l'azienda da azioni di concorrenza sleale (art. 2598 c.c.), originate dalla diffusione di informazioni riservate apprese dal soggetto durante il periodo pre-contrattuale.

Ma un NDA può essere strutturato anche in modo da garantire l'azienda da comportamenti sleali anche DOPO il termine del rapporto contrattualizzato, quindi nella fase "post-contrattuale".

Un NDA può ospitare un'ampia gamma di clausole, gran parte delle quali possono essere fondamentalmente classificate in 4 gruppi principali:

clausole regolanti le informazioni condivise e il loro trattamento
clausole inerenti ai doveri dei dipendenti e dei collaboratori
clausole relative alla durata degli obblighi definiti nel NDA
clausole che quantificano il danno derivante da violazione degli accordi

Al prossimo post per approfondire alcune linee guida che spero possano essere utili se dovrete formalizzare un NDA.

Micro esercizio di riscrittura

2011-09-04T19:32:00.000+02:00

Venerdì rileggevo una parte di un manuale che sto scrivendo in questi giorni e l'occhio è caduto su questo breve brano:

The information related to User Roles may be shown in different colours.
If there is a Review opened, User Roles may be characterized by the colours listed below:

• Red: ...blabla...
• Green: ...blabla...
• Blue: ...blabla...
...
Ho pensato che la prima riga fosse inutile e l'ho cancellata:

If there is a Review opened, User Roles may be characterized by the colours listed below:

• Red: ...blabla...
• Green: ...blabla...
• Blue: ...blabla...
...
Ecco l'esempio di un micro esercizio di riscrittura che mi capita di fare quotidianamente mentre scrivo e rileggo e scrivo e rileggo e scrivo e rileggo e scrivo...

Si, funziona proprio così. E' come fare le flessioni sulle braccia, è una ginnastica quotidiana. Non necessita un talento innato, è questione di "tigna", di attenzione ai particolari. Per chi volesse altri spunti sull'argomento, rimando agli altri post di questa sezione. Ciao.

Vado in ferie... finalmente!

2011-08-13T08:53:00.004+02:00

Sono in ferie dal 1° Agosto, ma sono rimasto a casa perchè mia moglie era bloccata al lavoro fino al 9. Così ho fatto quelle 2345 cose che di solito non ho il tempo di fare quando passo la maggiorparte della giornata al lavoro.... e quindi sono mooolto più stanco di quando vado in uffico!

In più, nell'ultima settimana ho avuto anche gli idraulici in casa, i quali non riuscendo ad avere la meglio sullo scarico ostruito del mio lavandino, hanno ipotizzato la presenza in loco di Alien e mi hanno consigliato un'esorcista!

All'ultimo colpo di compressore (12 atmosfere...), dopo 3 giorni di allagamenti, abbiamo vinto!

Oggi si parte per il mare di Puglia.

Buon Ferragosto a tutti... ci rivediamo intorno al 20!

Studiare sempre, continuamente e comunque.

2011-08-10T10:24:00.000+02:00

"Se ho visto più lontano è perché sono salito sulle spalle dei giganti che mi hanno preceduto", Isaac Newton.

Questa famosa frase di Newton si può applicare ad ogni campo della conoscenza e mi è particolarmente cara perchè rispecchia l'approccio che ho sempre praticato in questa professione.

Non è saggio pretendere di essere "originali" se prima non vi siete dati il tempo di studiare "lo stato dell'arte" di una certa area del sapere. E non c'è nulla di male nel "copiare" dai migliori; quando sarete diventati bravi nel copiare, nel senso più nobile del termine, allora avrete anche "i muscoli allenati" per essere originali.

Essendo un ingegnere, ed avendo quindi una formazione culturale "ufficiale" di tipo tecnico e non umanistico, ho fatto molta fatica per recuperare in pochi anni quanto più possibile nell'ambito dei fondamentali della comunicazione e molta altra strada mi aspetta.

La regola di base è una sola: studiare sempre, continuamente, anche disordinatamente, anche se mentre sto leggendo non afferro al 100% tutto quello che c'è da afferrare, anche solo nei ritagli di tempo, comunque.

E leggere di tutto, perchè il cervello trova risposte anche senza la nostra guida cosciente... e quando meno ve lo aspettate, ecco che la soluzione si presenta e vi sorprende.

Molte delle migliori risorse che ho "saccheggiato" le trovate disseminate nei diversi post che ho scritto e in particolare nella sezione DA VISITARE di questo blog. Ed ora, un'altra "dritta", spero utile.

Per un TW italiano, andare a "rubare il mestiere" ai TW anglosassoni deve essere una specie di ginnastica quotidiana. Un buon riferimento, specialmente se scrivete documenti in lingua inglese, è www.dailywritingtips.com.

I siti anglosassoni a volte eccedono in una titolazione "ad effetto" del tipo... "Trovare la felicità totale universale assoluta in 5 mosse"
... oppure...
"Le 8 regole per conquistare una donna anche se non siete Brad Pitt".

Ma al netto di qualche titolo ingenuo e di qualche contenuto "furbo" (ri-proposto e ri-fritto e ri-elaborato da cose già viste/lette) si possono trovare delle buone idee.

Ad esempio, c'è un intera sezione dedicata ai freelance writing, di cui vi ho parlato nel post precedente.

Divertitevi!

Lavorare come Technical Writer freelance

2011-08-03T15:06:00.003+02:00

Nei primi post del 2009 ho raccontato come ho iniziato a fare il Technical Writer.

Uno dei fattori fondamentali che mi hanno avviato a questa nuova attività è stato quello di lavorare dentro un'azienda all'avanguardia nel suo settore di competenza, sensibile all'innovazione tecnologica e allo sviluppo di nuovi prodotti.

In Italia non sono molte le aziende di questo tipo, ma quelle che ci sono hanno ormai maturato la consapevolezza di doversi avvalere dei servizi di un Technical Writer. Quando non decidono di assumerlo in pianta stabile, possono sempre avvalersi di professionisti freelance.

L'opzione di lavorare freelance, abbastanza rarefatta fino a 10-15 anni orsono, oggi si sta diffondendo e ci sono fondate ragioni per credere che si diffonderà ulteriormente, come del resto già è successo nei paesi anglosassoni o asiatici.

Ma come si fa ad intraprendere un'attività di questo tipo come freelance?

La risposta è meno lineare di quanto si potrebbe ipotizzare. Difficilmente un TW può iniziare a lavorare freelance senza una consolidata esperienza di almeno 4-5 anni, ad un certo livello. Il secondo passo decisivo consiste nel poter disporre di un minimo di portafoglio-clienti (diciamo almeno 2 o3, per iniziare) o poter accedere ad una platea di "clienti potenziali" con i quali entrare in contatto.

Come sempre, non esistono formulette magiche che vanno bene per tutti, ma sicuramente ci sono alcune idee che vale la pena di prendere in considerazione per orientarsi.

Freelance Directories
La prima cosa che si può fare è iscriversi ad una piattaforma di intermediazione on-line che tende a far incontrare la domanda e l'offerta. Ce ne sono molte, ve ne segnalo solo due tra le più note: Freelancer e Twago. In particolare, Twago è uno dei maggiori operatori europei del settore e il suo funzionamento è molto semplice.

Ma che vuol dire lavorare Freelance?

Non si può rispondere in due righe, ma potete leggere i siti/blog dei professionisti più affermati del settore, per provare ad intuire molti aspetti della questione. Alcuni li ho già presentati in passato e sono stabilmente scolpiti nella sezione DA VISITARE di questo blog. Ma stasera vi presento un nome nuovo, quello di Claudia Zedda, che ho scoperto per caso e mi ha sorpreso piacevolmente. Claudia gestisce ben 4 siti ma uno in particolare si chiama Essere Freelance e riporta molte informazioni utili sull'argomento.

Come promuovere il proprio profilo professionale?

Se non avete spirito d'iniziativa e auto-disciplina organizzativa, forse sarà complicato lavorare freelance. Uno degli aspetti ineludibili è l'autopromozione. Coltivare relazioni e "far vedere"/dimostrare le proprie competenze non è un optional, è obbligatorio. La Rete è una valida alleata. Gestire un blog incentrato sulle tematiche della vostra professione può essere un'idea, come partecipare attivamente ad un gruppo specifico su Linkedin o pubblicare le proprie presentazioni su Slideshare o i propri documenti su Scribd.

Poi ovviamente potete elencare le referenze maturate a valle di progetti portati a termine con successo, magari testimoniate esplicitamente dai vostri clienti.

Insomma, la Rete è un sub-strato pressocchè insostituibile in quest'ottica.

E dal punto di vista economico cosa ci si deve attendere?

Lavorare freelance, nell'immaginario un pò superficiale di molti, è sinonimo di libertà di orario e di auto-organizzazione, senza dover sottostare ad un capo e con carta bianca nel relazionarsi con i clienti. In linea di massima, c'è del vero, ma non sono solo rose e fiori.

Dovrete aprire una partita IVA, scegliendo tra i regimi fiscali disponibili. Vi consiglio caldamemente di affidarvi ad un buon commercialista per orientarvi nella jungla delle prescrizioni previste. Se aderite al regime IVA ordinario, con buona approssimazione dovrete attendervi un impatto fiscale superiore al 50% del fatturato, al quale dovete sommare i costi del commercialista e altre cosucce, come ferie e malattie non retribuite.

Di seguito, vi propongo una tabellina "spannometrica" che ho copiato nel bel mezzo di una discussione nata in un gruppo di Linkedin, previa autorizzazione dell'autore.

LORDO AA       NETTO AA       NETTO MM
€ 30.000,00    € 13.800,00    € 920,00
€ 35.000,00    € 16.100,00    € 1.073,33
€ 40.000,00    € 18.400,00    € 1.226,67
€ 45.000,00    € 20.700,00    € 1.380,00
€ 50.000,00    € 23.000,00    € 1.533,33
€ 55.000,00    € 25.300,00    € 1.686,67
€ 60.000,00    € 27.600,00    € 1.840,00
€ 65.000,00    € 29.900,00    € 1.993,33
€ 70.000,00    € 32.200,00    € 2.146,67
€ 75.000,00    € 34.500,00    € 2.300,00
€ 80.000,00    € 36.800,00    € 2.453,33
€ 85.000,00    € 39.100,00    € 2.606,67
€ 90.000,00    € 41.400,00    € 2.760,00
€ 95.000,00    € 43.700,00    € 2.913,33
€ 100.000,00 € 46.000,00    € 3.066,67

La tabella tenta di paragonare le entrate di un professionista freelance a quelle di un lavoratore dipendente, applicando al fatturato una pressione fiscale molto "ottimista" del 54% e dividendo in 15 mensilità le entrate annuali (come nel caso di un dipendente che ha le 14 mensilità e il TFR).

Anche se i calcoli non fossero precisi al centesimo, l'ordine di grandezza è sostanzialmente verosimile.

In base ai dati che ho frammentariamente raccolto da più fonti, spesso non ufficiali (chiunque volesse contribuire in tal senso è benvenuto), credo di poter dire che un TW freelance si colloca verosimilmente in una forbice di compenso giornaliero che può oscillare tra i 200 e i 320 Euro; se ipotizzate ottimisticamente di poter disporre di 200 gg. di contratto all'anno, il relativo fatturato oscillerà tra i 40.000 e gli 64.000 Euro lordi l'anno.

Come vedete, quando ci sporchiamo le mani con i numeri, la poesia si dirada e ci si rende conto che gli aspetti positivi sopraindicati hanno un prezzo, anche perchè in tutti i ragionamenti proposti sono partito da ipotesi abbastanza ottimistiche.

Il livello della domanda cresce...
La domanda delle aziende per il ruolo di comunicatore tecnico/TW è in lento ma costante aumento, a fronte di un'offerta qualificata molto limitata, almeno in Italia, dove questa professione è ancora semi-sconosciuta.

Cosa possiamo concludere?
Che ci sono buone speranze per immaginare che questa nicchia professionale si allarghi e possa abbracciare una platea crescente di professionisti.

In un paese come l'Italia, che non è un paese leader dello sviluppo tecnologico mondiale, non ci si può aspettare una crescita troppo rapida ma ci si deve affidare principalmente alle piccole aziende più lungimiranti, che hanno voglia e coraggio di investire in ricerca e sviluppo di prodotti tecnologici, ambito nel quale la figura del Technical Writer può trovare una collocazione di rilievo, anche in ottica freelance.

La Qualità nella documentazione tecnica: il processo di validazione di un documento

2011-07-19T22:15:00.000+02:00

Questo post si riaggancia ad un filone al quale tengo molto e per il quale ho scritto molto in passato:

Lo Zen e la Qualità della documentazione tecnica
La Qualità della documentazione tecnica: Chiarezza e Sintesi
La Qualità non è un pranzo di gala
La Qualità della documentazone tecnica: la Leggibilità
La Qualità nella documentazione tecnica: lo scalpello di Michelangelo... o la sua mente?

Oggi voglio illustrare un altro aspetto che contribuisce in maniera decisiva ad incrementare la Qualità di un documento, cioè il processo di controllo e validazione che deve sempre essere implementato per ridurre al minimo sia gli errori sostanziali e di contenuto, sia quelli formali e linguistici.

Come sapete, di solito evito di parlare troppo in astratto di quello che le migliori teorie prevedono e suggeriscono, perchè in tal caso il rischio di friggere aria già fritta da altri si fa concreto.

Quindi vi racconto in che modo lavoro io quando devo documentare un prodotto software realizzato nella mia azienda.

Il processo di controllo e validazione nel mio caso prevede 3 figure standard:

Writer
Inspector
Approver

Writer è colui che realizza materialmente il documento, relativo ad un determinato prodotto.

Inspector è usualmente colui che realizza il prodotto; nella letteratura anglosassone è anche indicato come SME (Subject Matter Expert).

Approver è di solito un Supervisore del SME, che è designato quale responsabile tecnico per la progettazione del prodotto.

Il Writer procede sulla base delle sue conoscenze dirette del prodotto e/o dei dati ricavati dalle interviste allo SME. Egli si occupa di definire e rendere facilmente comprensibili tutti gli aspetti funzionali del prodotto, nonchè di curare tutti gli aspetti formali, linguistici, grafici, stilistici e redazionali del documento.
Al termine, sarà compito dell'Inspector verificare che i contenuti del documento siano sostanzialmente congruenti alle caratteristiche tecniche effettive del prodotto. La figura dell'Approver ha il compito della revisione finale che certifica l'effettiva corrispondenza di quanto descritto, anche in funzione del suo ruolo di Supervisore.

Questo schema a 3 livelli si è rivelato semplice ed efficace. Aumentare a dismisura il numero di livelli di controllo non sempre migliora la Qualità del documento mentre è quasi sempre causa di ritardi nel suo rilascio ufficiale.

Tuttavia lo schema può essere "specializzato" al bisogno.
Dal 2008 io scrivo i manuali direttamente in inglese ma ho bisogno di un assistente "madre-lingua" che ripulisca i miei testi da qualche stortura linguistica. Questa figura coincide con quella di un Inspector "specializzato", che può intervenire sia prima che dopo l'Approver e che si occupa esclusivamente di implementare alcune tecniche di proofreading.

Questo semplice workflow prevede quindi 4 figure.

Un processo di questo tipo non assicura l'eliminazione di qualsiasi tipo di errore, ma di certo è in grado di risolvere un gran numero di difetti sostanziali e formali, aumentando senza alcun dubbio la Qualità del documento validato rispetto al documento di partenza.

Ora CrossIdeas è anche un open group su Linkedin!

2011-07-04T00:09:00.000+02:00

All'inzio del mese di Giugno vi avevo annunciato la nascita di CrossIdeas.

Ora c'è anche un gruppo su Linkedin e se siete curiosi e volete sapere di cosa ci occupiamo, vi invito ad aderire:

http://www.linkedin.com/groups/CrossIdeas-Ideas-Identity-Access-Governance-3985170?gid=3985170&trk=hb_side_g

Vi aspettiamo!

Sarebbe meglio non cambiare inutilmente il SUBJECT di una mail...

2011-07-03T01:01:00.000+02:00

Scrivo e ricevo mail da anni, come credo molti di voi. Nel mio hard disk sono scrupolosamente catalogati e salvati decine di migliaia di messaggi, con periodici ed inesausti backup, il tutto finalizzato a poter rintracciare, al bisogno, quella particolare mail di lavoro o altro.

Ma ancora oggi, dopo anni di pratica in cui tutti noi avremmo dovuto imparare le regole di base, mi schianto contro coloro che CAMBIANO IL SUBJECT di una mail senza alcuna seria motivazione! Risultato? Viene interrotto il filo logico che lega un prolungato scambio di messaggi tra due o più persone e risulta quindi quasi impossibile impostare, a distanza di tempo, quei comodissimi filtri di ricerca imperniati su una o più parole chiave del subject medesimo!

Se il subject fosse rimasto intatto, sarebbe un gioco da bambini recuperare tutto il thread... ma se qualcuno, senza giustificato motivo, lo cambia... la faccenda s'intorbida!

La pensa come me anche Lynn Gaertner-Johnston che ha scritto un post sull'argomento sul suo blog.

In un post del Marzo 2010 avevo indicato, alla Regola n°2, la necessità di cambiare il subject SE E SOLO SE, scambiando numerosi messaggi con il/i vostro/i interlocutore/i, si verifica una decisa variazione dei contenuti rispetto alla fase iniziale dello scambio.

In fondo basta poco per evitare di complicarci inutilmente la vita!

La lettera di Presentazione: sempre più apprezzata tra i recruiter

2011-06-15T07:14:00.000+02:00

In questo blog, in più di un frangente, vi ho parlato della lettera di Presentazione (Motivazione), cioè di quel documento che DEVE accompagnare un CV e che spesso svolge un ruolo decisivo al fine di "farsi scegliere" da un selezionatore del personale per poter sostenere un colloquio di lavoro.

Oggi vi segnalo un articolo di Jobonline inerente ad una ricerca condotta dalla società di recruiting Robert Half.

Tale ricerca, effettuata su un campione di circa 2000 manager (di cui 200 italiani), dimostra come la stragrande maggioranza dei manager coinvolti nel processo di selezione (71%) ponga l’accento innanzitutto sulla lettera di Presentazione che accompagna la candidatura. Per chi voglia approfondire l'argomento, vi rimando ai post seguenti:

Saper scrivere... la lettera di Presentazione

Lettera di Presentazione: qualche esempio

Ho cambiato azienda... è nata CrossIdeas!

2011-06-08T23:00:00.003+02:00

Da qualche giorno è nata CrossIdeas!
E quando nasce una nuova azienda è sempre una buona notizia.

CrossIdeas è la nuova denominazione dell'azienda che ha creato IDEAS, soluzione per l'Identity and Access Governance, ed è figlia di un'operazione di management buy-out da Engiweb Security, la società per la quale ho lavorato negli ultimi 10 anni.

Alberto Ocello, CEO di CrossIdeas, ha dichiarato: "IDEAS è considerata da numerosi analisti internazionali una tra le più innovative soluzioni nell'area dell'Identity Governance Risk and Compliance... CrossIdeas ci consentirà di operare sul mercato internazionale attraverso nuove strategie di prodotto e partnership finalizzate a migliorare il valore della soluzione ".

Questa azienda si configura propriamente come un'azienda "di prodotto", leader nel campo delle soluzioni per l'Identity Management e la Risk Governance delle grandi organizzazioni, nonchè nella ricerca e l'innovazione di nuovi paradigmi di Role Mining.

In CrossIdeas continuerò ad occuparmi della progettazione, realizzazione e gestione di tutta la documentazione aziendale, in qualità di Technical Documentation Manager (... scritto così sembra veramente fico!).

In aggiunta mi occuperò, nel ruolo di Technical Trainer, di definire e progettare le attività di formazione sia relative al personale interno che verso i partner aziendali che utilizzeranno i nostri prodotti... e quindi anche qui documenti a go-go!

Quando inizia una nuova avventura cambiano le prospettive, aumentano gli stimoli e le relative difficoltà fanno parte del gioco. Ci sarà tanto da lavorare, specie nei primi 6-12 mesi, e di certo non avrò nemmeno il tempo per spararmi su un piede!

Tuttavia farò il possibile per non trascurare il blog e ho in mente anche qualche sorpresa per la prossima estate.

Senza nulla a pretendere... volevo rendervi partecipi!

Come farsi riconoscere in rete: la tavola periodica dei "Ranking Factors"!

2011-06-04T18:18:00.000+02:00

Oggi ho trovato in rete una cosa molto interessante, the Periodic Table of SEO Ranking Factors, una tavola periodica del tutto simile a quella classica degli elementi chimici, in cui sono evidenziati i fattori fondamentali che contribuiscono ad aumentare o diminuire il nostro "page rank".

La struttura della tavola viene illustrata in maniera molto efficace e potrete facilmente rintracciare molti dei concetti che ho affrontato nei post del mese di Aprile e di Maggio, a partire dal primo datato 14 Aprile.

Ad esempio, tra i fattori premianti che sono sotto il nostro diretto controllo (in alto a sx nella tavola), sono indicati la qualità dei contenuti, la struttura HTML della pagina e se la gerarchia delle pagine del sito favorisca il crawling dei motori di ricerca.

Vi sono poi dei fattori che sono parimenti importanti ma che generalmente non sono sotto il nostro controllo (anche se ho in parte contestato questa schematizzazione):

Vi lascio la curiosità di indagare questa tavola che riassume in maniera sintetica e graficamente efficace molte delle variabili che entrano in gioco quando vogliamo realizzare dei contenuti Web "di successo" e che io ho solo parzialmente illustrato nei post precedenti, scegliendo di trattare brevemente solo le variabili che ritenevo più interessanti.

Tenete presente che gli algoritmi di Google tengono conto di ben 200 fattori principali e circa 10.000 fattori secondari! Ecco perchè diventare un SEO Expert non è banale!

Come farsi riconoscere in rete... altri spunti.

2011-05-27T17:32:00.000+02:00

A partire dal post del 14 Aprile e in quelli sucessivi, ho cercato di fornirvi alcuni elementi di base per capire come si possano rendere più "interessanti" i nostri contenuti rispetto ai criteri che utilizzano i Motori di Ricerca per costruire il "page rank", cioè la classifica delle pagine internet più "rispondenti" ad un set di parole chiave indicate da un utente.

Oggi vi segnalo velocemente un articolo di Michael Cohn, che è fondatore e Chief Technology Officer della CompuKol Communications LLC.

Nell'articolo sono citate alcune delle tematiche che ho affrontato anche io ed altri elementi aggiuntivi.

Non è finita qui... ma per oggi si.

Il paradiso del Technical Writer... ma proprio tanta roba!

2011-05-22T21:53:00.009+02:00

Vi capita a volte di navigare "a zonzo", seguendo un filo non troppo certo, magari mentre vi state rilassando un pò sul divano, alla fine della giornata, mentre il televisore è accesso su un programma a caso... beh, a me capita.

E quando sto in questa particolare condizione, già predisposto allo spegnimento del cervello, mi capita, senza alcun merito, di trovare delle "hidden gems", delle perle nascoste come la Technical Communication Library, che mi "risvegliano" l'attenzione.

Per chi si interessa di comunicazione tecnica è una specie di "paese dei balocchi", con migliaia di articoli e documenti di ogni genere, suddivisi per categorie e prodotti.

Qualche curiosità? Ho trovato indicizzato un articolo del 1878, di tal Sanders, purtroppo non accessibile, intitolato "How to Make our Ideas Clear". Come vedete, le grandi domande sono sempre attuali... come ci insegnano Dante, Shakespeare, Kant,... e Sanders!

Io ho appena iniziato a scalare questo Everest di contenuti in continuo aggiornamento... divertitevi!

Incidenti sul lavoro: quando la documentazione aiuta a salvare delle vite

2011-05-20T01:26:00.000+02:00

Ne avevo già parlato in un post del 29-12-2010 ma purtoppo questo argomento è sempre attuale nel nostro paese. Anche stavolta lo spunto mi arriva da Unistudio, dal cui sito si può scaricare un documento pubblicato sul sito dell'INAIL nel Gennaio scorso. Tra le molte informazioni interessanti riportate nel rapporto, spicca il dato relativo al fatto che il 32.9% degli infortuni mortali è causato da carenze o inesattezze delle istruzioni per l'uso delle macchine.

Credo che sia un dato clamoroso.

Per il resto vi rimando alla lettura integrale del documento, sottolineando ancora una volta quanta strada c'è ancora da fare nella cultura aziendale di migliaia di piccole e medie imprese che concepiscono la documentazione tecnica solo come una costosa scocciatura, cui dedicare solo pochi spiccioli, incuranti anche delle pesanti conseguenze penali a carico del costruttore che non rispetta i dettami e le best practice della Direttiva Macchine.

Come implementare una “link strategy”?

2011-05-15T09:46:00.015+02:00

Se qualcuno, nel proprio sito/blog, decide di collocare un link ad una nostra pagina, è come se dicesse: “…questa cosa mi piace e ve la segnalo perchè potrebbe piacere anche a voi...”. Un evento di questo tipo equivale ad un “voto” positivo, un apprezzamento che contribuisce a migliorare la nostra reputazione nel Web (la nostra link popularity). Ma la link popularity è un fattore INTERNO od ESTERNO?

In una certa ottica è ESTERNO perché dipende da un’azione concreta svolta da qualcuno. Ma questo qualcuno ci darà un “voto” positivo perché apprezza i nostri conenuti, quindi in questo senso ritorniamo allo schema del fattore INTERNO. Ovviamente, anche l’attività dei nostri “concorrenti” influenza il nostro posizionamento. Se un sito affine realizza contenuti migliori dei nostri, altri siti preferiranno “linkare” il nostro concorrente e i Motori di Ricerca lo premieranno facendolo salire nel ranking.

Anche per questo motivo i SEO tendono a catalogare la link popularity come un fattore ESTERNO.
Pur riconoscendo la sua natura prevalente di “fattore ESTERNO”, noi possiamo mettere in atto strategie AUTONOME ED ATTIVE (quindi INTERNE) per promuovere la nostra link popularity.

Operiamo una prima distinzione tra link IN USCITA e IN ENTRATA.
I link IN USCITA sono quelli che portano il lettore verso siti esterni. Vanno scelti con cura, devono essere autorevoli e dovete periodicamente verificare la loro raggiungibilità. Non siate egoisti, non abbiate paura di “pilotare” i vostri lettori verso altri siti vicini alle tematiche che trattate di solito. Potete anche classificare i link in uscita in diverse sezioni. Nel mio blog, in basso a destra, potete trovare 3 sezioni distinte:

- DA VISITARE

- TOOLS & RESOURCES

- AMICI E CURIOSITA’

Inserire link verso altri siti può attirare l'attenzione dei rispettivi proprietari, i quali possono ricambiare il favore (convogliando verso il nostro sito dei link IN ENTRATA) oppure iniziare a seguirci. I link dovrebbero essere scritti usando una o più keyword “efficaci” (il cosiddetto "testo di ancoraggio"), e non nella forma più banale www.nomesito.it.

Come già accennato, se tanti siti linkano una mia pagina, significa che quest’ultima propone contenuti di qualità da suggerire all’utente che fa una ricerca. Ma è possibile mettere in atto una link strategy per migliorare questo aspetto? Si, e deve tener conto principalmente dei seguenti 6 fattori:

OTTENERE LINK DA MOLTI SITI DIVERSI
Il ragionamento dei Motori di Ricerca è semplice: questo sito piace a tante persone, quindi va premiato con un ranking elevato.

ANCHOR TEXT MIRATI
Non conta solo quanti link puntano verso il nostro sito ma anche come lo fanno, cioè con quale anchor text (la porzione di testo che viene linkata) che deve essere costruito con keyword mirate.Se un nostro referrer utilizza un anchor text poco rilevante per le keywords che ha scelto (dei banali “clicca qui” o “visita il sito”), è bene contattarlo e chiedere che venga modificato.

LINK JUICE
Se un sito linka una nostra pagina, automaticamente passa a quest’ultima parte del suo PageRank per l’effetto “link juice” (a meno che il link non contenga l’attributo “nofollow”). Quindi dovremo ottenere non solo tanti link, ma link di qualità, cioè provenienti da pagine con Page Rank elevato.

SOCIAL NETWORK
Quando scriviamo un post dobbiamo segnalarlo sui social network più noti (Facebook, Twitter, Linkedin, Scribd, Delicious…) affinché venga diffuso il più possibile tra i nostri contatti e possa essere citato da altri siti.

SCRIVERE SU ALTRI SITI COME GUEST
Se produciamo articoli da pubblicare su altri siti che trattano argomenti affini ai nostri, abbiamo il duplice vantaggio di creare un ingresso al nostro sito e avere un controllo maggiore su quello che scriviamo.
Anche intervenire in risposta ad un post, ci consente di segnalare la nostra presenza in rete; coloro che leggeranno quel post probabilmente leggeranno anche il nostro intervento e poi verrano sul nostro sito.

BLOG DIRECTORY
I miei post li potete trovare anche su www.Liquida.it, uno dei siti italiani più "cool" per la condivisione/pubblicazione di contenuti Web.
Ci sono molte blog directory in cui si possono pubblicare i propri post.
Eccone alcune, in rigoroso disordine alfabetico:

www.katalogato.com/
www.segnalasito.net/
www.articoligratis.com/Directory/Root/1/
www.blogitaliani.net/
blogsitelist.com/
it.blogbabel.com

Alcune di queste risorse sono free, altre offrono un servizio free di registrazione e poi dei servizi aggiuntivi a pagamento. Se volete una “corposa” raccolta di blog directory, potete curiosare qui:

www.web-directories.ws/Press/Blogs/

Come sempre, non coltivo la pretesa di essere esaustivo, ma spero di avervi fornito qualche spunto da valutare.

Detto ciò… provate a migliorare la vostra link strategy… e fatemi sapere!

Contenuti originali e ben strutturati: il primo "trucco"

2011-05-01T23:39:00.003+02:00

I contenuti del nostro sito sono la pietra angolare del nostro successo in rete.

Indipendentemente dai temi che affrontiamo, dobbiamo strutturare contenuti concreti, interessanti ed originali. In quest’ottica, la scelta delle parole è fondamentale per legare i concetti che vogliamo trasmettere. Una terminologia fumosa e generica non vi renderà distinguibili nell’infinto della rete.

Parole precise e correlate al tema principale vi renderanno più “visibili” ai Motori di Ricerca.

Se state parlando di “un impianto ad emissione zero”, difficilmente riuscirete ad emergere. Se invece articolate meglio il concetto, specificando “un impianto ad emissione zero che integra un modulo fotovoltaico con una sonda geotermica” state disegnando un concetto più distinguibile ed efficace.

Se volete fare concorrenza al mio blog, accomodatevi! Ma se scrivete un post intitolato “come si scrive in italiano” vi mettete in competizione direttamente con lo Zingarelli o con l’Accademia della Crusca. Se volete catturare l’attenzione dei miei lettori, forse dovreste scrivere un post del tipo “Saper scrivere il Data Sheet” oppure “Saper scrivere il Manuale di Collaudo”.

Nel set delle parole più adatte che state considerando per confezionare il vostro articolo, dovrete individuare le keyword vincenti, cioè quelle che potenzialmente possono generare un maggior volume di traffico. Esistono strumenti dedicati a questo tipo di analisi come:

• Google Keyword Tool

• Keyword Difficulty

… in grado di aiutarci a valutare il traffico potenziale che una parola può generare.

Se state scrivendo un post sulla salubrità delle acque potabili, potreste scoprire che parlare di “osmosi inversa” potrebbe risultare più efficace rispetto ad un riferimento generico ai “sistemi di filtraggio e depurazione delle acque”.

Una volta individuato un sub-set di keyword “pregiate”, dobbiamo decidere come “usarle”. Le keyword più importanti devono essere incluse nel Titolo o nel Sottotitolo di un post, che sono elementi molto attraenti per i Motori di Ricerca, come anche la scrittura della keyword in corsivo o associata ad un colore dissonante con il resto del testo.

Un altro aspetto da valutare è la loro frequenza.
Se realizzo un articolo sui treni, dovrò utilizzare la parola "treno" più volte, usando molti dei suoi sinonimi. Se al termine “treno” sostituisco la locuzione “mezzo di trasporto su rotaia trainato da una locomotiva” difficilmente avrò fortuna nel page rank. Ovviamente vi invito a non essere troppo zelanti, quindi evitate di scrivere un articolo di 1000 parole in cui citate la parola “treno” 358 volte… potrebbero consigliarvi un medico… uno bravo!

Inoltre sarebbe opportuno condensare quanto più possibile i concetti che volete esprimere.

Nei risultati di una ricerca appare un elenco di pagine pertinenti all'argomento cercato. Questo significa che, dato un certo argomento X, per favorirne l’indicizzazione dobbiamo fare il possibile per isolarlo in una singola pagina, come sto cercando di fare io in questo post, rispetto al tema indicato nel titolo.

Come vedete, il “trucco” più importante è sempre il contenuto ed il modo in cui riusciamo a “strutturarlo”.

P.S.
Ora provate a vedere quante volte compaiono i termini “keyword” e “Motore/i” in questo post.

Da cosa dipende il posizionamento del mio sito?

2011-04-24T16:05:00.003+02:00

Nei due post precedenti:

Mi si nota di più se... ovvero come farsi riconoscere in rete!

Come funziona un motore di ricerca?

... abbiamo iniziato ad analizzare il problema di ottimizzare la nostra visibilità in rete, utilizzando principi e risorse che non richiedono esborsi di denaro.

Sono molti i fattori che determinano il posizionamento di un sito nel ranking di un Motore di Ricerca. Molti esperti SEO (Search Engine Optimizer) ritengono che il ranking derivi per oltre il 50% da non meglio identificati “fattori esterni”.

Sospetto che questo faccia parte di una comprensibile strategia di marketing che i SEO mettono giustamente in campo per vendere i propri servizi e la loro competenza, della serie: se alimento l’idea che VOI non siete “padroni del vostro destino”, avrò maggior possibilità per proporvi le MIE soluzioni.

Avanzo le mie caute perplessità su tali opinioni e mi permetto di indicare 3 aree d’intervento su cui riflettere, per cercare di capire quanto delle fortune del nostro sito possa dipendere da fattori INTERNI o ESTERNI:

realizzare contenuti originali e concreti (fattore INTERNO);

gestire una "link strategy" per promuovere la nostra "link popularity" (fattore INTERNO o ESTERNO?);

strutturare le pagine utilizzando gli accorgimenti più adatti per favorire l’attività di indexing dei motori (fattore INTERNO).

Adesso qualcuno potrà iniziare a contestare questa semplificazione, magari sostenendo che vi siano altri aspetti di cui non sto tenendo conto. E' probabile che abbiate ragione... ma anche no! Nel senso che in un insieme di N elementi indagabili, bisogna pur scegliere i principali dai secondari, senza nulla togliere a questi ultimi.

Nei prossimi 3 post approfondirò i temi della classificazione appena proposta e forse vi convincerò che dipende molto da voi e poco dai capricci "di un destino cinico e baro".

Ciao... e Buona Pasqua!
:-)

Come funziona un motore di ricerca?

2011-04-17T19:51:00.006+02:00

"In Internet si può trovare di tutto!".

Quante volte avete ascoltato questa frase? O l'avete pronunciata voi stessi? Questo è l'inizio del problema. Si può morire di sete per mancanza d'acqua (nessuna informazione) ma si può morire affogati se ci riversano addosso 100.000 litri d'acqua tutti in una volta!

I Motori di Ricerca sono gli "oracoli" a cui possiamo "chiedere" di cercare un argomento sulla rete per noi, specificando una o più parole per ottenere una lista di tutti i siti che contengono tali parole. Ogni motore utilizza delle tecniche di ricerca specifiche. Per verificarlo, basta fare la stessa ricerca, con motori diversi, ed osservare che si ottengono liste di siti diverse.

Tutti i motori però fanno essenzialmente queste tre cose:

cercano le informazioni sulla base di un pattern di parole chiave (crawling)

mantengono un indice di tutte le parole (indexing)

propongono un elenco di risultati ordinati in base alla rilevanza rispetto al pattern di parole chiave specificate nella ricerca (ranking)

E’ evidente che i motori di ricerca siano "affamati" di contenuti e cercheranno di premiare i siti con contenuti di qualità, perché la fidelizzazione dell’utente sarà proporzionale alla qualità del ranking che il motore riuscirà a proporre.

Nella fase di crawling, i motori di ricerca usano i cosiddetti Spiders, ovvero dei programmi che partendo da una singola pagina Web (solitamente dalla home page) navigano attraverso tutte le pagine ad essa collegate.

Per ogni link trovato nelle nostre pagine, lo Spider aprirà una nuova sessione ed effettuerà ricorsivamente la navigazione accedendo agli altri link presenti, provvedendo a memorizzare le parole trovate e la loro frequenza (il "peso").

Questa attività è propedeutica all'attività di indexing.

Il modo in cui le parole vengono selezionate e pesate può differire a seconda del metodo di indicizzazione usato. Google considera solamente le parole ed esclude gli articoli (a , al, di ,in ....) per velocizzare la ricerca, mentre Altavista indicizza tutte le parole (articoli compresi) per fornire risultati più esatti. Altri motori considerano soltanto le 100 parole con frequenza più elevata. Quindi il vostro sito risulterà posizionato differentemente in base al motore utilizzato per la ricerca.

A questo punto, forse dovremmo domandarci come si arriva a definire "il peso" di una parola presente nelle nsotre pagine. Indipendentemente dai diversi algoritmi adottabili, tutti i motori si basano sull'analisi dei Meta tags. Le parole associabili a specifici Meta tags assumono automaticamente un peso più rilevante rispetto alle altre.

Google, ad esempio,memorizza, per ogni parola, tipo e grandezza del font, nonchè il colore, ed usa tali attributi per ottimizzare la ricerca.Quindi le parole scritte con un font più grande (tipicamente il Titolo ed il Sottotitolo) avranno un peso maggiore rispetto al resto del documento.

I Meta tags sono dei tag html che possono essere usati all'interno di una pagina web per permettere ai motori di ricerca di indicizzare con maggior precisione la pagina stessa. Nel template del mio blog, ad esempio, ho indicato alcuni termini quali technical writer, scrivere, scrittura, manuale, tecnico, grafica, scrittore, ICT, IT, writer, babele, mestiere, artigiano, artigiano di babele, esercizi, manual, modello, model, business, communication, template, layout.

Rispetto a tali termini, Google posizionerà quanto meglio possibile le pagine del mio blog, ogni volta che un utente specificherà un pattern di ricerca contenente una o più parole contenute in tale lista.

Nei prossimi post cercherò di approfondire le tematiche che vi ho presentato oggi. A presto.

Mi si nota di più se… ovvero come farsi riconoscere in rete!

2011-04-14T00:39:00.014+02:00

In una famosa scena di “Ecce Bombo” di Nanni Moretti, il problematico protagonista (Moretti medesimo) si interroga se sarà più avvertita la sua presenza o la sua assenza:

Chi realizza un blog lo fa per innumerevoli motivi, ma è indubbio che, indipendentemente dalle tematiche trattate, ognuno fa del suo meglio per farsi notare, cioè per “farsi leggere”.

Come il protagonista del film, spesso anche solo inconsciamente, ci chiediamo “…mi si nota di più se…”. Del resto, se non avessimo interesse a comunicare, perché dovremmo scrivere un post e pubblicarlo?

Quando poi realizziamo un sito finalizzato ad un scopo commerciale/professionale, allora la questione assume contorni ben più strutturati, perché “farsi leggere” diviene uno dei pre-requisiti di base per il nostro successo professionale.

La maggior parte dei nostri potenziali lettori arriverà sulle nostre pagine attraverso i motori di ricerca. In rete vi sono centinaia di pagine che suggeriscono “trucchi” di ogni tipo al fine di indurre tali motori a “trovare” più efficacemente le nostre pagine.

Fin da ora, vi anticipo la mia tesi: i trucchi aiutano, ma non servono a nulla se non avete argomenti interessanti da proporre.

Nei prossimi post proverò ad analizzare sinteticamente i passaggi salienti della questione senza avere, come sempre, la pretesa di esaurire l’argomento. Gli aspetti fondamentali da analizzare sono i seguenti:

Come funziona un motore di ricerca?

Da cosa dipende il posizionamento del mio sito?

Contenuti originali e ben strutturati: il primo "trucco"

Come implementare una "link strategy"?

A presto.

Again on White Paper: un Webinar che si preannuncia interessante

2011-04-04T22:09:00.005+02:00

Jonathan Kantor è uno dei "guru" riconosciuti sull'argomento - White Paper - e ci propone un Webinar che si preannunica interessante, intitolato:

9 Ways to Overcome Most Common White Paper Lead Generation Mistakes

Se volete iscrivervi, seguite questo link.

A Settembre del 2010 avevo scritto un articolo, suddiviso in 2 post distinti, in cui elencavo 8 errori di base da evitare nella realizzazione di un White Paper.

In questo Webinar, Kantor ci promette di stigmatizzarne 9... bhe... ma lui è più bravo di me!
;-)

Che cosa preferiscono i miei lettori?

2011-03-30T00:40:00.009+02:00

Poco più di due anni di blog e ad un certo punto mi viene la curiosità di capire cosa preferiscono i miei lettori.
Ed ecco la classifica dei 15 post più letti, tratti direttamente dalle evidenze di Google Analytics:

1 - Lettera di Presentazione: qualche esempio

2 - Saper scrivere... la Lettera di Referenze

3 - Proteggere i nostri documenti con una password

4 - Saper scrivere... la Lettera di Presentazione

5 - L'uso dell'accento: regole sui monosillabi

6 - Saper scrivere... il Curriculm Vitae

7 - Saper scrivere... la Lettera d'Incarico: un primo esempio

8 - Saper scrivere... un Tutorial

9 - Esempi di Tutorial

10 - Proofreading everywhere!

11 - Saper scrivere una e-mail: 15 regole da ricordare

12 - Aggiungiamo le note al nostro Template

13 - Recuperiamo i doc danneggiati

14 - Come approcciare gli esercizi di riscrittura

15 - Gli 8 errori da evitare in un White Paper: seconda parte

Cosa possiamo dedurre da questo elenco?
Intanto che esiste una notevole sensibilità sul tema del lavoro e di questi tempi non è un dato sorprendente.Tutte le tipologie di documentazione che sono correlate a questo tema (saper scrivere il CV, la lettera di Presentazione, la lettera di Referenze) sono ai primissimi posti della classifica.

Più in generale, c'è un notevole interesse sul "saper scrivere" le più comuni composizioni che si possono incontrare in qualsiasi ambito professionale.Ma anche le problematiche più intricate della lingua italiana sono molto gettonate, a dimostrazione del fatto che esse siano effettivamente "ostiche" da dominare.

A debita distanza si collocano temi ai quali ho dedicato molto tempo ed impegno ma che sicuramente riguardano un target molto ristretto di "professionidsti" della scrittura.

Dover scrivere un Case Study, un White Paper, un Abstract è un'eventualità che di certo non riguarda la più larga parte dei lettori che frequentano il blog.

Fuori classifica possiamo trovare i post "più recenti" (che hanno avuto un minor tempo di esposizione sul blog) ma anche qualche post un pò troppo "filosofico" come quelli che ho dedicato al problema della "qualità" della documentazionew tecnica.

Anche in tal caso, un tema che può interessare ai TW professionisti, ma non alla maggiorparte dei lettori che solcano la rete per trovare risposte immediate ai loro problemi di scrittura.

Non credo che modificherò radicalmente la gestione dle blog sulla base di tale risultanze. L'idea di base è sempre quella di raccontare quanto meglio possibile le mie esperienze professionali, illustrando le caratteristiche salienti di questa professione nel modo più diretto ed efficace possibile.

Ovviamente proverò ad approfondire meglio le tematiche più gettonate ma continuerò a proporre anche idee meno "popolari" ma che ritengo comunque interessanti.

Cosa ne pensate? Fatemi sapere, mi farebbe piacere un confronto di opinioni.

Un esempio di Regola di Naming

2011-03-22T00:49:00.006+01:00

di Andrea Cargnelutti.

La prima cosa che un bravo Technical Writer dovrebbe fare, ancora prima di iniziare a scrivere, è quella di riflettere attentamente sui nomi da assegnare ai propri documenti e ai file che li contengono.

Purtroppo molto spesso nelle aziende regna la più totale anarchia su tale questione.

In mancanza di regole, ogni utente si sente libero di chiamare i file nel modo che gli è più congeniale, ricorrendo a nomi di fantasia o a misteriosi codici numerici, poco o per nulla informativi.

Questa anarchia rende anche molto difficile, se non addirittura impossibile, sia l’archiviazione che la rintracciabilità dei file.

Io mi sono dato delle regole che sembrano funzionare e che vorrei condividere con voi.

Innanzitutto ho iniziato considerando lo scopo che ha il nome di un documento/file. Il nome dovrebbe permettere l’identificazione univoca del documento/file in mezzo agli altri, associandolo al suo contenuto, come il codice fiscale che corrisponde univocamente alla nostra identità.

Il nome poi dovrebbe essere facilmente decodificabile per permettere anche agli altri di capire il nostro codice e quindi l’identità del file.

Queste considerazioni mi hanno portato a stabilire la regola seguente:

Acronimo prodotto_Codice documento_Codice lingua_Versione documento

Acronimo prodotto è il nome del prodotto (es. CPU12345).

Codice documento identifica il tipo di documento. Ho definito questo codice perché l’esperienza mi ha insegnato che è meglio mantenere il nome del file il più corto possibile. Nomi troppo lunghi potrebbero infatti creare problemi al sistema operativo, ad esempio durante le operazioni di backup. “InstMan” è meglio di “Installation Manual”.

Codice lingua indica la lingua utilizzata.

Versione documento è l’indice di revisione del documento (es. 1.0). L’ho inserito all'estrema destra del nome del file subito prima dell’estensione .docx perché così mi sembrava più veloce individuarlo, anziché disperderlo all'interno del nome.

Nella seguente tabella, ecco un paio di esempi:

Nella tabella successiva, la convenzione linguistica:

Come vedete, la regola è semplice e flessibile.
Ora ... basterà rispettarla!

---------------------------------------------------------------------------

Su questo argomento, potete leggere anche:
Regole di Naming per la documentazione.

150 anni... AUGURI Italia! Ne hai un gran bisogno!

2011-03-17T09:35:00.003+01:00

...Noi fummo da secoli calpesti, derisi, perchè non siam popolo, perchè siam divisi...

Questo è uno dei versi più amaramente attuali del nostro inno Nazionale. Di solito, siamo abituati a cantare (per chi lo canta...) solo la prima strofa dell'inno seguita dal coro, ignorando le rimanenti quattro strofe.

In questo momento, in un paese dove più e peggio che in altri periodi difficili della nostra storia, spadroneggiano e sembrano prevalere loschi e miserabili figuri, taluni vestiti in camicia verde, che fanno dell'ignoranza, della mancanza di dignità e del disprezzo delle regole e della cultura i loro vessilli, forse dobbiamo ripartire da questo verso poco conosciuto e riflettere.

Il testo integrale dell'inno, di seguito:

Fratelli d'Italia,

l'Italia s'è desta,
dell'elmo di Scipio
s'è cinta la testa.
Dov'è la vittoria?
Le porga la chioma,
che schiava di Roma
Iddio la creò.

    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò.
    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò!

Noi fummo da secoli
calpesti, derisi,
perché non siam popolo,
perché siam divisi.
Raccolgaci un'unica
bandiera, una speme:
di fonderci insieme
già l'ora suonò.

    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò.
    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò!

Uniamoci, amiamoci,
l'unione e l'amore
rivelano ai popoli
le vie del Signore.
Giuriamo far libero
il suolo natio:
uniti, per Dio,
chi vincer ci può?

    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò.
    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò!

Dall'Alpi a Sicilia
Dovunque è Legnano,
Ogn'uom di Ferruccio
Ha il core, ha la mano,
I bimbi d'Italia
Si chiaman Balilla,
Il suon d'ogni squilla
I Vespri suonò.

    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò.
    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò!

Son giunchi che piegano
Le spade vendute:
Già l'Aquila d'Austria
Le penne ha perdute.
Il sangue d'Italia,
Il sangue Polacco,
Bevé, col cosacco,
Ma il cor le bruciò.

    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò.
    Stringiamci a coorte,
    siam pronti alla morte.
    Siam pronti alla morte,
    l'Italia chiamò!
    Sì (cantato)

Ma quanto costa il lavoro di un Technical Writer?

2011-03-12T13:36:00.003+01:00

Sto attraversando un periodo di super-lavoro, uno di quei periodi che penso siano capitati a tutti, quando le cose da fare richiederebbero ALMENO un tempo T e invece non si dispone nemmeno di un terzo di T.

Sono quei momenti in cui la stanchezza tira per la giacchetta lo spiritello del malanimo e in cui ci viene da pensare: " Ma quanto mi dovrebbero pagare IN PIU' per tutto quello che sto facendo, rispetto a quello che guadagno?".

Ecco, per un TW che è chiamato a realizzare molte cose diverse, secondo schemi retributivi spesso non omogenei, la risposta a questa domanda è sempre complicata.

E' evidente che scrivere un manuale da zero è diverso dall'attività di proofreading di una bozza magari scritta da un collega. Ed è difficile paragonare il tempo di lavoro necessario a realizzare della grafica da inserire in una presentazione, rispetto al tempo che viene impiegato per impaginare tabelle e grafici già pronti.

Inoltre, tali attività assumono un diverso peso economico se siete stipendiati da un'azienda o lavorate in modalità feee-lance per quell'azienda.

Esiste una metrica universale che si possa applicare ai diversi campi d'azione di un TW? E' più opportuno ragionare "a progetto" o per tipologia di documento? Ci si deve regolare a "pagine al giorno" o "parole per pagina"?

Dal sito Editorial Freelancer Association vi propongo la seguente tabella:

Quando si tratta di numeri e statistiche, gli anglosassoni sono molto affidabili e i valori che vedete nella tabella (riferibili al Settembre del 2010), pur potendo variare anche in funzione della zona geografica, sono un buon riferimento.

Tanto per essere chiari, recentemente, via Linkedin, ho letto una proposta di lavoro free-lance che parlava di un compenso pari a 5$ l'ora per attività di editing, indirizzata al mercato indiano. Vi lascio immaginare le reazioni di molti TW davanti a questa "proposta indecente", ma la proponente, un po' stupita e piccata, ha tenuto a precisare che in India sono prezzi normali... anche se poi ha aggiunto che spesso la qualità del risultato finale lascia a desiderare! MA GUARDA!

Fin dalle scuole elementari ci hanno insegnato che non si sommano le pere con le mele, quindi è evidente, come la tabella dimostra, che bisogna individuare una metrica per ogni specifica attività.

Che ne pensate? Da parte mia, la tabella ha acuito il mio spiritello del malanimo... dovrei proprio farmi pagare di più! :-)

Un altro ospite in Open Blog: Andrea Cargnelutti

2011-02-24T23:53:00.003+01:00

Stasera vi presento Andrea Cargnelutti, uno dei miei lettori.

Vive ad Udine, dove lavora presso un'importante azienda operante nel settore dei computer miniaturizzati.

E' un Technical Writer che progetta e realizza la documentazione tecnica della sua azienda. In passato ha anche scritto per riviste specializzate di elettronica ed automazione industriale.

Frequenta il mio blog da un pezzo e, bontà sua, sostiene di averne tratto giovamento e indicazioni utili per il suo lavoro. Anche lui, come me, lavora per un'azienda che PRODUCE TECNOLOGIA (tipologia non comune, in Italia) e che quindi ha bisogno dell'apporto di un "comunicatore tecnico". A tal proposito vi segnalo due post abbastanza recenti sull'argomento:

Perchè un'azienda dovrebbe assumere un Technical Writer: prima parte

Perchè un'azienda dovrebbe assumere un Technical Writer: seconda parte

Prossimamente pubblicherò un post di Andrea sulle regole di Naming.
Spero che sia l'inizio di una bella collaborazione.

Benvenuto in Open Blog, Andrea!
:-)

OPEN BLOG GUESTS

Rossella Ferrari
Andrea Cargnelutti

Saper scrivere... l'Abstract: seconda parte

2011-02-23T00:31:00.000+01:00

Nel post del 2 Febbraio 2011 vi ho introdotto alla realizzazione dell'Abstract, uno dei componimenti classici in ambito tecnico-scientifico. Di seguito vi propongo un esempio/template standard per la sua realizzazione.

In rete potete facilmente trovare altri esempi di questo tipo. Vi rammento che l'Abstract nasce tradizionalmente in ambito tecnico-scientifico e su supporto cartaceo. Per questo motivo si preferisce usare un font come il Times New Roman, cioè un font "con le grazie", che facilitano la lettura su carta.

Tuttavia, se dovete pubblicare un Abstract su Web, allora si può tentare di innovare la tradizione e usare un Arial o un Calibri, cioè un font "senza grazie", più leggibile sullo schermo di un computer.

Vi sconsiglio di ricorrere ad un "minestrone" di font diversi. Al massimo, potete pensare di differenziare il font con cui indicate gli Autori, mentre per il Titolo ed il Corpo è opportuno utilizzare un font uniforme.

Tenete presente che, in base al contesto in cui vi trovate ad operare, potreste poi dover adottare regole di composizione ed accorgimenti specifici di quel contesto.

Tuttavia, le linee-guida che vi ho indicato sono sempre valide nella grande maggioranza dei casi.

Se volete scaricare questo semplice Template, potete farlo via Scribd.

Medical Writing e Marketing: attenzione, rigore ed efficacia sono un obbligo

2011-02-14T00:44:00.000+01:00

di Rossella Ferrari.

Ci sono situazioni professionali in cui ci si deve muovere con la stessa perizia che ci imponiamo quando visitiamo una cristalleria di Murano.
E credo che il paragone possa reggere, quando si parla di una delle aree più interessanti in cui può operare il Medical Writer, cioè quella dell’attività di Marketing delle imprese farmaceutiche (intesa come attività di base per l’informazione sui farmaci).

Tale attività riveste un ruolo critico, periodicamente al centro di corposi servizi giornalistici.
In Italia esistono diverse leggi che normano anche questa materia. In primo luogo, un Decreto Legislativo del 2006 che recepisce la Direttiva Europea del 2001; in più, esistono anche Delibere Regionali (per alcune regioni italiane), emesse dal 2001 al 2007 che regolano ulteriormente l’attività promozionale ai medici e, quindi, tutti i relativi testi scritti.

I testi scritti utilizzati per la promozione di “farmaci etici” (ossia, i farmaci che si hanno in farmacia solo presentando la ricetta di un medico) devono – di regola – essere tutti redatti riferendosi a fonti bibliografiche chiaramente indicate nel testo stesso.

Inoltre, su alcuni tipi di mezzi promozionali come, per esempio, i visual aid per il medico, i testi scritti devono essere un fedele “riporto” dalle fonti indicate.

Quindi, il punto critico spesso è la bontà delle fonti bibliografiche. Di solito, sono utilizzate pubblicazioni scientifiche il cui livello viene misurato con indici internazionali basati, a loro volta, su parametri di qualità specifici.

Prima della loro produzione, i mezzi promozionali dei farmaci etici seguono un iter di controllo e approvazione interno all’azienda farmaceutica (dipartimento medico e regolatorio interno) prima di passare all’invio per approvazione al Ministero della Salute.

Trascorso un periodo di tempo dopo il quale vale la regola del “silenzio-assenso”, il materiale può essere stampato e utilizzato dagli informatori medico-scientifici.

Ma al di là delle norme, credo che la vera sfida sia distinguere il confine tra pubblicità, informazione e comunicazione.

L’attività che le aziende svolgono sui prodotti di automedicazione (senza obbligo di ricetta medica) è prevalentemente commerciale, quindi, pubblicità.

La diffusione di conoscenza circa alcune patologie può essere considerata informazione e la comunicazione (sia sui prodotti etici che di automedicazione), permettendo di comprendere, elaborare e sintetizzare le informazioni, le può trasformare in fattori di decisione su azioni da intraprendere.

Il punto cruciale è tenere sempre presente la necessità assoluta di realizzare una comunicazione sui farmaci sempre corretta e davvero efficace.

Il blog di Rossella

SE NON ORA... QUANDO?

2011-02-13T15:19:00.000+01:00

Oggi, grazie alle centinaia di migliaia di donne e di uomini che sono nelle tante piazze di questo paese, NON MI VERGOGNO DI ESSERE ITALIANO... come purtoppo mi è capitato sovente, ultimamente.

Firmate anche voi sul sito:

http://senonoraquando13febbraio2011.wordpress.com/

Saper scrivere... il Manuale di Collaudo: seconda parte

2011-02-13T00:23:00.003+01:00

Vi ho già presentato due post relativi alla "filosofia" sulla quale basare la realizzazione di un Manuale di Collaudo:

- Saper scrivere... il Manuale di Collaudo
- Saper scrivere... il Manuale di Collaudo: prima parte

Con questo post vi presento un esempio ridotto ma concreto di come si "materializza" l'implementazione dello standard esposto nell'ultimo post.

Immaginiamo di dover collaudare un'applicazione software che implementa delle funzionalità di firma digitale.
L'albero che descrive lo spazio dei test è quello riportato di seguito:

I nodi evidenziati sono relativi alle tabelle che vengono riportare di seguito.
Nella prima tabella inquadriamo i 4 Test Design che coincidono con i nodi arancio:

Nella seconda tabella descriviamo lo scopo e la struttura del Test Design 01:

Nell'ultima riga sono indicati i Test Case di secondo livello (nodi blù).
In quella successiva, evidenziamo scopo e struttura del Test Case 01-03:

Ora siamo arrivati all'ultimo step (nodi rossi).
Non resta che definire le Test Procedure che descrivono ESATTAMENTE i passi da effettuare per testare le funzionalità elementari. Di seguito, potete esaminarne due:

Come vedete, completando interamente il processo di analisi dello spazio dei test, si arriva ad individuare delle sequenze ragionevolmente semplici (che ovviamente dipendono dalla complessità del sistema/processo che stiamo collaudando).

Se tutti i test definiti attraverso questa metodologia vanno a buon fine, potremo dire che il collaudo è riuscito.

E' evidente che in questa sede non è possibile mostrare l'intera struttura, in ogni particolare, di un Manuale di Collaudo, anche nel caso di una situazione abbastanza semplice come quella che ho focalizzato in questo esempio. Spero che gli elementi forniti siano stati sufficenti ad inquadrare le linee guida essenziali di questa metodologia. Se volete approfondire l'argomento... sapete dove trovarmi. Ciao.
;-)

Proofreading everywhere!

2011-02-05T11:08:00.000+01:00

Vi segnalo l'ultimo post di Rossella Ferrari sul suo blog, in cui si parla dell'importanza dell'attività di proofreading nell'ambito del Medical Writing. Ho scritto più volte in passato su questo argomento e in particolare:

- Febbraio 2010

- Dicembre 2009

Per me è una specie di fissazione, perdonatemi. Ma come dimostra Rossella, è un aspetto fondamentale per la qualità del processo di scrittura in ogni ambito.

Saper scrivere... l'Abstract: prima parte

2011-02-02T23:01:00.003+01:00

Qual è quel componimento che si scrive per ultimo e si legge per primo?

Questo indovinello potrebbe vagamente assomigliare a quello che la perfida Turandot proponeva al principe Kalaf.

In questo caso la risposta è di gran lunga meno insidiosa: l'Abstract.

L'Abstract è una tipologia di testo che ricade nella categoria della "scrittura breve".

La scrittura breve ha iniziato ad essere analizzata da quando si è affermato il Web, si è rafforzata da quando abbiamo iniziato a chattare e si è esaltata da quando abbiamo preso confidenza con gli SMS. Ci siamo ormai abituati a scrivere e leggere velocemente, poche frasi e poche parole, massima sintesi.

Qualcuno sostiene che tale tendenza abbia portato ad un impoverimento della lingua scritta. In realtà si tratta semplicemente di una nuova "tipologia" di comunicazione. Ma molto utile, perché un cervello allenato a condensare una comunicazione efficace in poco spazio può risultare particolarmente comodo nel mondo del lavoro, quando il tempo non è mai abbastanza ed i compiti a cui fare fronte sono sempre numerosi.

L'Abstract uno dei componimenti classici con i quali è molto probabile che ci si debba misurare, prima o poi.

Originariamente utilizzato in ambito accademico-scientifico, viene oggi utilizzato in ambiti molto diversi. Esso consiste nel riassunto del contenuto di un documento, una sintesi estremamente breve, chiara, incisiva e completa, in grado di offrire tutte le informazioni salienti in esso presenti. Indipendentemente dalla lunghezza del documento a cui si riferisce, l'Abstract non deve superare la mezza cartella di lunghezza (800 caratteri/200 parole circa), potendo estendersi ad una cartella intera solo in rari casi.

Un buon Abstract serve a “convincere” il lettore a proseguire nella lettura del documento integrale o magari a pagare una certa somma di denaro per scaricare l'articolo dal Web.

Ogni giorno, nell'ambito delle nostre ordinarie attività professionali, siamo chiamati a leggere e valutare una quantità crescente di testi e dati. La lettura di un Abstract esauriente e condensato, fedele al contenuto del documento associato, ci permette di filtrare quello che effettivamente ci interessa, riducendo notevolmente la mole di informazioni da vagliare.

Come possiamo scrivere un Abstract che riesca a “vendere” meglio il relativo articolo/saggio scientifico/convegno/documento tecnico?

La risposta a questa domanda non è univoca, ma intanto iniziamo a stabilire alcune regole di base che costituiranno la nostra "bussola".

CHI LEGGE L'ABSTRACT

Come dico sempre, in primo luogo dobbiamo focalizzare nella nostra mente il lettore "target" che dovrà leggerlo. L'Abstract viene generalmente letto da specialisti dell'argomento a cui si riferisce, quindi possiamo usare un linguaggio "per addetti ai lavori". Lo stile è asciutto, frasi brevi, sintassi accurata e lineare, il tempo verbale utilizzato di solito è l'indicativo presente.

LA STRUTTURA DELL'ABSTRACT

La prima frase deve indicare il tema. Si può usare una struttura classica, del tipo introduzione-corpo-conclusione che segua l'indice degli argomenti presentati nel documento. A partire dall'indice, è opportuno individuare una sequenza di concetti chiave e costruire una frase breve e completa in grado di delineare ogni concetto. Quindi, si dovrà integrare ogni frase così costruita in un testo fluido e coerente, ove le frasi risultino ben connesse tra loro e dove ogni passaggio logico risulti funzionale alla comprensione del tutto. Vanno banditi commenti, aggettivi e giudizi di merito sui contenuti. L'Abstract deve fornire una specie di "radiografia" del documento in oggetto,nulla di più. Nel caso classico di una ricerca scientifica, deve focalizzare l'argomento presentato nel documento/articolo,le ipotesi di partenza e le tesi finali, le metodologie utilizzate, i risultati ottenuti, le relative conclusioni.

CHI SCRIVE L'ABSTRACT

Dovrei dire, pro domo mia, un Technical Writer! E anche esperto.
In realtà, in questo caso il TW dovrebbe intervenire solo nella revisione formale e linguistica del testo.
In genere, possiamo considerare l'autore del documento stesso come la persona più indicata per sua la realizzazione.L'autore possiede in effetti la necessaria competenza per sintetizzare al meglio i concetti da lui stesso espressi all'interno del suo articolo/documento.

Il TW dovrebbe intervenire solo in seconda lettura, per risolvere qualche eventuale stortura lessicale.

Prossimamente vi proporrò un template ed un esempio. A presto.

I 25 comandamenti della buona scrittura

2011-01-25T23:51:00.003+01:00

Ieri sono andato sul blog di Luisa Carrada, come faccio quasi ogni giorno da circa 5 anni. E' una specie di profilassi che spero possa affrancarmi dal disagio della mia ignoranza, che essendo vasta e perniciosa risulta difficile da debellare.

Come spesso accade, in quel luogo ho trovato una perla scovata da Luisa, ossia i 25 Comandamenti del Giornalista di Tim Radford, pubblicati sul Guardian e tradotti in italiano da Libertà di Stampa Diritto all'Informazione.

Indipendentemente dal fatto che scriviate per mestiere o per diletto, sono 25 ottime regole degne di attenzione dalla prima all'ultima.

Ma io sono stato colpito da un frammento del comandamento N° 20:

Mosè non disse al Faraone:
"La conseguenza della mancata liberazione della popolazione di un particolare soggetto etnico potrebbe determinare alla fine qualche particolare affezione alle colonie di alghe nel bacino centrale del fiume, con delle conseguenze impreviste per la flora e la fauna, e anche per i servizi ai consumatori".

Disse invece:
"...le acque del fiume…si trasformeranno in sangue, e i pesci del fiume moriranno, e il fiume puzzerà".

Ogni Technical Writer che passeggia sul globo dovrebbe stampare questa frase in grassetto, font 20, Verdana, su un foglio A4, per poi appenderlo in prossimità della propria postazione di lavoro.

Quante volte vi siete imbattuti in avvocati che parlano e scrivono "in legalese", in medici che usano "il medichese", in ingegneri che comunicano "in ingegnerese"?

Il linguaggio "della casta" serve a mantenere e trasmettere una sorta di potere esclusivo e miserevole, così lontano dalla lingua italiana quanto dalla ragionevolezza. Chi scrive usando questi linguaggi inventati, semplicemente non sa scrivere.

Proviamo a praticare le regole di Radford e proviamo ogni giorno ad imparare una cosa nuova per comunicare meglio.

Scrittura tecnica in ambito medico-scientifico: il Medical Writing

2011-01-23T17:37:00.003+01:00

di Rossella Ferrari.

La locuzione Medical Writing definisce e comprende un’ampia gamma di attività inerenti alla comunicazione medico-scientifica e alla produzione di documentazione di informazione medica.

I testi che un Medical Writer scrive possono riguardare diverse aree tematiche:

Documentazione tecnica: dossier di tecnica farmaceutica, resoconti di prove di laboratorio o di studi clinici che attestano lo sviluppo della conoscenza su un nuovo farmaco.

Documentazione per gli enti di controllo: dossier da sottoporre ad agenzie governative come, per esempio, l’Agenzia Italiana del Farmaco, Ente pubblico che opera sotto la direzione del Ministero della salute.

Testi per aggiornamento medico: resoconti di studi clinici da pubblicare su riviste scientifiche, report di congressi, presentazioni per corsi di formazione.

Attività di marketing delle imprese farmaceutiche: materiali illustrativi del farmaco per medici generici e specialisti (su supporti cartacei o multimediali), opuscoli per pazienti, testi per siti web delle aziende stesse o di associazioni di medici o di pazienti.

Giornalismo medico-scientifico: articoli per riviste di settore e/o per stampa rivolta al pubblico, testi per la televisione.

Salute pubblica: campagne d’informazioni sulle vaccinazioni o sugli stili di vita.

Documentazione per richieste di sovvenzioni/contributi da parte di gruppi di ricerca: rivolte alla Comunità europea, ad enti nazionali e non, agenzie governative, società di Venture Capital (soprattutto nel caso di imprese biotecnologiche).

In genere un MW riesce a specializzarsi in una sola area e, sempre più spesso, vengono richiesti particolari sottospecializzazioni. Inoltre, sta aumentando anche la richiesta di competenze in specifiche aree terapeutiche come, per esempio, l’oncologia.

La grande delicatezza delle tematiche medico-scientifiche che vengono trattate, legate alla salute umana, richiedono al MW una notevole professionalità e doti di sintesi e chiarezza che assumono una prevalente valenza qualitativa ai fini del risultato finale.

Prossimamente proverò a fornire qualche elemento di conoscenza specifica su questa professione, nel tentativo di farne comprendere, almeno a grandi linee, la complessità e il campo d’azione.

Il blog di Rossella.

Saper scrivere... il Manuale di Collaudo: prima parte

2011-01-22T21:37:00.003+01:00

In questo post vi presento una metodologia per la realizzazione di un Manuale di Collaudo, basata sullo standard ESA PSS-05-0 Issue2.
Questo standard, implementato dalla Agenzia Spaziale Europea (ESA) per il test del software prodotto per i progetti ESA, si compone di diverse parti.

La parte più interessante è costituita dalla procedura suggerita per definire l'insieme dei test da effettuare, che può essere adottata anche per collaudare sistemi diversi da un software.

Questo approccio si basa su un'astrazione molto efficace relativa al seguente concetto generale: dato un generico sistema da collaudare, come si può descrivere lo "spazio dei test" che consente di verificare TUTTE le funzionalità di tale sistema?

La risposta coincide con la necessità di strutturare lo "spazio dei test" in una gerarchia ad albero.

Il nodo radice dell'albero (nodo celeste) rappresenta il sistema da collaudare.

Dal nodo radice possono derivare N nodi (nodi arancio) di primo livello. Ad ogni nodo di primo livello corrisponde una macro-funzionalità.

Ogni macro-funzionalità può essere destrutturata in più nodi di secondo livello (nodi blù) che individuano dei sottoinsiemi funzionali specifici nell'ambito della macro-funzionalità.

Ogni nodo di secondo livello può a sua volta essere caratterizzato da un set di nodi di terzo livello (nodi rossi), che rappresentano le funzionalità specifiche da testare singolarmente.

In questo schema, possono bastare 3 livelli di gerarchia per ottenere già una buona descrizione dello spazio dei test. Tuttavia, nessuno proibisce di ampliare tale spazio in ulteriori livelli gerarchici.

In alcuni contesti, ad esempio, i nodi di terzo livello possono rappresentare degli insiemi funzionali ancora troppo complessi per individuare una procedura di test univoca.

Quindi, per ogni nodo di terzo livello si dovrà scendere sul quarto livello per individuare le funzionalità specifiche da testare singolarmente.

Al termine, la singola funzionalità verrà testata attraverso una "scheda di test" che riassume tutti i passi necessari ad effettuare il collaudo di quella specifica funzionalità. Nella figura proposta possiamo contare 21 nodi rossi di terzo livello, che corrispondono a 21 test distinti. Se siamo stati bravi a disegnare l'albero, basterà superare con successo 21 test per collaudare l'intero sistema.

Come credo sia facile intuire, questo schema è applicabile a situazioni diversissime e astrae rispetto alle specifiche modalità operative di effettuazione di un test, ma serve a descrivere l'intero "spazio dei test" che deve essere esplorato per collaudare un generico sistema.

Una finestra sul Medical Writing

2011-01-16T17:10:00.006+01:00

Da quando ho aperto questo blog, ormai quasi 2 anni, ho avuto la fortuna di "incontrare in rete" molti professionisti della comunicazione che mi hanno insegnato moltissimo. Per un autodidatta della scrittura tecnica come me, questi contatti, anche solo virtuali, sono stati dei punti di riferimento che ho cercato di proporre anche a tutti coloro che leggono i miei post, convinto che il blog non debba mai essere solo un silos verticale di contenuti ben ordinati e autoreferenziali, ma un nodo di uno spazio N-dimensionale di idee e relazioni, quello che che uno studente di Matematica definirebbe un iper-cubo.

Talvolta è accaduto che qualcuno di questi professionisti abbia anche espresso apprezzamento nei confronti del mio lavoro e questo ovviamente mi ha fatto piacere.

Questo è successo anche nei primi giorni di Gennaio, quando mi ha scritto una Medical Writer, Rossella Ferrari. Avevo già sentito parlare del Medical Writing ma non avevo mai conosciuto un professionista del settore.

Rossella Ferrari, nata a Mantova, vive e lavora a Milano. Laureata in Scienze Biologiche, ha maturato diverse esperienze professionali nel settore farmaceutico, in particolare nel marketing di industrie multinazionali.

Nel 2003 ha conseguito il Master in Comunicazione Scientifica presso la Facoltà di Farmacia dell'Università degli Studi di Milano e da allora si occupa di comunicazione medico-scientifica presso agenzie specializzate, in qualità di Medical Writer.

Rossella ha subito aderito con entusiasmo al progetto Open Blog e prossimamente scriverà per me alcuni post sul Medical Writing .

Lei ha aperto da poco un suo blog ma ci siamo trovati d'accordo sull'idea della "contaminazione" tra generi affini.

Il Medical Writing può essere considerata una tipologia di scrittura tecnica estremamente specializzata in ambito medico-scientifico.

Tanto per essere chiari, mentre io potrei realizzare indifferentemente un Manuale d'Installazione per una caldaia, un Getting Started per l'utilizzo di un nuovo prodotto software o un White Paper che illustra una soluzione di telerilevamento e controllo remoto, difficilmente potrei scrivere qualcosa di molto approfondito su uno studio epidemiologico o sui risultati della sperimentazione di un nuovo farmaco.

Quando si scrive ufficialmente su qualcosa che a che fare con la salute delle persone, è necessaria una formazione ed un'esperienza specifica che poco si presta a qualsiasi tipo di improvvisazione.

Ovviamente il Medical Writing si avvale di tecniche, regole e costrutti di comunicazione del tutto analoghi a quelli che ho più volte illustrato in questo blog e in questo risiede l'affinità e la possibilità di una proficua contaminazione tra le mie tematiche e le sue.

Rossella, di tanto in tanto, ci aprirà "una finestra" su questo settore e sono certo che sarà l'inizo di una bella collaborazione, utile ad entrambi ed interessante per chi legge.

Saper scrivere... il Manuale di Collaudo

2011-01-15T09:39:00.003+01:00

In qualsiasi attività di progettazione tecnico-ingegneristica, arriva il momento di valutare e misurare quanto le soluzioni realizzate siano:

effettivamente aderenti alle specifiche di partenza

in grado di implementare le funzionalità progettate

conformi alle normative vigenti

Per verificare questi tre macro-obiettivi si passa necessariamente attraverso una procedura "di collaudo" della soluzione. La procedura di collaudo ha il compito di verificare se tutti gli obiettivi che hanno originato la realizzazione di quella soluzione sono stati effettivamente ottenuti.

Più in generale, si individua un set ben definito di caratteristiche da collaudare e si predispongono appositi test a tal fine.

photo © 2006 David Bleasdale | more info (via: Wylio)

Se tutti i test vengono superati con successo, cioè se i risultati dei test "sul campo" coincidono con i risultati attesi, il collaudo si conclude con successo. In alcuni casi, i test possono produrre risultati difformi da quelli attesi e in quel caso il collaudo potrebbe essere dichiarato "superato con riserva" o solo parzialmente.

Nei casi peggiori, il collaudo si considera fallito e la soluzione dovrà essere opportunamente rivista e corretta.

Dal superamento della procedura di collaudo spesso discendono importanti conseguenze per il fornitore, in primo luogo il pagamento di quanto pattuito da parte del committente.

Il non superamento di un collaudo può implicare danni economici e conseguenze legali.

Per la gestione di una sessione di collaudo è sempre opportuno predisporre un Documento/Manuale di Collaudo, nel quale vengono descritte tutte le caratteristiche della suddetta procedura.

Questo Manuale viene utilizzato dal collaudatore designato, per effettuare il collaudo.

Prossimamente vi illustrerò uno standard di documentazione per la realizzazione di un Manuale di Collaudo.

Tale standard descrive una metodologia generale per la documentazione di una procedura di collaudo. E' una metodologia interessante proprio perchè disaccoppia la struttura del manuale rispetto al campo specifico d'interesse e quindi può essere applicata con successo in ambiti anche molto diversi.

A presto.

Un esperimento per il 2011: da oggi ... "Open Blog"!

2011-01-10T13:10:00.006+01:00

Il 2011 inizia con un esperimento.
Sono convinto che esista molta gente che naviga in rete, che potrebbe aver voglia di scrivere e possiede argomenti ed esperienze interessanti da comunicare ma non dispone di un proprio spazio come questo.

Ciò può avvenire per diversi motivi: poco tempo da dedicare alla gestione di un blog, scarsa confidenza con le tecnologie Web 2.0, eccessiva timidezza nel proporsi o altro ancora.

Allora perchè non aprire questo blog ad eventuali "contaminazioni esterne"?

Vorrei fornire uno spazio a tutti coloro che possono dare un contributo originale al blog, che possono scrivere un post, anche solo una tantum, su argomenti afferenti alla tematica di fondo della comunicazione tecnica o della comunicazione in senso più generale.

Ovviamente non pubblicherò qualsiasi cosa che arriva da chiunque! Sarò io a decidere se e quando pubblicare e potrei essere costretto a dire più no che si, ma spero che mi mettiate in difficoltà, che mi arrivino proposte "che non posso rifiutare", come diceva Robert De Niro in una famosa scena:

Insomma, non voglio un blog che sia "una fabbrica automatica di post", ma voglio provare ad aggiungere ingredienti che arrivano dall'esterno, che seguono tracce che io magari non riesco ad approfondire, che mi segnalano idee che non ho considerato, strade strette e percorse di rado, magari piccole ma vivaci nicchie che possono rivelarsi interessanti oltre ogni aspettativa.

Mi piacerebbe intrecciare un rapporto con chi ha voglia di affrontare questo esperimento. Scrissi il mio primo post sul mito della Torre di Babele e sulla mia fantasiosa, poco ortodossa ma ottimistica interpretazione di quel mito.

L'idea di un "Open Blog", in ultima analisi, parte direttamente da quel post. Vediamo come si svilupperà.
Alla fine del 2011 potrei anche accorgermi che è stato un fallimento, ma come dice una famosa canzone "lo scopriremo solo vivendo...".

Del resto, il blog è anche un luogo dove si gioca.
:-)

Saper realizzare una Presentazione: ecco un esempio notevolissimo

2011-01-02T23:15:00.000+01:00

Mi sono imbattuto in questo filmato su YouTube.
E' una presentazione che illustra 5 regole fondamentali per realizzare delle buone presentazioni. Godetevelo. E non vi concentrate troppo sulle 5 regole, pur importanti e sacrosante. Ma sulle soluzioni espressive utilizzate per spiegare le 5 regole!

Questa è una Presentazione con la P maiuscola!

Lontana anni luce dalle centinaia di presentazioni "sorde e grige" che abbiamo realizzato o dovuto subire in tante occasioni. Ora è chiaro che l'autrice, Nancy Duarte, è una fuoriclasse del settore. Nessuno ci obbliga ad emulare certi virtuosismi. Ma ognuno di noi è obbligato a riflettere sul VERO ruolo e sull'uso delle Presentazioni nella business communication.

Non dobbiamo essere tutti fuoriclasse ma nemmeno siamo costretti a rimanere tutti ottusi fautori del copia-incolla "alla cieca" e dei punti elenco!

Per la cronaca, Nancy Duarte è CEO di Duarte Design, azienda della Silicon Valley, leader nella progettazione e realizzazione di presentazioni di alto livello, con oltre 250.000 presentazioni realizzate fino ad oggi.

Bilancio del blog nel 2010

2010-12-31T19:32:00.017+01:00

L’ultimo post del 2010 è ovviamente dedicato ai bilanci.

L’idea del blog è nata il 1° Gennaio 2009, il primo post era in linea il 15 Febbraio. Il bilancio del 2009 fu sorprendente, rispetto alle mie aspettative iniziali.

Il 2010 è stato l'anno del consolidamento.

Il blog si è confermato un'eccezionale e necessaria "palestra" di scrittura e comunicazione; mi ha fornito riscontri incoraggianti sul mercato che si sta sviluppando in Italia nel campo della comunicazione tecnica;
mi ha dato la possibilità di un confronto con professionisti del settore, più esperti di me; mi ha dato spunti per approfondire aspetti del mio lavoro, senza la pressione tipica che spesso detta il ritmo delle nostre quotidiane necessità professionali.

Senza il blog non avrei avuto la soddisfazione di essere citato da Cristina Mariani, che ringrazio ancora per l'apprezzamento, nel suo ultimo libro "Comunicazione low cost".

Voglio usare anche quest'anno l'immagine che avevo coniato alla fine del 2009: il blog ti obbliga a dedicare maggiore attenzione a tutto ciò che ha che fare con il tuo mestiere di comunicatore tecnico e con la scrittura in generale… un po’ come quell’amico che ti trascina a fare jogging perché magari da solo cederesti alla pigrizia.

E ora per gli appassionati dei dettagli, qualche elemento numerico.
Di seguito potete vedere “l’encefalogrammma” del blog durante il 2010:

Un inizio vivace, un paio di periodi "stanchi", in Aprile ed Agosto, poi da Settembre fino alla fine un sensibile e prolungato incremento di contatti,con più di un picco robusto e, per fortuna, mai “andamento piatto”!

I numeri vanno presi con le molle, in quanto il rilevamento non è sempre affidabilissmo, ma diciamo che applicando una variazione del 5%, per eccesso o per difetto, diventano numeri solidi.

Circa 13.200 visitatori; di questi, circa 3.200 ritornano abitualmente sul blog.
Il tempo medio di visita si aggira intorno ai 3’10” , per tutti i 13.200 visitatori.
I nuovi visitatori indugiano per circa 1’40”, quelli che ritornano lo navigano per circa 8’10” .
Le pagine visitate sono circa 27.000 ma se eliminiamo almeno il 20% di pagine che vengono accedute “per caso” e poi subito abbandonate, diciamo che scendiamo a poco meno di 22.000.

Ho ricevuto visite da 70 paesi diversi, anche se il 90% (circa 12.100) è concentrato in Italia:

Per un blog scritto in italiano, che si occupa di una professione di nicchia, nulla di strano. La Svizzera è il secondo paese nella classifica degli accessi.

I numeri sono del tutto analoghi a quelli esposti nell'ultimo post del 2009 e credo che questa osservazione sia confortante.

Possiamo chiudere qui.
Ci vediamo domani, nel 2011, che vi auguro pieno di salute, lavoro e serenità, che sono sempre e comunque le cose più importanti.
Ciao.

Prevenire gli incidenti sul lavoro: anche con la documentazione tecnica

2010-12-29T18:06:00.003+01:00

Vi segnalo un articolo (fonte Unistudio) che deve far pensare.

Secondo i dati INAIL, nel 2009 gli infortuni sul lavoro ufficialmente denunciati sarebbero 790.000. Di questi, molti sono risultati mortali.

L’uso errato di macchine e impianti rappresenta spesso una delle cause di tali incidenti. Troppo spesso si tiene in considerazione la sicurezza della macchina solamente nella fase di progettazione o costruzione. Ma anche se perfettamente funzionanti, le macchine possono essere pericolose se non vengono usate in modo corretto e secondo le indicazioni d'uso fornite dal costruttore.

Per tutte le macchine che ricadono nelle indicazioni della Direttiva Macchine 98/37/CE, il Manuale d’uso e manutenzione deve essere considerato un vero e proprio strumento di prevenzione degli infortuni.

Avevo accennato a questo tema nel post del 20 Novembre 2010, in particolare ai punti 2 e 3.
Mi riprometto di approfondire l'argomento in futuro, ma è evidente che, specialmente in certi settori, comprimere i costi di sviluppo della documentazione tecnica e sulla formazione delle persone che devono utilizzare certi macchinari, è una scelta estremamente discutibile se non drammaticamente miope.

Philip Kotler, uno dei "guru" mondiali del marketing, ha detto una frase molto interessante:
"Le aziende si preoccupano troppo di quanto costa fare. Dovrebbero preoccuparsi, invece, di quanto costa non fare".

Questa frase si adatta benissimo all'argomento del post, ma temo che la riprenderò in futuro perchè è ora di iniziare tutti insieme a fare dei ragionamenti sui costi nascosti del NON FARE, della NON QUALITA', della NON INNOVAZIONE, della NON SICUREZZA e di altro ancora che in qualche modo ci riguarda, indipendentemente dal lavoro che facciamo.

Saper scrivere è anche... non scrivere più di quanto basta!

2010-12-28T22:18:00.003+01:00

Asciugare, ridurre, semplificare senza distorcere il senso di una frase, sintetizzare, togliere, togliere tutto ciò che non serve. Il mestiere del comunicatore tecnico è un mestiere "a togliere"; partire dal blocco di marmo e togliere tutto quello che è "in più" e che racchiude "la statua", il concetto che vogliamo sia visibile a tutti.

Lo pensava Michelangelo quando scolpiva, lo hanno pensato moltissimi grandi scrittori, a maggior ragione lo deve pensare un comunicatore tecnico, che non scrive romanzi o altri tipi di componimenti creativi, ma scrive per aiutare altri a capire concetti da utilizzare nel loro lavoro.

Di queste cose, in quasi due anni, vi ho parlato molte volte ed ho scritto più di un post sull'argomento, racchiusi nella sezione Esercizi di riscrittura.

Ma stasera vi segnalo un post interessante di Leslie O'Flahavan, in cui si dimostra come sia possibile riscrivere un testo usando solo la metà delle parole rispetto alla stesura originale.

Provateci, è un esercizio molto utile. Prendete un testo dal Web, da un sito qualsiasi, su un argomento a caso (magari eviterei un trattato sulle particelle sub-nucleari...). Provate a riscriverlo con la metà delle parole, facendo attenzione, ovviamente, a non stravolgerne il senso. Vi accorgerete che Leslie ed io abbiamo ragione, cioè che quasi sempre è possibile migliorare un testo, asciugandolo da tutto ciò che è inessenziale.

Provateci e fatemi sapere.

BUONE FESTE!

2010-12-24T13:50:00.000+01:00

Abbiamo tutti bisogno di riposo e di speranze. Un augurio sincero di salute, lavoro e serenità a tutti i miei lettori.

E un paio di libri da regalare a chi vi sta a cuore.

Uno è un classico, "Lezioni americane" di Italo Calvino.
Per chi ama scrivere è uno di quei libri che SI DEVONO leggere. La lezione sulla "leggerezza", in particolare, dovrebbe essere mandata a memoria, come una preghiera. E chi scrive documentazione tecnica dovrebbe applicarla ogni volta.

L'altro è "Palazzo Yacoubian", un libro che ho letto di recente, di un grande scrittore egiziano, Ala Al-Aswani. Per chi ama o vuole conoscere meglio l'Egitto, aldilà degli stereotipi commerciali fabbricati per i turisti occidentali.

La Qualità nella documentazione tecnica: lo scalpello di Michelangelo... o la sua mente?

2010-12-19T12:35:00.006+01:00

Mi sono laureato in Ingegneria a La Sapienza di Roma, nella storica sede di S.Pietro in Vincoli. La facoltà è ospitata in uno splendido edificio che in origine era un convento, adiacente ad una delle più antiche basiliche romane in cui è ospitato "Il Mosè" di Michelangelo, una delle sue opere più maestose.
photo © 2005 Vento di Grecale | more info (via: Wylio)

Più volte ho avuto occasione di ammirarlo ed ogni volta c'era un particolare che mi sorprendeva: una piega del panneggio che sembrava morbida come la seta, una vena che sembrava pulsare nel possente braccio sinistro, un particolare della barba o del viso che sembravano in movimento.

Quale tecnologia ha prodotto questa meraviglia? In apparenza, un banale scalpello. Simile a quelli che ho nella cassetta degli attrezzi per i lavori domestici.

C'è qualcosa di più rozzo di uno scalpello che vi possa venire in mente? Non lo so, forse si, ma poca roba. Eppure, messo nelle mani di un genio dell'umanità, ha prodotto qualcosa di meraviglioso. Mentre nelle mie mani al massimo serve a far da leva per sollevare il tombino di cemento che ho in giardino.

MA TUTTO QUESTO COSA A CHE FARE CON IL TECHNICAL WRITING?

Nelle offerte di lavoro che ricevo attraverso i siti di JobSearch, specialmente negli ultimi 2-3 anni, sono sempre più pressanti le richieste inerenti alla conoscenza di strumenti di Authoring largamente utilizzati (RoboHelp, FrameMaker, DocBook, HTML Help Workshop, DITA, ...) che negli ultimi 10 anni si sono progressivamente diffusi, specialmente nelle aziende medio-grandi.

Tali prodotti sono divenuti via via sempre più versatili e dotati di un gran numero di possibilità.

Dispongono di funzionalità per la generazione automatica dell'indice di un manuale, per la memorizzazione dei contenuti in un DB, per l'attività di importazione/esportazione di testo da/verso il formato XML, per la pubblicazione sul Web e nei diversi formati generalmente utilizzati dagli utenti, in particolare PDF.

Indubbiamente, facilitano le operazioni di riutilizzo e di aggiornamento dei contenuti.

Lo stesso contenuto posso "montarlo" in 5 "schemi" diversi che possono generare 5 documenti diversi.
Quindi lo scrivo una volta sola, eventualmente lo traduco nella lingua che mi interessa una volta sola e lo utilizzo in 5 situazioni diverse senza dover fare "copia e incolla" ma attraverso una procedura automatizzata.
Quando questo contenuto deve essere modificato, modifico "il master" e poi propago la modifica ovunque mi necessita con un semplice click.

BELLO NO? Bellissimo! MA FATE ATTENZIONE!

Non confondete lo scalpello di Michelangelo (i sistemi di Authoring) con la mano di Michelangelo, che sta attaccata al cervello di Michelangelo che ospita la fantasia visionaria ed il genio di Michelangelo!

In altri termini, è utile conoscere tecnologie che sono in grado di velocizzare e razionalizzare il processo di produzione della documentazione tecnica. Ma tali strumenti cosa sono, nella loro essenza?

Sono dei "montatori di contenuti". E se non sappiamo scrivere e strutturare "i contenuti", cioè se non conosciamo "il mestiere di scrivere" e non applichiamo i suoi fondamentali nella realizzazione di ogni singolo contenuto, poi potremo montarli e rimontarli come vogliamo, con tutti i prodotti di Authoring di questo mondo, ma otterremo sempre un risultato scadente.

Dobbiamo quindi riflettere sull'idea che gli strumenti possano, ingannevolmente, prendere il sopravvento sul “mestiere”, pericolo tanto più subdolo quando si incarna nella skill request che viene specificata in un'offerta di lavoro.

Infatti, sembra che si stia facendo strada l'idea che trovare lavoro come Technical Writer dipenda da quanti di questi strumenti è possibile elencare nel proprio CV. Frequentemente, nei forum, il dibattito è imperniato sugli strumenti e le tecnologie emergenti, sulle metodologie di misurazione del proprio rendimento lavorativo (in termini di "pagine al giorno" o "documenti in un mese" o altro ancora), mentre accade di rado che i temi siano lo sviluppo dei contenuti e la loro Qualità.

I vantaggi offerti dagli strumenti di Authoring sono indiscutibili ma, almeno per ora, non sono di grado di produrre contenuti. E' ancora necessario un redattore per creare i contenuti e lo scopo di questi strumenti è quello di rendere più efficente e veloce la produzione e l'aggiornamento su larga scala di molti documenti diversi. Tutto qui.

Del resto, a cosa serve usare i collegamenti ipertestuali o le funzioni di ricerca rapida per scorrere velocemente un documento, saltando da un punto all'altro, se poi l'utente non trova le informazioni che cercava, oppure se queste sono incomplete?

La documentazione di un prodotto, se è di buon livello, deve guidare con semplicità l'utente all'uso efficace del prodotto e poco conta che sia stata prodotta con RoboHelp o DITA o con un "primitivo scalpello" altrimenti noto come Microsoft Word.
Su nessun manuale ho mai visto la scritta “Sviluppato con il miglior strumento di Authoring in commercio”.
Non ho mai conosciuto un cliente che abbia espresso preferenze sugli strumenti utilizzati per realizzare un Installation Manual o un Tutorial.

Quindi usiamo gli strumenti per quello che sono, traendone cospicui vantaggi di ogni genere, ma non infiliamo "la scorciatoia concettuale" di pensare che la Qualità di un documento derivi dallo strumento che usiamo per realizzarlo.

Se fosse vero, con il mio scalpello potrei scolpire capolavori come "Il Mosè" ogni giorno.
Invece non mi succede mai... :-).

Bookmarks in the cloud

2010-12-10T11:24:00.003+01:00

In questo periodo sto progettando un restyling del blog, voglio realizzare in sito professionale di auto-promozione, sto iniziando a lavorare per un nuovo cliente e sto sperimentando nuove idee.

Quindi sono in rete molte ore al giorno e quando vado su un sito che mi interessa lo navigo un po' e poi penso: "...questo ora lo registro tra i bookmark, poi ci torno con calma...".

Ma a volte capita di non avere il proprio portatile a disposizione, con tutti i bookmark ben classificati. Magari si accede ad Internet dallo smartphone o dal PC dell'albergo o da una postazione di un cliente e allora sarebbe bello avere i propri bookmark "in the cloud".

Instapaper vi consente, dopo una velocissima registrazione, di mantenere i siti visitati in una directory a voi dedicata.

Potete poi visualizzare i contenuti delle pagine Web che avete memorizzato da qualsiasi terminale (questo lo devo ancora verificare), anche in modalità ONLY TEXT se volete velocizzare il download delle pagine su terminali mobile.

Per salvare velocemente le pagine, vi mette a disposizione un bookmarklet che potete trascinare sulla barra dei bookmark del vostro browser. Ogni volta che una pagina vi interessa, premente il pulsante Read Later e la pagina sarà salvata sul server Web di Instapaper.

ATTENZIONE! NON SARA' "PER SEMPRE"!

L'idea è di un repository "temporaneo", quindi non viene data alcuna garanzia esplicita che i vostri bookmark saranno mantenuti per i prossimi 30 anni! Ma del resto ciò sarebbe anche assurdo, data la natura stessa del Web. Diciamo che sono abbastanza confidente nel fatto che tra 6 mesi potrò trovare nel Web i bookmark che ho salvato ieri, e questo mi basta.

D'altro canto, se entro 6 mesi non trovo il tempo di visitare e classificare un sito che ritenevo interessante... vuol dire che non lo era!

Spero possa esservi utile.
Ciao.

Immagini free per i vostri post: Wylio

2010-12-09T23:18:00.006+01:00

Quando si scrive un post, il potere evocativo delle immagini può essere di grande aiuto per catturare l'attenzione del lettore. Cercando in rete, ci si può imbattere in immagini coperte da copyright.

Ieri ho trovato un nuovo motore per la ricerca di immagini free, Wylio.
Tali immagini sono rese disponibili dagli autori sotto la licenza Creative Commons (uso non commerciale).

Per inserire l'immagine nella vosta pagina Web basta fare il copia-incolla di un brano di codice che già contiene i riferimenti al suo autore. Tali riferimenti sono posizionati proprio sotto il bordo inferiore dell'immagine e basterà cliccarli per ri-conoscerne la proprietà intellettuale.

Ed ecco un esmpio:

photo © 2007 D. Sharon Pruitt | more info (via: Wylio)

Wylio consente l'accesso a decine di migliaia d'immagini, ho fatto alcuni test e sono molto soddisfatto, provate ad usarlo.

Se poi volete saperne di più sulla licenza Creative Commons, potete inizare da qui.