[11/04/2005] Report dello stato del Manuale di FreeBSD(akaHandbook)

[Marco Trentini]

On Tue, Apr 19, 2005 at 07:56:47AM +0000, Valerio Daelli wrote:
> Ok, parto con la revisione.
> Inizierei dal 3, Basi di Unix.

Ottima scelta :)

> I sorgenti li prendo dal CVS che mi hai indicato?

Per quanto riguarda la traduzione i sorgenti a cui devi fare
riferimento sono quelli che trovi nel repositry di civetta
(aka gufi), mentre i sorgenti dei documenti originali li trovi
ovviamente nel repository di freebsd.

> La revisione ? pi? un esame 'linguistico' o un esame
> 'sintattico' sui tag etc.?
> O tutte e due?

A seconda della qualita' della traduzione la revisione della
stessa dovrebbe richiedere una o due passate. 

Con il documento originale alla mano (la versione piu'
recente) devi verificare la traduzione, tag e regole di
traduzione
(http://utenti.gufi.org/ricerca.php3?mode=show&id=gufi:traduzioni:302).
In teoria e' come se dovessi ritradurre il documento con il
vantaggio che hai gia' una traduzione e cio' velocizza il
controllo. L'ideale e' avere lo schermo diviso in due parti,
sopra il documento originale e sotto la traduzione (molti
editor lo permettono). Con una buona traduzione sara'
sufficiente una singola passata, altrimenti sara' necessaria
una passate ulteriore. Nel caso di piu' passate, nella prima
sistemerai bene tag ed identazioni e farai una traduzione
veloce per poi migliorarla nella seconda passata. Ecco perche'
e' importante tradurre bene il documento seguendo le regole di
traduzione. Una volta finita questa prima fase di controllo
dovresti fare il build del documento in modo tale da avere un
formato di piu' facile lettura rispetto al sorgente sgml.
Ottenuto il documento nel formato voluto (consiglio html) non
ti resta che effettuare una o piu' letture attente del
documento, sistemando nel sorgente sgml eventuali
errori/anomalie.

Buona revisione allora :)

-- 
Marco Trentini                mark a remotelab.org
http://www.remotelab.org/