## Introduzione

Ciò che vi sta davanti, la guida in linea di Scribus, ebbe il suo inizio come un “tentativo ambizioso ma non troppo di creare qualcosa di diverso dal solito nel campo della documentazione tecnica.” Quando Peter Linnell, un esperto consulente nel settore della prestampa, che in seguito acquisì una certa fama nella comunità open source sotto il nome di mrdocs, si addentrò in un nuovo territorio con Linux, si imbattè in Scribus, che era ancora ai primordi all'epoca in cui Peter entrò a far parte del team. Va bene, cancellate “entrò a far parte”. Peter Linnell creò il team di Scribus, perché allora Franz Schmid, il fondatore del progetto, ci stava lavorando da solo. Peter Linnell non solo fece conoscere a Franz Schmid le necessità dell'industria della stampa, ma aiutò anche ad attrarre nuovi collaboratori.

Ecco come Peter racconta le origini della documentazione di Scribus:

> Il fatto che io stia scrivendo questo è un esempio perfetto del ruolo del caso nella vita. E forse merita anche di essere raccontato.

> Su consiglio di un amico che si occupava di informatica, cominciai ad armeggiare con RedHat Linux, in un tentativo, nei ritagli di tempo, di allargare il mio mondo oltre i comuni PC. Quando si esplora un nuovo mondo, spesso si cercano cose in comune con quello vecchio, magari solo per confrontarle. Così, dopo aver scoperto Gnome e KDE e dopo aver persino imparato a compilare programmi, pensai che dopotutto non era così difficile.

> Un salto su Google mi portò alla home page di Scribus 0.3.6, un programma di DTP somigliante a Quark che era proprio all'inizio dello sviluppo. OK, lo scarico, faccio la parte ./configure, e splat: errore di compilazione. Sparo subito una mail con quel garbuglio di messaggi tecnici che non avevo ancora capito, e sorprendentemente, appena 20 minuti dopo, ecco una garbata risposta che mi spiegava dove avevo sbagliato. Buon segno...

> Dopo uno scambio di mail nel corso di qualche settimana, Scribus aveva un autore di documentazione che capiva molto poco dello sviluppo di applicazioni, e non sapeva nemmeno scrivere il più semplice HTML. Ma conoscevo e amavo il desktop publishing, e intuivo che Scribus era e poteva essere qualcosa di veramente speciale.

> Nel mondo dell'open source, vi sono grandi programmi che mancano completamente di documentazione di qualunque tipo. Vi sono anche programmatori che sono un disastro quando si tratta di scrivere documentazione. (Franz [il fondatore del progetto], nonostante l'inglese non sia la sua lingua madre, è capace di spiegare le cose molto bene.)

Così, questo fu l'inizio della documentazione di Scribus. Ma con l'arrivo di nuovi collaboratori, e con lo sviluppo del progetto che divenne via via più ambizioso, divenne sempre più difficile per una sola persona mantenere la documentazione aggiornata. Come è naturale che accada con i progetti open source che hanno successo, altre persone si offrirono di ampliare le informazioni a disposizione degli utenti di Scribus. Quest'ampliamento iniziò con il Wiki di Scribus, un'opera a più mani in continuo sviluppo, scritta soprattutto da utenti per gli utenti, e culminò con la pubblicazione del manuale ufficiale di Scribus.

Ma il lavoro di documentazione non finì affatto con la pubblicazione di un libro. Un esame della documentazione com'era allora mostrò che molti documenti, anche se descrivevano in modo corretto le funzioni di Scribus al momento in cui erano stati scritti, avevano bisogno di essere aggiornati per riflettere il gran numero di nuove caratteristiche che erano state aggiunte nel frattempo, mentre alcuni espedienti per problemi legati a Linux non erano più necessari sui moderni desktop Linux.

Inoltre, la crescente complessità di Scribus era in conflitto con il concetto originario alla base della documentazione, che può essere descritto come un misto di diario e di relazione di lavoro sul campo, con in più alcuni elementi di un manuale per amministratori di sistema. Quest'approccio era senza dubbio necessario all'epoca in cui la documentazione originale fu scritta, poiché allora Scribus era prima di tutto un programma per Linux. Fortunatamente il desktop Linux è molto più facile da usare oggigiorno, e inoltre sono state sviluppate versioni di Scribus anche per altre piattaforme.

Di conseguenza, la documentazione di Scribus può ora adottare un approccio più strutturato, che fornisce molte più spiegazioni sull'utilizzo pratico del programma. Le preziose informazioni create da Peter Linnell nella documentazione originale naturalmente resteranno, anche se in forma diversa: saranno distribuite nei documenti in cui appaiono pertinenti. E naturalmente Peter Linnell è ancora mrdocs, e questa è un'ulteriore ragione per avere grandi aspettative se si tratta di altri miglioramenti alla documentazione di Scribus ...