Linee guida per i contenuti
Da Wiki di NetBSD Italia.
(Differenze fra le revisioni)
(→Regole generali) |
(→Regole generali) |
||
Riga 6: | Riga 6: | ||
# 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 | # 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 [[TODO#Template|riferimenti]] mettendo le spiegazioni (anche piuttosto dettagliate) a fondo pagina. | # Note come '''FIXME''', '''TODO''' o '''Xxx''' sono da evitare. Utilizzare piuttosto dei [[TODO#Template|riferimenti]] mettendo le spiegazioni (anche piuttosto dettagliate) a fondo pagina. | ||
- | # Evitare considerazioni personali, commenti e quant'altro non sia strettamente correlato all'articolo | + | # 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. | #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. | ||
# [ .. ] | # [ .. ] |
Versione delle 13:58, 3 set 2007
(a.k.a. linee guida)
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.
- [ .. ]
Formattazione
I documenti devono essere formattati secondo criteri ben precisi, rappresentati dalle seguenti categorie:
WiP