Progetto:Aiuto/Schema di una pagina di aiuto
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.
| Aiuto:Amministratori inizia con: "Un amministratore è un utente con compiti specifici che gode della fiducia della comunità." |
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.
| La categoria Pagine di aiuto con immagini contiene degli esempi di pagine di questo tipo. |
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ù.
| Aiuto:Autore, dopo gli esempi con immagini, presenta la sezione: Come creare la pagina di un autore Per creare una nuova pagina autore o per modificare una esistente è disponibile la guida Aiuto:Come creare una pagina autore. |
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}}.
| Aiuto:Come modificare una pagina termina con la sezione: Domande? Se hai domande, dubbi, proposte o necessiti di chiarimenti su come modificare una pagina premi qui e lascia un messaggio nella pagina di discussione. |