Aiuto:Fasi di sviluppo: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
Savh (discussione | contributi)
m Annullate le modifiche di 151.51.111.131 (discussione), riportata alla versione precedente di LoStrangolatore
Riga 11: Riga 11:
* {{libro|JavaScript}}
* {{libro|JavaScript}}
:questo significa che il libro è stato valutato come completo al 100% in data 1 luglio 2008.
: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 [[Aiuto:template|template]] '''{{tl|avanzamento}}''' che va posto in fondo alla pagina dopo le categorie e gli interwiki in questo modo:

<nowiki>{{avanzamento|xx%|data}}</nowiki>

Una volta inserito il tempate {{tl|avanzamento}} nella pagina questo sarà automaticamente utilizzato per la generazione dei link (usando i template {{tl|modulo}} e {{tl|libro}}) e per la compilazione dei [[Aiuto:bollettino|bollettini]].

=== Valutare l'avanzamento di un modulo ===
Per valutare lo '''stato di avanzamento di un [[aiuto:modulo|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 [[Aiuto:Pagina di discussione|discussione]].

=== Valutare l'avanzamento di un libro ===
Per valutare correttamente lo '''stato di avanzamento di un [[aiuto:libro|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''':
{| class="wikitable"
!Pulsante
!Fase di sviluppo
!Codice
!Descrizione
|-
| align="center" | [[Immagine:Button 00%.png]]
| align="center" | [[Immagine:00%.svg]] <code>00%</code>
|<code><nowiki>{{avanzamento|00%}}</nowiki></code>
|Quando il libro ha solo la pagina principale e l'introduzione o pochi capitoli a loro volta ''stub''. Per ulteriori informazioni vedi [[Aiuto:Stub]]
|-
| align="center" | [[Immagine:Button 25%.png]]
| align="center" | [[Immagine:25%.svg]] <code>25%</code>
|<code><nowiki>{{avanzamento|25%}}</nowiki></code>
|Quando il libro è stato suddiviso in capitoli e alcuni di questi hanno del contenuto
|-
| align="center" | [[Immagine:Button 50%.png]]
| align="center" |[[Immagine:50%.svg]] <code><nowiki>50%</nowiki></code>
|<code><nowiki>{{avanzamento|50%}}</nowiki></code>
|Quando almeno metà dei capitoli hanno informazioni complete
|-
| align="center" | [[Immagine:Button 75%.png]]
| align="center" |[[Immagine:75%.svg]] <code><nowiki>75%</nowiki></code>
|<code><nowiki>{{avanzamento|75%}}</nowiki></code>
|Quando tutti o la maggior parte capitoli hanno informazioni complete
|-
| align="center" | [[Immagine:Button 100%.png]]
| align="center" |[[Immagine:100%.svg]] <code><nowiki>100%</nowiki></code>
|<code><nowiki>{{avanzamento|100%}}</nowiki></code>
|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 ===
{{vedi anche|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 [[w:JavaScript|JavaScript]] (che si trova [[MediaWiki:Common.js|qui]], funzione <code>onglets()
</code>) che sfrutta il template {{tl|Avanzamento}} contenuto nella pagina.


== Collegamenti a libri e a moduli ==
== Collegamenti a libri e a moduli ==

Versione delle 12:28, 26 gen 2013


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

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

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:

Ad esempio, per il wikibook HTML metteremo il template {{libro|HTML}} all'interno del ripiano ripiano Tecnologia Informatica.

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]], ...