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!

Imparare a scrivere nel wiki

Un primo consiglio: partecipa quando sai 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 vuoi creare una nuova guida, è importante informare prima il gruppo doc sul Forum, per evitare di creare doppioni o pagine troppo generiche. Bene, possiamo iniziare, diamo il via al tempo!

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

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

Ecco infine la pagina più temuta della documentazione wiki: la CategoryDaRevisionare
In questa pagina sono raccolte tutte quelle guide che hanno bisogno di una revisione, riferite a vecchie versioni di Ubuntu o che contengono procedure oramai datate. Sentitevi liberi di esplorarla, studiarla e trovare tutte quelle guide che potreste rimettere a lucido.

Abbiamo bisogno dell'aiuto di tutti voi per correggerle. Non abbiate timore e provate, scrivete, correggete e cancellate. Il tempo sarà l'unica cosa che non vi mancherà, perchè potrete sempre interrompere e riprendere la scrittura quando ne avrete voglia.

Che ve ne pare, avete 14 minuti per aiutarci?

A cura del Gruppo Doc

CategoryComunitaDocumentazione