Progetto:Aiuto/Schema di una pagina di aiuto

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

È 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

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

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

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

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

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}}.