Red Hat, una delle principali aziende nel campo del software open source, sta collaborando con l’Università Masaryk di Brno, in Repubblica Ceca, per formare la prossima generazione di scrittori tecnici. Questo partenariato ha preso il via attraverso un corso di scrittura tecnica, sviluppato in collaborazione con la Facoltà di Informatica dell’università, che ha come obiettivo quello di preparare gli studenti a eccellere nel campo della documentazione tecnica.
Un corso innovativo per scrittori tecnici
Durante l’Open Source Summit di Praga, Jiří Herrman, un membro senior del team di documentazione di Red Hat a Brno, ha presentato una conferenza dal titolo “Diagrams & Dragons: Teaching Technical Writing to University Students the Open Source Way”. Herrman ha sottolineato che mentre si insegna, gli insegnanti apprendono a loro volta dai propri studenti, un principio fondamentale in contesti educativi innovativi come questo.
Il corso, intitolato PV177 Technical Writing, è stato avviato dopo un ritardo causato dalla pandemia e rappresenta un’importante iniziativa per sviluppare competenze nella scrittura tecnica, che spesso richiede interazioni complesse con il pubblico.
Le difficoltà e le scoperte del corso
Secondo Herrman, l’implementazione del corso ha presentato diverse sfide. Sebbene fosse destinato a studenti con una certa preparazione tecnica, sono emerse difficoltà pratiche, come l’utilizzo di strumenti basati su shell, poiché alcuni studenti non avevano esperienza con la linea di comando. Altri sono arrivati con laptop senza accesso amministrativo o addirittura solo con smartphone.
Un’altra osservazione degna di nota è stata la difficoltà nel far valutare il lavoro tra pari; nonostante questa pratica fosse comune tra i professionisti della scrittura tecnica, si è rivelata poco efficace tra gli studenti. In risposta, gli educatori hanno dovuto insegnare agli studenti come fornire feedback costruttivo senza creare conflitti.
Il ruolo degli LLM nella scrittura tecnica
Un aspetto controverso del corso è stato l’uso di modelli di linguaggio di grandi dimensioni (LLM). Gli studenti, nonostante le indicazioni contrarie, hanno continuato a utilizzare queste tecnologie durante il corso. Herrman ha evidenziato come l’incoraggiamento a utilizzare LLM per lavori di alta qualità avesse portato a problemi di plagio, mentre la loro condanna ha spinto gli studenti a sentirsi demotivati. Di fronte a queste sfide, il team ha dovuto sviluppare strategie per gestire l’uso di LLM, trasformando gli studenti in utenti più consapevoli di queste tecnologie.
Strategie di apprendimento efficaci
Nonostante le difficoltà, ci sono stati anche elementi di successo nel corso. Herrman ha descritto come l’assegnazione di punti in modo semi-arbitrario e l’uso di meme per fornire feedback abbiano reso il processo di apprendimento più coinvolgente. Un’interessante attività finale ha visto gli studenti partecipare a un gioco di ruolo “Dungeons & Dragons”, affrontando la questione “Voglio diventare uno scrittore tecnico, come posso farlo?”, che prevedeva la navigazione in un team interdisciplinare e la creazione di documentazione reale.
I materiali del corso, rilasciati in open source, offrono agli studenti una prova concreta delle competenze acquisite, contribuendo così alla loro occupabilità futura.
Discussione sull’uso dell’AI nella scrittura tecnica
Durante una sessione dell’evento, Herrman ha moderato una discussione dal titolo “Technical Writing in the Age of AI”, chiedendo ai partecipanti quale fosse il loro utilizzo dell’intelligenza artificiale nella scrittura tecnica. La risposta è stata incoraggiante, con la maggior parte dei partecipanti che già utilizzava strumenti AI, pur segnalando le criticità legate alla capacità dell’AI di produrre documentazione di qualità.
Molti scrittori tecnici concordano sul fatto che, sebbene l’AI possa assistere in alcune funzioni, è tutt’altro che efficace nella scrittura di documenti tecnici. Infatti, gli autori hanno espresso preoccupazioni riguardo alla fiducia riposta nell’AI per funzioni come l’aggiornamento della documentazione, dove spesso questa tecnologia mostra limiti significativi.
La situazione attuale di scarsità di risorse nel settore della scrittura tecnica spinge i professionisti a cercare di trarre il massimo dai nuovi strumenti, sebbene resti il timore di un uso inappropriato dell’AI. La comunità di scrittori tecnici sembra perciò consapevole della necessità di mantenere un occhio critico sulle tecnologie emergenti, per garantire che non compromettano la qualità del lavoro svolto.
