E' stato approvato il nuovo Regolamento Macchine: con un occhio alla Cybersecurity e all'IA

Come vi avevo preannunciato in un articolo del Giugno 2021, il nuovo Regolamento Macchine è arrivato in porto!

Qui potete trovare il testo in Italiano.

Il nuovo Regolamento sostituisce la vecchia Direttiva Macchine 2006/42/CE tiene conto dei nuovi sviluppi tecnologici che investono il settore della produzione delle macchine industriali.

Alcune delle principali novità:

• L’aumento della certezza del diritto in merito ad eventuali modifiche di una macchina.
• Una più esatta definizione dei criteri per identificare macchinari potenzialmente pericolosi (nella vecchia Direttiva, macchinari ad alto rischio (Annex IV)).
• In relazione al punto precedente, l'aggiornamento ogni 5 anni dell'allegato I.
• L’inclusione dei macchinari autonomi e telecomandati, che possano eventualmente scambiare dati con altre entità (IoT) o essere integrati con engine di intelligenza artificiale, con tutte le implicazioni di sicurezza informatica che entrano in gioco in questi nuovi scenari.
• La possibilità di fornire le informazioni per l'uso della macchina in formato digitale 

Non aggiungo altri elementi, un testo così innovativo va analizzato con molta calma ed attenzione.

Voglio solo sottolineare la mia soddisfazione per essere stato testimone dei primi vagiti del nuovo Regolamento, avendo lavorato con i miei colleghi nell'Advisory Board for Legislation & Standard della tekom Europe, a partire dal 2017, per dare un contributo legato agli interessi di tutti i professionisti della Comunicazione Tecnica.

Il nostro primario obiettivo era quello di ottenere un'esplicita indicazione in merito alla possibilità di produrre le informazioni per l'uso in formato digitale.

Ovviamente non solo la tekom Europe ha spinto in questa direzione, ma mi sembra che il risultato ottenuto sia in linea con gli obiettivi di partenza.

Prossimamente, ci sarà: 

• La cerimonia della firma a Giugno.
• L'adozione formale e l'entrata in vigore della legislazione avverranno a Luglio. 

Da quel momento le aziende avranno 42 mesi di tempo per allinearsi alle nuove disposizioni, che entreranno DEFINITIVAMENTE IN VIGORE da Gennaio 2027.

Leggi questo articolo...

I contenuti strutturati non possono risolvere ogni problema... qualcosa dovete farlo anche voi!

Mi sono imbattuto in un bel post di  Joe Pairman che condensa con grande efficacia i migliori 5 motivi che giustificano la produzione di contenuti strutturati.

Sono totalmente allineato con Joe.

Tuttavia, come dico sempre, non bisogna legarsi ciecamente a teorie, standard e tecnologie come se fossero, di per se stesse, la soluzione dei nostri problemi.

Si può adottare una splendida metodologia, usando il miglior CMS presente sul mercato, modularizzando efficacemente tutti i contenuti ma tutto questo potrebbe non impedirvi di scrivere della pessima documentazione tecnica.

Un esempio?

Immaginate un'avvertenza di sicurezza imprecisa, che non utilizza i pittogrammi e i cromatismi previsti per questo tipo di informazioni e non risulta conforme agli standard di sicurezza e alle normative del settore d'applicazione.

Magari l'avete definita e racchiusa in un topic.

Magari l'avete taggata, cioè contraddistinta con un meta-dato finalizzato a filtrare/selezionare quel topic per inserirlo in un certo documento.

Magari state realizzando i vostri topic attraverso una metodologia standardizzata (ad esempio, DITA).

Magari questi topic sono governati attraverso un CMS XML-based, in cui sono disponibili tutte le funzionalità più desiderabili che possiate immaginare.

E magari attraverso questo CMS potete produrre diversi tipi di output (PDF, ePUB, HTML...)

MA TUTTO QUESTO... non cambia la natura profonda delle cose...
perchè la vostra avvertenza di sicurezza rimane, fondamentalmente, IMPRECISA e NON CONFORME alle normative.

In parole povere... E' SCRITTA MALE... e nessun CMS e nemmeno DITA vi salveranno dal fatto che state scrivendo una pessima avvertenza di sicurezza!

Ma questo significa anche che "il fattore umano" è sempre il più importante... e questo è comunque molto consolante!

:-)


Leggi questo articolo...

Microsoft Manual of Style for Technical Publication

Amplifico una segnalazione di Vilma Zamboli, che era intervenuta con un commento nel post relativo alla Apple Style Guide.

E' disponibile la quarta edizione del Microsoft Manual of Style for Technical Publication.

In rete è liberamente scaricabile la terza edizione.

Vilma, grazie per la "dritta"! Leggi questo articolo...

La nuova Apple Style Guide 2013: da non perdere

Vi segnalo la disponibilità della nuova guida di stile della Apple.

La potete scaricare liberamente in formato PDF.

Vi ho già parlato del ruolo e dell'importanza delle Guide di Stile. Sulla destra trovate una sezione specifica dedicata a questo argomento. A presto.


Leggi questo articolo...

Guide di Stile: U.S. Government Printing Office Style Manual

E' stata appena pubblicata la guida di stile ufficiale per la redazione dei documenti ufficiali del U.S.A. Government.

L'ho appena sfogliata e ve la propongo senza alcun commento, come esempio e riferimento che potrebbe essere utile da tener presente.

Unico neo, che per altro mi capita spesso di notare in molti PDF che girano in rete, anche di provenieneza "very cool", la mancanza di un indice navigabile.

Se facessi una cosa del genere per un cliente della mia azienda, verrei sommerso di osservazioni negative!

Buona consultazione. Leggi questo articolo...

Il Portale linguistico Microsoft

Per chi, come me, scrive documentazione tecnica direttamente in lingua Inglese, è sempre necessario avere delle risorse "di controllo" per valutare l'efficacia delle soluzione linguistiche adottate.

Questo aspetto è particolarmente critico se avete una formazione specialistica tecnica e non linguistica, perchè in tal caso è facile cadere nei trabocchetti più inaspettati.

Uno dei riferimenti più interessanti, che sto sperimentando da almeno un paio di mesi, è il Portale linguistico Microsoft.

Disponibile in modalità multilingua, fornisce due aree fondamentali.

GUIDE DI STILE
Contengono le indicazioni e le convenzioni linguistiche/stilistiche utilizzate per la localizzazione del software e della relativa documentazione.

RACCOLTA TERMINOLOGICA

Utilizzabile per sviluppare versioni localizzate di applicazioni che si integrano con i prodotti Microsoft o come glossario IT di base per lo sviluppo di applicazioni in una delle numerose lingue disponibili.

Esiste poi anche un comodo motore di ricerca che vi permette di rintracciare la traduzione di un termine, in relazione ai suoi diversi usi nelle interfacce Microsoft.

Nella figura seguente, ecco un esempio relativo al termine Button, per il quale sono state rilevate 73 diverse occorrenze:



Dateci un'occhiata, può rivelarsi molto utile.


Leggi questo articolo...

Dalla NASA una Guida di Stile... spaziale!

Quando ho iniziato questo lavoro, mi muovevo con cautela... più o meno come l'astronauta della fotografia!

Una delle prime cose che ho fatto è stata quello di procurarmi in rete delle Style Guide che ho saccheggiato selvaggiamente, cercando di imparare quanto più possibile, nel più breve tempo possibile.

Una Guida di Stile (o Manuale di Redazione) è un oggetto prezioso, in cui sono espresse le "buone pratiche" per scrivere efficacemente un documento, generalmente in ambito tecnico/scientifico.

E' un compendio di regole grammaticali e tecniche di scrittura ed editoriali, il tutto finalizzato a produrre documenti ben organizzati e stilisticamente omogenei. E presentano un vantaggio fondamentale: in poche pagine sono distillate idee e soluzioni "di buon senso" alle quali probabilmente giungereste anche da soli, ma impiegando magari molto più tempo.

Ovviamente, non esiste in assoluto "LA" Guida di Stile, cioè una Guida che oggettivamente può essere considerata "la migliore" tra tutte; ognuna può avere il suo quid di specificità, da ognuna si può imparare qualcosa di nuovo, anche se in molte Guide troverete alcuni contenuti assolutamente sovrapponibili.

Inoltre questi oggetti evolvono nel tempo: una guida scritta negli anni '60 del secolo scorso oggi sarebbe probabilmente inutilizzabile (ad eccezione delle regole grammaticali fondamentali).

Ed ecco una guida che arriva direttamente dal Centro Ricerche della NASA di Langley (la foto aveva un suo senso...).

Mi è stata segnalata recentemente via Linkedin da Angel Candelario, che ringrazio.

Nell'industria areonautica/aerospaziale la documentazione tecnica ricopre, tradizionalmente, un ruolo molto rilevante, per motivi facilmente intuibili. Questa Guida è un buon esempio in tal senso.

Con questo post inauguro una nuova sezione del blog, in cui vi segnalerò periodicamente le Guide di cui vengo a conoscenza e che ho utilizzato in passato. Leggi questo articolo...