Documentazione wiki: come imparare a partecipare in 15 minuti e 30 secondi netti

Tante 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 quando si ha tempo. 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!

Quando si parla di leggere, ci può anche stare, ma quando si deve scrivere...

In realtà 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 ha trovato imprecise 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

Correggere e revisionare le guide wiki è cosa buona e giusta, ma come si fa?
L'inizio è fondamentale: si imparano tantissime cose nuove e si impara a collaborare. Magari si è un po' legnosi nel premere i tasti del PC, ma questa dopotutto è solo questione di abitudine.

Dunque un primo consiglio: non partecipare 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 (neppure tanto forsennata in effetti) 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.

Oppure per prendere dimestichezza con il wiki, si può fare un bel resoconto dell'installazione di Ubuntu sul proprio portatile.
La stampante e lo scanner hanno fatto i capricci ma alla fine si è riusciti ad installarle? Perchè non scriverlo nella sezione dedicata!

Una volta che si è scelto cosa fare, iniziano le danze!

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. Pagine di prova e pagine nuove: 1 minuto

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

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

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

Crea la tua pagina personale in cui scrivere di te, cosa vuoi fare o quali sono i tuoi hobby. Potrai usare questa pagina anche come pagina di riferimento da cui creare tutte le tue pagine di prova!

5. 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 accanto alla tua pagina personale, quindi incolla tutto nella nuova pagina di prova.

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

6. Creare le guide di proprio pugno

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 e il wifi finalmente funziona che è un piacere?
Innanzitutto bravo! In secondo luogo, controlla che sia già scritto nel wiki!

Dopotutto se si sa già cosa scrivere è tutto più semplice e può tornare utile a tantissime persone: scripta manent signore e signori.
Dunque come creare una nuova guida?

Copia una pagina già esistente da utilizzare come modello oppure copia la pagina DocumentazioneModello, seguendo la stessa procedura indicata al paragrafo 5.
Crea una pagina nuova dandole il nome che preferisci, quindi incolla tutto nella nuova pagina appena creata.

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

La famigerata CategoryDaRevisionare

Corpo del testo

A cura del Gruppo Doc
Volete contribuire al Wiki? Siete i benvenuti!

CategoryComunitaDocumentazione