Avanti
Indietro
Indice
Prima inviare una e-mail al coordinatore degli HOWTO al
mailto:linux-howto@metalab.unc.edu o
mailto:feedback@linuxdoc.org. Se si desidera rilevare un HOWTO
non più mantenuto contattare il vecchio autore. Questo potrebbe
essere richiesto dalla licenza di copyright, ma si dovrebbe comunque fare
per cortesia, anche quando non è richiesto.
Queste sono le linee guida, dovute per la maggior parte a
Tim Bynum (un vecchio coordinatore di HOWTO).
- Assicurarsi di usare un formato accettato (come il LinuxDoc :-).
- Tentare di usare una struttura e un'organizzazione significativa,
e scrivere chiaramente. Ricordare che molte delle persone che
leggono gli HOWTO non parlano l'inglese come loro prima lingua.
- Assicurarsi che tutte le informazioni siano corrette.
Non insisterò mai abbastanza su questo. Nel dubbio,
fare delle congetture, ma si faccia chiarezza sul fatto che si sta
solamente ipotizzando. Io uso ?? se non sono sicuro.
- Assicurarsi di trattare la più recente versione del
software disponibile.
- Considerare di includere una sezione di "FAQ". Potrebbero
essere chiamate anche "Problemi Comuni" o "Trouble Shooting".
- Assicurarsi di mettere nel copyright il proprio nome e includere
una licenza che soddisfi i requisiti dichiarati nel manifesto di LDP.
- Usare l'intestazione standard con il titolo, l'autore, la data
(includendo un numero di versione). Vedere
Terzo Esempio
- Per finire prepararsi a ricevere e-mail di domande e commenti dai
lettori. Sta alla propria decisione quanto aiutare la gente ma si
dovrebbero usare i buoni suggerimenti e le segnalazioni di errori.
Si potrebbero anche ricevere delle email di "grazie", così
come mail da persone che chiedono aiuto e che non hanno mai nemmeno
guardato al proprio HOWTO.
Dopo aver scritto l'HOWTO, inviare via email il sorgente SGML
all'indirizzo: submit@linuxdoc.org. Poi tutto ciò che è
necessario fare è tenere aggiornato l'HOWTO sottoponendo
periodicamente gli aggiornamenti allo stesso indirizzo di e-mail usato
per la prima edizione del proprio HOWTO.
Avanti
Indietro
Indice