FAQ

Le FAQ (frequently asked questions) sono risposte alle domande più frequenti 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, qui potrai approfondire vari aspetti.

Introduzione

• Cos'è il wiki di Ubuntu-it?

• Cos'è la documentazione wiki?

• Qual è la differenza fra documentazione wiki e Manuali di Utilizzo?

• Perché dovrei scrivere guide sul wiki piuttosto che su un blog/sito personale?

Organizzazione

• Come è organizzata la documentazione wiki?

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

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

Come utilizzare gli strumenti

• Come si collabora per migliorare la documentazione?

• Come si crea un account sul wiki?

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

• Cos'è una pagina personale?

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

• Come si allega un'immagine?

• Come si corregge una guida esistente?

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

• Come si crea una nuova guida?

• Posso creare nuove pagine quando mi pare e piace?

• Quali argomenti non sono adatti al wiki?

• Posso tradurre guide straniere?

• Posso collaborare con più persone nella stesura delle guide?

• Come si cancella una pagina o un allegato?

Entrare nel Gruppo Doc

• Posso entrare a far parte del Gruppo Doc?

• Come si contatta il Gruppo Doc?

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 della documentazione wiki riguardante il sistema operativo Ubuntu.
Torna su

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!
Torna su

Qual è la differenza fra documentazione wiki e Manuali di Utilizzo?

Mentre la documentazione wiki è modificabile appunto attraverso il wiki da utenti qualsiasi, i Manuali di Utilizzo seguono un iter di sviluppo completamente differente essendo infatti la traduzione della documentazione allegata al sistema operativo. Per poter partecipare alla traduzione dei manuali occorre rivolgersi al Gruppo Traduzione.
Torna su

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 degli utenti è di mantenere la documentazione aggiornata e rinnovata: ogni aiuto è il benvenuto!!

• È 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.
  

Torna su

Perché dovrei scrivere guide sul wiki piuttosto che su un blog/sito personale?

• Partecipando a un progetto di scrittura collaborativa, anche se un giorno non potrai più occuparti di un argomento, altre persone potranno subentrare per aggiornare i contenuti.

• Partecipando con più persone è possibile avere più punti di vista attraverso i quali diventa più semplice far emergere errori/inesattezze e quindi intervenire per migliorare le pagine.

• Radunare le guide sul sito ufficiale di un sistema operativo, rende meno dispersiva la ricerca delle soluzioni ai problemi.
  

Torna su

È 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 occupa di mantenere ordinata la documentazione wiki, sia curando l'impostazione dei documenti scritti dagli utenti, sia avendo cura che la pagina sia pubblicata nella sezione appropriata del sito.
Torna su

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ò che farci 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 ;)
Torna su

Come si collabora 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.
  

Torna su

Come si crea un account sul wiki?

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

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.
Torna su

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.
Torna su

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.

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.

Posso tradurre guide straniere?

Occorre precisare che quello che interessa nelle pagine della documentazione sono i contenuti, ossia i passaggi utili a risolvere una problematica. Pertanto non interessa una traduzione "impeccabile" nella forma come avviene ad esempio per la traduzione dei software o della documentazione allegata ai software. La cosa importante è schematizzare i passaggi delle procedure da utilizzare, lo stile verrà comunque riadattato a quello in uso sul wiki in fase di revisione.

Posso collaborare con più persone nella stesura 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.

Posso entrare a far parte del Gruppo Doc?

È possibile entrare a far parte del Gruppo Documentazione solo dopo che ci si è cimentati con la stesura di qualche pagina. È importante dimostrare di avere un minimo di dimestichezza con gli strumenti del wiki, una certa cura nella scrittura delle pagine e una certa presenza nella sezione del forum. Si può avere una panoramica delle attività leggendo il vademecum degli editori.
Più in generale nella pagina Organizzazione sono riportate notizie utili per entrare a far parte del gruppo.

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