Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "GruppoDocumentazione/Partecipa/FAQ"
Differenze tra le versioni 2 e 28 (in 26 versioni)
Versione 2 del 11/12/2015 12.20.57
Dimensione: 4744
Commento:
Versione 28 del 04/02/2016 17.05.09
Dimensione: 17927
Commento:
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 1: Linea 1:
## page was renamed from Benvenuto
#format wiki
#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read All:read
Linea 5: Linea 4:
<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?f=46&t=605720")>>
Linea 6: Linea 6:
<<Indice(depth=2)>>

= Benvenuto! =

Vuoi scrivere una nuova guida del [[Documentazione/Indice|Wiki]] o ti va di correggerne una già esistente?

 * '''Iscriviti al wiki''': occorre [[GuidaWiki/IscriversiAlWiki|creare un account]].
 * '''Non hai dimestichezza?''': dai un'occhiata alla [[Wiki10Passi|guida al wiki in 10 passi più uno]].
 * '''Crea una''' [[PaginaPersonale|pagina personale]]: può essere utile sia come profilo personale che per fare pratica ;)

= Scrivere pagine =

 * '''Errori banali''': se trovi nomi sbagliati, errori ortografici, link errati, ecc.. correggili pure!
 * '''Grosse modifiche/nuove pagine''': mettere al corrente il [[GruppoDocumentazione|Gruppo Doc]] nel [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]].
 * Appena terminata, la pagina verrà [[GruppoDocumentazione/PagineDaFare|revisionata]] e nel caso [[GuidaWiki/Standard|riadattata]] dallo staff.

||<tablestyle="text-align: justify; width:100%; " style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Per le guide da aggiornare si utilizzano [[GuidaWiki/CreazioneNuovePagine#Pagine_Prova|pagine di prova]]. Le nuove guide possono anche essere create da subito col [[GuidaWiki/CreazioneNuovePagine#Nuovi_Documenti|nome]] dell'argomento trattato.''||

= Contatti =

Il [[GruppoDocumentazione|Gruppo Documentazione]] è contattabile su: [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]], [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|Mailing List|mailing list]] e canale IRC [[http://chat.ubuntu-it.org/#ubuntu-it-doc|#ubuntu-it-doc]].

= Richieste =

È possibile fare delle richieste specifiche al gruppo doc, come l'eliminazione di pagine di prova personali, immagini o altro, tramite la pagina [[ToDoWiki]].

= FAQs =

== 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 guide della comunità italiana di Ubuntu.

== Cos'è la documentazione wiki? ==
La documentazione wiki è la documentazione scritta dalla comunità italiana di Ubuntu, liberamente accessibile e modificabile da chiunque. <<BR>>
Se sei un bravo traduttore e vuoi tradurre una guida da una lingua straniera, oppure conosci un particolare argomento e vuoi condividere con la comunità le tue conoscenze, sei nel posto giusto :)

== Cos'è la comunità italiana di Ubuntu? ==
La comunità è costituita da tutte le persone che usano Ubuntu o una sua derivata.

== È necessario far parte del Gruppo Doc per editare il wiki? ==
Assolutamente no. Chiunque è libero di correggere le guide wiki o di crearne di nuove.

== È necessario avere un account per modificare le guide wiki? ==
Si.

== Come si crea un account sul wiki? Come si accede al wiki? ==
Consulta la pagina [[GuidaWiki/IscriversiAlWiki|IscriversiAlWiki]].

== Cos'è una pagina personale? ==

= FAQ =

Le '''FAQ''' (frequently asked questions) sono risposte alle domande più frequenti poste da chi si affaccia per la prima volta alla [[Documentazione/Indice|documentazione wiki]]. Se vuoi sapere come funziona la documentazione della comunità italiana di Ubuntu e vuoi contribuire, qui potrai approfondire vari aspetti.

<<Anchor(su)>>
'''Introduzione'''
 * '''[[#wiki|Cos'è il wiki di Ubuntu-it?]]'''
 * '''[[#documentazione-wiki|Cos'è la documentazione wiki?]]'''
 * '''[[#differenza_wiki-manuali|Qual è la differenza fra documentazione wiki e Manuali di Utilizzo?]]'''
 * '''[[#perchè-wiki|Perché dovrei scrivere guide sul wiki piuttosto che su un blog/sito personale?]]'''
'''Organizzazione'''
 * '''[[#organizzazione|Come è organizzata la documentazione wiki?]]'''
 * '''[[#appartenere_gruppo-doc|È necessario far parte del Gruppo Doc per editare il wiki?]]'''
 * '''[[#saper-editare|Devo già saper editare alla perfezione pagine wiki per scrivere guide?]]'''
'''Come utilizzare gli strumenti'''
 * '''[[#come-migliorare-wiki|Come si collabora per migliorare la documentazione?]]'''
 * '''[[#account|Come si crea un account sul wiki?]]'''
 * '''[[#problemi-accesso|Non riesco ad accedere al wiki o a modificare delle guide, come risolvo?]]'''
 * '''[[#pagina-personale|Cos'è una pagina personale?]]'''
 * '''[[#editazione-pagine|Come si scrive una guida? Come si scrive in grassetto? Come si inseriscono titoli dei paragrafi e elenchi?]]'''
 * '''[[#immagini-allegate|Come si allega un'immagine?]]'''
 * '''[[#correzione-guide|Come si corregge una guida esistente?]]'''
 * '''[[#pagina-prova|Cos'è una pagina di prova e come si crea?]]'''
 * '''[[#pagine-da-revisionare|Esiste un elenco di guide da aggiornare o correggere?]]'''
 * '''[[#creare-guida|Come si crea una nuova guida?]]'''
 * '''[[#permesso-creazione-pagine|Posso creare nuove pagine quando mi pare e piace?]]'''
 * '''[[#off-topic|Quali argomenti non sono adatti al wiki?]]'''
 * '''[[#traduzioni|Posso tradurre guide straniere?]]'''
 * '''[[#collaborare|Posso collaborare con più persone nella stesura delle guide?]]'''
 * '''[[#cancellare-allegati|Come si cancella una pagina o un allegato?]]'''
'''Gruppo Documentazione'''
 * '''[[#entrare_gruppo-doc|Posso entrare a far parte del Gruppo Doc?]]'''
 * '''[[#contatti|Come si contatta il Gruppo Doc?]]'''


||<tablestyle="text-align: justify; width:85%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Per ulteriori dubbi o domande il [[GruppoDocumentazione|Gruppo Documentazione]] è contattabile su: [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]], [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|Mailing List|mailing list]] e canale IRC [[http://chat.ubuntu-it.org/#ubuntu-it-doc|#ubuntu-it-doc]].||

<<Anchor(wiki)>>
= Cos'è il wiki di Ubuntu-it? =
Il wiki è una piattaforma aperta di condivisione e collaborazione, utilizzata sia dai [[http://www.ubuntu-it.org/comunita/struttura|gruppi di lavoro]] di Ubuntu-it per coordinare i lavori, sia per la pubblicazione della [[Documentazione/Indice|documentazione wiki]] riguardante il sistema operativo Ubuntu.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(documentazione-wiki)>>
= Cos'è la documentazione wiki? =
La [[Documentazione/Indice|documentazione wiki]] è la documentazione scritta da chi utilizza il sistema operativo Ubuntu. Qualsiasi utente può partecipare alla stesura delle guide.<<BR>>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!<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(differenza_wiki-manuali)>>
= Qual è la differenza fra documentazione wiki e Manuali di Utilizzo? =
Mentre la [[Documentazione/Indice|documentazione wiki]] è modificabile appunto attraverso il wiki da utenti qualsiasi, i [[http://help.ubuntu-it.org|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 [[GruppoTraduzione|Gruppo Traduzione]].<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(organizzazione)>>
= Come è organizzata la documentazione wiki? =
La documentazione wiki è suddivisa in [[Documentazione/Indice#Aree_tematiche|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 '''[[GruppoDocumentazione|Gruppo Doc]]''' mantenere ordinate e facilmente consultabili le guide scritte dalla comunità, revisionare e adattare agli [[GuidaWiki/Standard|standard]] le guide create o aggiornate dagli utenti. Inoltre i membri del '''Gruppo Doc''' sono [[#contatti|contattabili]] per consigli, chiarimenti, aiuti nella editazione delle pagine e altre domande.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(perchè-wiki)>>
= Perché dovrei scrivere guide sul wiki piuttosto che su un blog/sito personale? =
 * Partecipando a un progetto di [[http://it.wikipedia.org/wiki/Scrittura_collaborativa|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.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(appartenere_gruppo-doc)>>
= È necessario far parte del Gruppo Doc per editare il wiki? =
'''Assolutamente no'''. Chiunque può correggere le guide wiki o crearne di nuove.<<BR>>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.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(saper-editare)>>
= 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 [[Wiki10Passi|questa pagina]] può vedere come trasformare le parole in titoli di paragrafi, in testo in grassetto, in link, ecc..<<BR>>In realtà le guide seguono alcune [[GuidaWiki/Standard|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 ;)<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(come-migliorare-wiki)>>
= Come si collabora per migliorare la documentazione? =
Sei libero di verificare le guide esistenti, di correggerle e aggiornarle, di scriverne di nuove.<<BR>>
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: 14.04, 12.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="14.04 12.04";)>>}}} la tua versione di Ubuntu. Ad esempio, se vuoi aggiungere la verifica per Ubuntu 15.10, il risultato sarà simile al seguente:{{{
<<Informazioni(forum="..."; rilasci="15.10 14.04 12.04";)>>}}}

 * '''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 '''[[GruppoDocumentazione|Gruppo Doc]]''' nel [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] e saremo felici di consigliarti e aiutarti.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(account)>>
= Come si crea un account sul wiki? =
È necessario avere un account per modificare le pagine del wiki. Per crearlo, consulta la pagina [[GuidaWiki/IscriversiAlWiki|Iscriversi al wiki]].<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(problemi-accesso)>>
= Non riesco ad accedere al wiki o a modificare delle guide, come risolvo? =
Consulta la pagina [[GuidaWiki/IscriversiAlWiki/RisoluzioneProblemi|Risoluzione problemi]].<<BR>>
Se hai altri problemi e non riesci a risolvere, puoi [[#contatti|contattare]] il '''Gruppo Doc'''.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(pagina-personale)>>
= Cos'è una pagina personale? =
Linea 55: Linea 112:
Puoi utilizzare la pagina personale anche in tantissimi altri modi: 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 sotto-pagine di prova. Ad esempio è possibile creare la pagina MarioRossi/Prova1 come pagina di prova, che è una sotto-pagina della pagina personale MarioRossi.

Consulta [[PaginaPersonale|questa pagina wiki]] per sapere com creare la tua pagina personale.

== Come si scrivono le guide wiki? ==
Non esiste un metodo univoco per scrivere una guida wiki. Puoi avvalerti di un [[DocumentazioneModello|modello]] o di una guida esistente per imparare a scrivere una guida wiki.

== Come si corregge una guida esistente? ==
Se desideri aggiornare o correggere una guida già presente nel wiki, puoi farlo tramite una '''pagina di prova'''.

== Cos'è una pagina di prova e come si crea? ==
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 [[PaginaPersonale|questa pagina wiki]] per sapere come creare la tua pagina personale.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(editazione-pagine)>>
= 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 [[DocumentazioneModello|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 [[Wiki10Passi|Guida in 10 passi più uno]] ;)<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(immagini-allegate)>>
= 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.<<BR>>
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`.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(correzione-guide)>>
= 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:
 0. accedi al wiki e visualizza la pagina che vuoi aggiornare;
 0. nella barra grigia superiore del wiki seleziona la voce '''''Altre azioni → Mostra il testo grezzo''''', quindi copia tutto il suo contenuto;
 0. 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 [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] in modo che la pagina venga [[GruppoDocumentazione/PagineDaFare|revisionata]] e nel caso [[GuidaWiki/Standard|riadattata]] dallo staff.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(pagina-prova)>>
= Cos'è una pagina di prova e come si crea? =
Linea 69: Linea 153:
Per maggiori informazioni puoi consultare [[GuidaWiki/CreazioneNuovePagine#Pagine_Prova|questa pagina]].

== Come si crea una nuova guida? ==

== Si può collaborare con più persone nell'editazione delle guide? ==

== Come si contatta il Gruppo Doc? ==
Per maggiori informazioni puoi consultare [[GuidaWiki/CreazioneNuovePagine#Pagine_Prova|questa pagina]].<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(pagine-da-revisionare)>>
= Esiste un elenco di guide da aggiornare o correggere? =
Le guide da aggiornare e correggere o che richiedono la [[#come-migliorare-wiki|verifica]] con un [[Rilasci#Versioni_supportate|rilascio supportato]], vengono elencate nella pagina [[CategoryDaRevisionare]].<<BR>>
Sei libero di scegliere una di queste pagine e dedicarti alla sua [[#correzione-guide|correzione]].<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(creare-guida)>>
= Come si crea una nuova guida? =
Le nuove guide possono essere create da subito col [[GuidaWiki/CreazioneNuovePagine#Nuovi_Documenti|nome]] dell'argomento trattato.<<BR>>
Una volta fatto, puoi utilizzare il '''Nuovo documento''' per scrivere la tua guida. Appena terminata, informa il '''Gruppo Doc''' sul [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] in modo che la pagina venga [[GruppoDocumentazione/PagineDaFare|revisionata]] e nel caso [[GuidaWiki/Standard|riadattata]] dallo staff.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(permesso-creazione-pagine)>>
= Posso creare nuove pagine quando mi pare e piace? =
Per la [[Documentazione/Indice|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 [[#off-topic|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 [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]].<<BR>>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.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(off-topic)>>
= 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 [[https://it.wikipedia.org/wiki/Pagina_principale|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.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(traduzioni)>>
= 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 [[GuidaWiki/Standard|uso sul wiki]] in fase di revisione.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(collaborare)>>
= 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.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(cancellare-allegati)>>
= 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]].<<BR>>
In alternativa puoi [[#contatti|contattare]] direttamente i membri dello staff.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(entrare_gruppo-doc)>>
= Posso entrare a far parte del Gruppo Doc? =
È possibile entrare a far parte del [[GruppoDocumentazione|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 [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]]. Si può avere una panoramica delle attività leggendo il [[GruppoDocumentazione/VademecumEditori|vademecum degli editori]].<<BR>>Più in generale nella pagina [[GruppoDocumentazione/Organizzazione|Organizzazione]] sono riportate notizie utili per entrare a far parte del gruppo.<<BR>>
'''[[#su|Torna su]]'''

<<Anchor(contatti)>>
= Come si contatta il Gruppo Doc? =
Il [[GruppoDocumentazione|Gruppo Documentazione]] è contattabile su: [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]], [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|Mailing List|mailing list]] e canale IRC [[http://chat.ubuntu-it.org/#ubuntu-it-doc|#ubuntu-it-doc]].<<BR>>
Per la creazione o modifica delle guide wiki, il "luogo" in cui preferiamo consultarci è il forum, dove per ogni guida esiste una discussione specifica.<<BR>>
'''[[#su|Torna su]]'''
Linea 78: Linea 208:
CategoryHomepage CategoryComunitaDocumentazione

Problemi in questa pagina? Segnalali in questa discussione


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

Organizzazione

Come utilizzare gli strumenti

Gruppo Documentazione

Per ulteriori dubbi o domande il Gruppo Documentazione è contattabile su: forum, Mailing List e canale IRC #ubuntu-it-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: 14.04, 12.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="14.04 12.04";)>>

    la tua versione di Ubuntu. Ad esempio, se vuoi aggiungere la verifica per Ubuntu 15.10, il risultato sarà simile al seguente:

    <<Informazioni(forum="..."; rilasci="15.10 14.04 12.04";)>>
  • 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 ;)
Torna su

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

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

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

Esiste un elenco di guide da aggiornare o correggere?

Le guide da aggiornare e correggere o che richiedono la verifica con un rilascio supportato, vengono elencate nella pagina CategoryDaRevisionare.
Sei libero di scegliere una di queste pagine e dedicarti alla sua correzione.
Torna su

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

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

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.

Torna su

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

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

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

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

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


CategoryComunitaDocumentazione