Progetto:Aiuto/Schema di una pagina di aiuto

La struttura di una pagina aiuto

Categoria: Progetto aiutoPortale progetti   Progetto aiuto   Struttura di una pagina 


Quale namespace usare? "Aiuto" o "Wikisource"?

modifica

È importante da subito evidenziare la differenza tra i due namespace che hanno funzione di servizio e che spesso vengono confusi.

Aiuto
È paragonabile al manuale delle istruzioni. In questo namespace devono trovarsi le guide all'utilizzo di Wikisource.
Wikisource
È il namespace che deve contenere il perchè, la filosofia, le linee guida, i concetti e l'organizzazione di Wikisource.

Questo progetto si occupa del primo namespace, ovvero delle guide per gli utenti.

La pagina di aiuto ideale

modifica

La pagina di aiuto ideale dovrebbe essere:

Di semplice comprensione
Scritta con una terminologia adatta alla tipologia di utenti a cui è rivolta
Arricchita da esempi ed immagini
Utile
La finalità è assistere l'utente su un argomento determinato e circoscritto
Breve
Spiegare non è divagare
Se l'argomento è complesso, meglio suddividerlo in più pagine

La struttura base

modifica

Ogni pagina di aiuto dovrà contenere:

  • L'incipit con la descrizione dell'argomento trattato
  • Le sezioni con le spiegazioni
  • La sezione finale con il collegamento alla pagina di discussione

L'incipit

modifica

Nel creare una pagina di aiuto è importante tenere a mente la tipologia di utenti a cui ci si rivolge. Tutte le pagine di aiuto possono essere lette da utenti inesperti che non conoscono in profondità il linguaggio wiki o il progetto. Per questo motivo è bene che l'incipit delle guide sia sempre rivolto all'utente inesperto.

Nelle prime righe va spiegato con semplicità l'argomento trattato con una descrizione essenziale ed immediata.

L'argomento viene evidenziato in grassetto ed è importante inserire i collegamenti ad altre pagine di aiuto per spiegare meglio la definizione che viene data.

Le sezioni con le spiegazioni

modifica

Seguono quindi le spiegazioni.

Se l'argomento è descrittivo, su una funzione o una caratteristica particolare di Wikisource, o spiega una procedura operativa ed è rivolto all'utente inesperto è importante inserire delle immagini (screenshot) così da mostrare praticamente ciò che viene spiegato. Ricorrere ad esempi è un ottimo aiuto.

Per non confondere l'utente inesperto con mille informazioni è importante non divagare rimandando la trattazione delle procedure operative ad altre pagine di aiuto. In questo modo, chi vuole solamente conoscere le caratteristiche di una funzione di Wikisource trova subito quanto gli serve ed, al contempo, ha a disposizione una guida più approfondita se vuole saperne di più.

La sezione finale

modifica

Ogni pagina di aiuto deve contenere in calce la sezione Domande? così da incentivare l'utente che ha dei dubbi ad utilizzare la pagina di discussione nella quale verrà inserito il template {{Pagina discussione}}.