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 gestisce i 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 la documentazione:
- Sai fare una cosa che può tornare utile ad altri?
- Trovi alcune informazioni del wiki poco chiare?
- Hai visto che manca una parte fondamentale per completare un procedimento?
- Vuoi pubblicare un resoconto?
- Quella procedura scritta nel wiki è cambiata e tu puoi correggerla?
Allora non aspettare e scrivilo tu stesso: quando si sa già cosa scrivere è tutto più semplice e immediato. Manca solo un'informazione: da dove si comincia?
Imparare a scrivere nel wiki
Un primo consiglio: partecipa quando sai già cosa fare!
Come? Prima di iniziare si dovrebbe già sapere cosa fare?
Ebbene si, e non c'è da stupirsi affatto: si inizia con lo sfogliare la documentazione wiki alla ricerca delle guide da correggere, 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 stampante e scanner.
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, se avete scelto cosa fare 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. Prepararsi a correggere le guide (2 minuti e 15 secondi)
Se hai trovato una o più guide imprecise, errate o che vanno totalmente riscritte e tu sai come fare, allora 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.
5b. Prepararsi a creare nuovi documenti (2 minuti 15 secondi)
Se invece hai deciso di scrivere una nuova guida che ancora non è presente nel wiki e hai già ottenuto l'ok da parte del gruppo doc, allora 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.
Stop al tempo!
Ora che hai imparato tutte queste cose non ti rimane che completare in santa pace le tue correzioni o le tue guide. Puoi scrivere, cancellare e modificare tutto quello che ti pare nella tua pagina di prova o nel tuo nuovo documento, facile no?
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, che sono 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
