Documentazione wiki: come partecipare in 14 minuti netti

Numerose e coinvolgenti sono le attività che la comunità italiana di Ubuntu mette a disposizione per tutti coloro che vogliono collaborare.
Chi traduce, chi sviluppa, chi si occupa dei vari portali, chi si dedica al supporto, chi alla promozione e alle news... si potrebbe continuare a lungo! Sono tantissimi i gruppi di lavoro che hanno sempre bisogno di una mano, collaborare è facile ed immediato e ci si può dedicare nel tempo libero. Perchè aspettare?

Quasi dimenticavo: c'è anche chi si occupa della documentazione!

Sfatare i falsi miti: scrivere nel wiki è più facile a farsi che a dirsi!

Non c'è nulla di particolarmente complicato nello scrivere una pagina di documentazione:

- Sai fare una cosa che può tornare utile ad altri?
- La nonna usa Ubuntu ma non ha capito alcune informazioni del wiki?
- Hai visto che manca una parte fondamentale per completare un procedimento?
- Vuoi pubblicare un resoconto?
- Quella cosa scritta nel wiki non si fa più nello stesso modo e tu potresti correggerla?

Che aspetti dunque: quando si sa già cosa scrivere è tutto più semplice e immediato. Che poi non è vero che la formattazione delle pagine sia una cosa complicata... anche perchè a quella ci pensa il gruppo doc
Manca solo un'informazione: da dove si comincia?

Imparare a scrivere nel wiki

Un primo consiglio: non partecipare solo per puro gusto di partecipare, ma partecipare perchè si sa già cosa fare!

Come? Prima di iniziare uno dovrebbe già sapere cosa fare?
Ebbene si, e non c'è da stupirsi affatto per questa affermazione: si inizia con lo sfogliare la documentazione wiki alla ricerca delle cose che vanno sistemate, di quelle che mancano, di quell'errore che si era notato tanto tempo fa e che non è mai stato corretto.
Si può pubblicare il resoconto dell'installazione di Ubuntu nel proprio portatile, oppure scrivere come si è riusciti ad installare la stampante e lo scanner nella sezione dedicata.

Una volta che si è scelto cosa fare, iniziano le danze!
Giusto una questione: se si vuole creare una nuova guida, è importante informare prima il gruppo doc sul Forum, per evitare di creare doppioni o pagine troppo generiche.

1. Iscriversi al wiki: 2 minuti e 15 secondi

Seguire quanto scritto nella pagina IscriversiAlWiki.
Se già si possiede un account Launchpad, sarà sufficiente eseguire il login al wiki, premendo Accedi in alto a destra (e risparmiando oltre due minuti di tempo).

2. Imparare i fondamentali: 5 minuti e 30 secondi

Scrivere in grassetto e in corsivo, inserire i capitoli, gli elenchi puntati e numerati e inserire i collegamenti. Tutto quello che di fondamentale c'è da sapere in una semplice guida da 10 passi + 1.

3. Creare la propria pagina personale: 3-8 minuti

Creare la propria pagina personale in cui scrivere di sè, cosa si intende fare o quali sono i propri hobby. Potrai sempre usarla come pagina di riferimento da cui creare tutte le tue pagine di prova!

4. Pagine di prova e nuovi documenti: 1 minuto

Quali sono le differenze tra i due? Quando usare l'una e quando l'altro? Basta leggere la guida CreazioneNuovePagine.

5a. Correggere le guide: 2 minuti e 15 secondi

Hai trovato una o più guide imprecise, errate o che vanno totalmente riscritte... e tu sai come fare? Procedi in questo modo:

Vai alla pagina incriminata e cerca il menù a tendina Altre azioni, posto nella barra superiore chiara del wiki.
Seleziona la voce Mostra il testo grezzo.
Copia tutto quanto.
Crea una pagina di prova, quindi incolla tutto al suo interno.

Ora puoi scrivere, cancellare e modificare tutto quello che ti pare nella tua pagina di prova, facile no?

5b. Creare le guide di proprio pugno: 2 minuti 15 secondi

Sei riuscito ad installare un programma che ha richiesto un po' di manodopera? Sei riuscito a far partire correttamente quella dannatissima scheda grafica? Hai aggiustato la risoluzione dello schermo? Innanzitutto bravo! In secondo luogo, controlla che il procedimento sia già scritto nel wiki! Se non esiste, procedi come segue:

Copia una pagina già esistente da utilizzare come modello oppure copia la pagina DocumentazioneModello, seguendo la stessa procedura indicata al paragrafo 5a.
Crea un nuovo documento, quindi incolla tutto al suo interno.

Ora puoi scrivere, cancellare e modificare tutto quello che ti pare nella nuova pagina.

7. A lavoro terminato

Una volta completato il lavoro, informa il gruppo doc scrivendoci sul Forum. Ci occuperemo della revisione e pubblicazione del tuo lavoro.

La famigerata CategoryDaRevisionare

Corpo del testo

A cura del Gruppo Doc

CategoryComunitaDocumentazione