Aiuto:Fasi di sviluppo

- Sportello informazioni

La fase di sviluppo indica il progresso di un libro o di un modulo, valutato ad una certa data.

Questo può aiutare a focalizzare l'attenzione del lettore su dei contenuti chiari e completi, e quella dell'autore verso pagine che richiedono ancora aiuto. Inoltre risulta emotivamente deludente cliccare su un link blu e vedere che è praticamente vuoto, mentre con una indicazione prima la delusione è minore.

Fasi di sviluppo

L'icona della fase di sviluppo segue il titolo del libro (può essere utilizzato anche all'interno di un libro per indicare il grado di sviluppo dei singoli capitoli) e indica il livello di completezza di quel libro in accordo con la seguente scala:

Fasi di sviluppo
Stub:	In via di sviluppo:	Completo a metà:	Quasi completo:	Completo:

La data che compare scritta in piccolo subito dopo indica il momento in cui la fase di sviluppo è stata valutata per l'ultima volta da un utente di Wikibooks. Per esempio

• JavaScript (sommario)JavaScript

questo significa che il libro è stato valutato come completo al 100% in data 1 luglio 2008.

Come indicare la fase di sviluppo

Anche tu puoi contribuire ad assegnare una fase di sviluppo ai libri che visiti: non è necessario essere gli autori del libro, l'importante è conoscere l'argomento e la struttura del libro quanto basta per capire se il modulo sia completo o meno. È facile, e di grande aiuto per i nuovi lettori, che così potranno trovare facilmente e in modo rapido i libri più completi di loro interesse.

Per dare informazioni sullo stato di completamento del libro e dei moduli e inserirlo automaticamente nella categoria relativa al suo stadio di sviluppo, è stato elaborato il template {{avanzamento}} che va posto in fondo alla pagina dopo le categorie e gli interwiki in questo modo:

{{avanzamento|xx%|data}}

Una volta inserito il template {{avanzamento}} nella pagina questo sarà automaticamente utilizzato per la generazione dei link (usando i template {{modulo}} e {{libro}}) e per la compilazione dei bollettini.

Valutare l'avanzamento di un modulo

Per valutare lo stato di avanzamento di un modulo, se non sei tu l'autore il libro, valuta in base ai contenuti che ti aspetteresti di trovare. Se sei tu l'autore del modulo, e sai quindi quanto dovrà essere lunga la pagina, inserisci l'avanzamento come più ritieni giusto.

Se hai suggerimenti per lo sviluppo del modulo, se non sei in grado di correggerli o non te la senti, scrivili sulla sua pagina di discussione.

Valutare l'avanzamento di un libro

Per valutare correttamente lo stato di avanzamento di un libro devi innanzitutto dare un'occhiata a tutti i capitoli. Per questo motivo è consigliato, soprattutto per i libri più completi, inserire delle fasi di sviluppo per ogni capitolo.

Usa invece lo schema che segue per classificare i libri:

Pulsante	Fase di sviluppo	Codice	Descrizione
	00%	{{avanzamento|00%}}	Quando il libro ha solo la pagina principale e l'introduzione o pochi capitoli a loro volta stub. Per ulteriori informazioni vedi Aiuto:Stub
	25%	{{avanzamento|25%}}	Quando il libro è stato suddiviso in capitoli e alcuni di questi hanno del contenuto
	50%	{{avanzamento|50%}}	Quando almeno metà dei capitoli hanno informazioni complete
	75%	{{avanzamento|75%}}	Quando tutti o la maggior parte capitoli hanno informazioni complete
	100%	{{avanzamento|100%}}	Quando il libro è stato riletto (errori di ortografia, inezie del layout ecc..)

Questo processo di revisione ruba del tempo, ma aumenta la qualità di Wikibooks. Perciò è suggerito controllare solo uno o pochi libri alla volta, indicando inoltre utili e intelligenti suggerimenti per lo sviluppo del libro. Per favore, controlla solo libri che non siano stati ricontrollati da un po' di tempo (qualche settimana, qualche mese) o che mostrano un livello di sviluppo basso.

Pulsanti di inserimento

Per approfondire, vedi Aiuto:Barra degli strumenti di modifica.

Per facilitare l'inserimento del template sono stati sviluppati dei pulsanti per la barra di modifica. Cliccando su ciascun pulsante si cambia l'avanzamento della pagina al livello desiderato.

Come faccio a sapere lo stato della pagina quando ci sono dentro?

Come facciamo a sapere lo stato di una pagina quando ci troviamo dentro, per verificare che sia aggiornata? Semplice: basta guardare in alto a sinistra nella linguetta modulo (o libro) e vedremo un'immagine che indica la fase di sviluppo. Questo è possibile grazie ad uno script JavaScript (che si trova qui, funzione onglets() ) che sfrutta il template {{Avanzamento}} contenuto nella pagina.

Collegamenti a libri e a moduli

Una volta che è una pagina è stata classificata, è fortemente consigliato indicare la sua fase di sviluppo accanto ai collegamenti che puntano alla pagina, in modo tale da permettere al lettore di sapere se i contenuti della pagina che sta per aprire sono completi oppure carenti e per il contributore per individuare le pagine su cui intervenire.

Questo è reso molto facile dalle presenza dei template {{libro}} e {{modulo}} che, quando sono inseriti, attivano un particolare script che recupera l'avanzamento dalle pagine interessate e lo inserisce dove è necessario.

Questi template vanno usati

• nelle sezione Libri correlati per linkare i libri di argomento affine ({{libro}})
• negli indici di navigazione del libri e nei sommari per linkare i vari capitoli ({{modulo}})

Quando va usato il template {{stage}}?

Il vecchio template {{stage}}, accanto ai link dei moduli e dei libri, è stato ormai rimpiazzato dai template {{libro}} e {{modulo}}.

Il suo uso risulta però necessario quando bisogna assegnare un avanzamento a qualcosa che non può essere reso un collegamento perché non è il link ad un libro o ad un capitolo. Ad esempio va usato se si vuole indicare in un sommario l'avanzamento di una sezione a cui non corrisponde una pagina specifica: in quel caso si può inserire il template stage accanto nel titolo della sezione; oppure se si vuole indicare l'avanzamento dei singoli paragrafi della pagina, come è fatto ad esempio qui.

Vecchi template

Le vecchie fasi di sviluppo erano semplici immagini senza alcun riferimento alla data in cui il libro era stato controllato. Sono elencate a scopo informativo (se le trovi, sostituiscile con i nuovi template):

• Una volta erano usati i template {{stage}} accanto ai link. Oggi sono stati rimpiazzati dai template {{libro}} e {{modulo}}.
• Vecchia versione: immagine semplice: [[Image:25%.svg]], [[Image:50%.svg]], ...
• Ancora più vecchia: Codice di colore: [[image:yellow.png]], [[image:red.png]], ...

Vedi anche

• Template:Incompleta
• Template:In espansione
• Aiuto:Libro abbandonato