FAQ

Le FAQ (frequently asked questions) sono risposte alle domande che più frequentemente vengono poste da chi si affaccia per la prima volta alla documentazione wiki.
Se vuoi sapere come funziona la documentazione della comunità italiana di Ubuntu e vuoi contribuire, in questa pagina potrai approfondire vari aspetti.

Cos'è il wiki di Ubuntu-it?

Il wiki è una piattaforma aperta di condivisione e collaborazione, utilizzata sia dai gruppi di lavoro di Ubuntu-it per coordinare i lavori, sia per la pubblicazione delle documentazione wiki riguardante il sistema operativo Ubuntu.

Cos'è la documentazione wiki?

La documentazione wiki è la documentazione scritta da chi utilizza il sistema operativo Ubuntu. Qualsiasi utente può partecipare alla stesura delle guide.
Sai cosa occorre per configurare un programma? Sai come installare determinati driver di una periferica hardware o altro ancora? Se vuoi condividere sul wiki le soluzioni che hai trovato, sei il benvenuto!

È necessario far parte del Gruppo Doc per editare il wiki?

Assolutamente no. Chiunque può correggere le guide wiki o crearne di nuove.
Il Gruppo Doc si preoccupa di fare in modo che la documentazione rimanga ordinata, curando sia l'impostazione dei documenti scritti dagli utenti, sia avendo cura che la pagina sia pubblicata nella sezione appropriata del sito.

Devo già saper editare alla perfezione pagine wiki per scrivere guide?

Assolutamente no. Non occorre essere scrittori, riportare i passaggi in modo schematico è più che sufficiente. Chi utilizza il wiki per la prima volta in questa pagina può vedere come trasformare le parole in titoli di paragrafi, in testo in grassetto, in link, ecc..
In realtà le guide seguono alcune impostazioni e se ti va di seguirle non può farci che piacere. Ma se ritieni che siano complicate, scrivi nel modo in cui ti riesce meglio, al resto ci pensa il Gruppo Doc durante la revisione

Come si crea un account sul wiki? Come si accede?

È necessario avere un account per modificare le pagine del wiki. Per crearlo, consulta la pagina Iscriversi al wiki.

Come è organizzata la documentazione wiki?

La documentazione wiki è suddivisa in Aree tematiche, per aiutare chiunque voglia consultarla a trovare velocemente gli argomenti di interesse.

È compito del Gruppo Doc mantenere ordinate e facilmente consultabili le guide scritte dalla comunità, revisionare e adattare agli standard le guide create o aggiornate dagli utenti. Inoltre i membri del Gruppo Doc sono contattabili per consigli, chiarimenti, aiuti nella editazione delle pagine e altre domande.

Compito degli utenti è di mantenere la documentazione aggiornata e rinnovata: ogni aiuto è il benvenuto!!

Come si può collaborare per migliorare la documentazione?

Sei libero di verificare le guide esistenti, di correggerle e aggiornarle, di scriverne di nuove.
Ecco una serie di consigli:

• Verifica di una guida: se hai consultato un procedimento che funziona, ma la versione di Ubuntu (o derivata) su cui hai effettuato le modifiche non è indicata alla voce Guida verificata con Ubuntu: 15.04, 14.04 ... posta sotto l'Indice della guida wiki, puoi inserire tu stesso la verifica alla guida. Per farlo, accedi al wiki e modifica la pagina interessata inserendo alla voce:

  <<Informazioni(forum="..."; rilasci="15.04 14.04";)>>

  la tua versione di Ubuntu.

• Errori banali: se trovi nomi sbagliati, errori ortografici, collegamenti errati, ecc.. correggili pure!

• Grosse modifiche/Nuove pagine: se vuoi apportare delle modifiche importanti ad una guida wiki o vuoi crearne una nuova, metti al corrente il Gruppo Doc nel forum e saremo felici di consigliarti e aiutarti.

Posso creare nuove pagine quando mi pare e piace?

Per la documentazione wiki è molto importante che non si creino pagine doppione, che i contenuti non si replichino su pagine differenti e che i contenuti rimangano su temi attinenti. Pertanto mentre le modifiche banali (correzioni di nomi/parole sbagliate, link rotti, ecc..) possono essere immediatamente corrette, per la creazione di nuove guide o la profonda revisione di quelle già esistenti occorre avvisare il Gruppo Doc nella apposita sezione del forum.
In questo modo è possibile monitorare i lavori, accertarsi che i nuovi argomenti non siano in realtà già presenti e che non esulino dagli obiettivi del wiki.

Quali argomenti non sono adatti al wiki?

Di norma viene accettato tutto quello che può servire a risolvere problemi di configurazione software/hardware e in generale scavalcare le difficoltà che possono verificarsi nell'utilizzo di Ubuntu. Potrebbero invece essere scartati:

• argomenti troppo generici: argomenti generalisti di stampo enciclopedico (ad es. approfondimenti su linguaggi di programmazione, su protocolli di rete, ecc..). In questi casi potrebbe essere più indicato rivolgersi a uno strumento come Wikipedia. Si tratta di valutare di volta in volta.

• Argomenti troppo banali: ad esempio limitarsi a segnalare l'installazione di un pacchetto software già disponibile in Ubuntu, senza ulteriori indicazioni.

Non riesco ad accedere al wiki o a modificare delle guide, come risolvo?

Consulta la pagina Risoluzione problemi.
Se hai altri problemi e non riesci a risolvere, puoi contattare il Gruppo Doc.

Cos'è una pagina personale?

È una pagina in cui parli di te e ti presenti al resto della comunità, sei libero di scrivere quello che vuoi
La pagina personale è utile per fare pratica con il wiki, per elencare le guide che ti interessano, per indicare i tuoi contributi o come vuoi iniziare a contribuire...

Spesso la pagina personale viene utilizzata anche come Indice personale, per raggruppare le tue pagine di prova. Ad esempio è possibile creare la pagina di prova MarioRossi/Prova1, che è una sotto-pagina della pagina personale MarioRossi.

Consulta questa pagina wiki per sapere come creare la tua pagina personale.

Come si scrive una guida? Come si scrive in grassetto? Come si inseriscono titoli dei paragrafi e elenchi?

Non esiste un unico metodo per scrivere una guida wiki. Puoi avvalerti di un modello o copiare una guida esistente da incollare e modificare in una nuova pagina.

Per imparare a formattare correttamente una pagina wiki, dai un'occhiata alla Guida in 10 passi più uno

Come si allega un'immagine?

Non è generalmente necessario caricare immagini in una guida, sia per evitare di appesantire troppo il wiki, sia perché nella maggior parte dei casi le procedure indicate dalle guide non richiedono immagini esplicative. Pertanto, se non è strettamente necessario, si evita di caricare immagini sul wiki che col tempo andrebbero aggiornate o rimosse.

Se comunque desideri inserire un'immagine che ritieni utile in una guida wiki, visualizza la guida in questione e seleziona la voce Allegati nella barra grigia superiore del wiki.
Una volta caricata l'immagine, puoi usare:

<<Immagine(./nomeimmagine.png,)>>

oppure:

{{nomeimmagine.png}}

per visualizzare l'immagine nella guida.

Ricordati di utilizzare solo immagini non coperte da copyright e in formato .png.

Come si corregge una guida esistente?

Se desideri aggiornare o correggere una guida già presente nel wiki, puoi farlo tramite una Pagina di prova. Procedi in questo modo:

1. accedi al wiki e visualizza la pagina che vuoi aggiornare;

2. nella barra grigia superiore del wiki seleziona la voce Altre azioni → Mostra il testo grezzo, quindi copia tutto il suo contenuto;

3. crea una Pagina di prova e incolla al suo interno il testo precedentemente copiato, quindi salva.

Ora sei libero di apportare nella Pagina di prova tutte le modifiche che vuoi. Appena terminata, informa il Gruppo Doc sul forum in modo che la pagina venga revisionata e nel caso riadattata dallo staff.

Cos'è una pagina di prova e come si crea?

Una pagina di prova è in pagina non indicizzata (non è raggiungibile dall'Indice della documentazione wiki) che puoi liberamente creare e modificare a tuo piacimento.
Per maggiori informazioni puoi consultare questa pagina.

Come si crea una nuova guida?

Le nuove guide possono essere create da subito col nome dell'argomento trattato.
Una volta fatto, puoi utilizzare il Nuovo documento per scrivere la tua guida. Appena terminata, informa il Gruppo Doc sul forum in modo che la pagina venga revisionata e nel caso riadattata dallo staff.

Si può collaborare con più persone nella creazione o modifica delle guide?

Certamente! Poiché tutti possono editare il wiki, è anche possibile che più persone collaborino alla creazione o alla modifica di una guida. L'unico limite consiste nel non poter scrivere la stessa pagina contemporaneamente.

Come si cancella una pagina o un allegato?

È possibile fare delle richieste specifiche al Gruppo Doc, come l'eliminazione di pagine di prova personali, immagini o altro, tramite la pagina ToDoWiki.
In alternativa puoi contattare direttamente i membri dello staff.

Come si contatta il Gruppo Doc?

Il Gruppo Documentazione è contattabile su: forum, Mailing List e canale IRC #ubuntu-it-doc.

Per la creazione o modifica delle guide wiki, il "luogo" in cui preferiamo consultarci è il forum, dove per ogni guida esiste una discussione specifica.

CategoryComunitaDocumentazione