Linee guida per i contenuti
Da Wiki di NetBSD Italia.
(Differenze fra le revisioni)
(→Scelta del titolo) |
|||
| Riga 1: | Riga 1: | ||
| - | (a.k.a. '''linee guida''') | + | (a.k.a. '''linee guida''' per i contenuti) |
L'intento di questa pagina è quello di stabilire dei criteri per l'organizzazione dei documenti all'interno del Wiki cercando di collocarli nelle ''giuste'' categorie e, qualora fosse necessario, creandone di nuove secondo i criteri qui descritti. | L'intento di questa pagina è quello di stabilire dei criteri per l'organizzazione dei documenti all'interno del Wiki cercando di collocarli nelle ''giuste'' categorie e, qualora fosse necessario, creandone di nuove secondo i criteri qui descritti. | ||
Versione delle 21:29, 4 set 2007
(a.k.a. linee guida per i contenuti)
L'intento di questa pagina è quello di stabilire dei criteri per l'organizzazione dei documenti all'interno del Wiki cercando di collocarli nelle giuste categorie e, qualora fosse necessario, creandone di nuove secondo i criteri qui descritti.
Regole generali
- Le pagine non devono essere firmate: il nome di chi ha creato l'articolo i di chi ha, eventualmente, contribuito non và incluso a meno che non sia pertinente all'argomento
- Note come FIXME, TODO o Xxx sono da evitare. Utilizzare piuttosto dei riferimenti mettendo le spiegazioni (anche piuttosto dettagliate) a fondo pagina.
- Evitare considerazioni personali, commenti e quant'altro non sia strettamente correlato all'articolo o di rilevante importanza per la comprensione dello stesso.
- Qualora la dimensione del testo richiesto per la creazione di un articolo sia inferiore a una pagina completa, è opportuno optare per l'inclusione di una nuova FAQ piuttosto che di un nuovo articolo.
Scelta del titolo
- Le pagine relative a una determinata operazione (installazione, configurazione, etc.) dovrebbero avere un titolo chiaro che riassuma esattamente l'argomento trattao, ad esempio: Installazione di Samba, Installazione di Xorg modulare, etc.
- Gli articoli che documentano un software partendo dalla sua installazione e concludendo con la verifica della corretta configurazione , elencando eventualmente alcune soluzione per la risoluzione di problemi comuni, dovrebbero avere un titolo che inizi col testo Messa appunto di/del seguito dal nome del software in questione. Nel caso in cui vengano trattati altri software in un unico articolo utilizzare un + come separatore, ad esempio: [[Messa a punto di Lighttpd + PHP + MySQL]].
- Il titolo di un articolo avente un tono conversativo non troppo formale può essere arbitrario, purchè sia quanto più descrittivo possibile. Un esempio ben scritto di questo genere di articoli (da utilizzare come unità di riferimento) è Primi passi con NetBSD.
Formattazione
I documenti devono essere formattati secondo criteri ben precisi, rappresentati dalle seguenti regole:
WiP
