Dimensione: 2773
Commento:
|
Dimensione: 5601
Commento:
|
Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
Linea 1: | Linea 1: |
#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read All:read | |
Linea 4: | Linea 3: |
<<BR>> <<Indice>> |
|
Linea 5: | Linea 6: |
##{{{#!html ##<hr class="portale" /> ##<h1 class="titoloPortale">Documentazione</h1> ##}}} |
= Revisione delle pagine = |
Linea 10: | Linea 8: |
##=La comunità italiana di Ubuntu ha a disposizione due tipologie di documentazione:= ##NON DECOMMENTARE IL CODICE QUI SOPRA |
Gli [[GruppoDocumentazione/Organizzazione#Editori|editori]] si occupano della pubblicazione delle pagine di documentazione svolte dagli utenti. Per fare questo è necessario eseguire una serie di controlli elencati in questa pagina. |
Linea 13: | Linea 10: |
= Procedura generale = | |
Linea 14: | Linea 12: |
||<tablestyle="background:#aea79f;width:100%;" style="border:0;height:8px; font-size:1px;padding:0;"> || | La procedura standard degli editori può essere riassunta nella sua globalità in questi sei passi: |
Linea 16: | Linea 14: |
0. '''Tenere d'occhio il forum''': controllare di frequente la [[http://forum.ubuntu-it.org/viewforum.php?f=46|sezione del forum]] per la segnalazione di modifiche a pagine esistenti o la creazione di pagine nuove. 0. '''Tabella revisioni''': inserire i dati di una pagina appena editata nella [[GruppoDocumentazione/PagineDaFare|tabella delle revisioni]]. 0. '''Prendere in consegna''': se si è in condizione di farlo, prenotarsi per la revisione della pagina inserendo il proprio nome nella [[GruppoDocumentazione/PagineDaFare|tabella]]. 0. '''Revisionare la pagina''': controllare (se possibile) la correttezza della guida e adeguarla agli standard in uso. 0. '''Tabella pagine svolte''': spostare i dati dalla tabella delle revisioni a quella delle [[GruppoDocumentazione/LavoroSvolto|pagine svolte]]. 0. '''Comunicare nel forum''': comunicare la fine della revisione e la pubblicazione della pagina nel [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]]. |
|
Linea 17: | Linea 21: |
||<tablestyle="width:100%; min-width:100px;height:80px; background:url(/htdocs/light/img/smaller-dots.gif);" style="border:0; padding:2 0 2 0px;margin:0px; width:100px;font-size: 1.5em;color:#222222;" ( | 1 > La comunità italiana di Ubuntu ha a disposizione due tipologie di documentazione: || | = Info pagina e macro = |
Linea 19: | Linea 23: |
Assicurarsi che la pagina contenga: * '''Macro Indice''': posta insieme al rimando a capo in cima alla pagina (sotto eventuali commenti), garantisce la strutura standard a capitoli e paragrafi:{{{ |
|
Linea 20: | Linea 27: |
||<style="border:none">||<style="width:100px; border: none; -moz-border-radius-topleft: 15px ;-moz-border-radius-bottomleft: 15px; background-color:#ffffff;" : > <<BR>> [[http://help.ubuntu-it.org|{{http://wiki.ubuntu-it.org/NuoviStrumentiWiki/Home?action=AttachFile&do=get&target=help.png}}]] <<BR>><<BR>>||<style="width:500px;border: none; -moz-border-radius-topright: 15px;-moz-border-radius-bottomright: 15px; font-size:1.00em; background-color:#ffffff;" ( > I '''[[http://help.ubuntu-it.org|manuali d'uso]]''' di '''Ubuntu''': le guide ufficiali presenti nel sistema operativo rese disponibili per la consultazione via web.|| {{{#!html <br style=clear:both> |
<<Indice()>> |
Linea 27: | Linea 30: |
||<style="border:none;">||<style="width:100px; border: none; -moz-border-radius-topleft: 15px ;-moz-border-radius-bottomleft: 15px; background-color:#ffffff;" : > <<BR>> [[Documentazione/Indice|{{http://wiki.ubuntu-it.org/NuoviStrumentiWiki/Home?action=AttachFile&do=get&target=logo-wiki.png}}]] <<BR>><<BR>>||<style="width:500px;border: none; -moz-border-radius-topright: 15px;-moz-border-radius-bottomright: 15px;font-size:1.00em; background-color:#ffffff;" ( > Le '''[[Documentazione/Indice|guide wiki]]''': curate direttamente dalla '''comunità italiana''' di Ubuntu. Puoi contribuire tu stesso a migliorarle, [[GruppoDocumentazione/Benvenuto|scopri come!]]|| {{{#!html <br style=clear:both> |
* '''Macro Informazioni''': posta sotto la macro Indice, indica versioni supportate e link alla relativa discussone sul forum. È del tipo:{{{ <<Informazioni(forum="INSERIRE_LINK_DISCUSSIONE"; rilasci="12.04, 12.10")>> }}} * '''Category''': posta a fondo pagina indica le [[GuidaWiki/Categorie|categorie]] di appartennenza. Ad esempio se una pagina fa parte dei portali Hardware e Multimedia sarà del tipo:{{{ ---- CategoryHardware CategoryMultimedia |
Linea 33: | Linea 38: |
= Struttura pagina = | |
Linea 34: | Linea 40: |
* Le guide della comunità italiana sono coordinate dal [[GruppoDocumentazione|Gruppo Documentazione]]. | La presenza della macro Indice garantisce la [[DocumentazioneModello|struttura]] in capitoli e paragrafi. Per una migliore leggibilità è bene cercare di mantenere basso il numero di paragrafi o sotto paragrafi. |
Linea 36: | Linea 42: |
* Le richieste di '''assistenza tecnica''' vanno indirizzate nelle apposite sezioni di '''Supporto''' del [[http://forum.ubuntu-it.org/index.php#7|forum]] oppure, su IRC, nel canale [[http://webchat.freenode.net/?channels=ubuntu-it|#ubuntu-it]]. | * Cercare (finché possibile) di utilizzare al massimo i capitoli, ossia i titoli di primo livello, del tipo:{{{ = Capitolo = }}} |
Linea 38: | Linea 46: |
## * Tutte queste guide della comunità sono anche disponibili per la consultazione non in linea, per maggiori informazioni consultare la pagina [[OfflineWiki|OfflineWiki]]. | La strutura di una pagina può variare in base agli argomenti trattati, non esiste uno schema unico. Tuttavia è bene evitare casi "estremi" come ad esempio una pagina costituita da un unico capitolo suddiviso in una decina di paragrafi. |
Linea 40: | Linea 48: |
= Revisione tecnica = | |
Linea 41: | Linea 50: |
È buona cosa verificare di persona la correttezza dei contenuti. Purtroppo per vari motivi ciò non è sempre possibile (non si disponere dell'hardware trattato, non si conosce nel dettaglio il software trattato, ecc..). | |
Linea 42: | Linea 52: |
In questi casi cercare comunque di verificare che i passaggi mantengano una logica corretta e che non manchino passaggi fondamentali nella procedura. | |
Linea 43: | Linea 54: |
{{{#!html <hr class="portale-footer" /> <hr class="portale" /> }}} |
= Revisione stilistica = È la parte più impegnativa, nella quale occorre controllare che la pagina sia scritta: * '''in italiano corretto'''; * '''in forma impersonale'''; * '''in modo sintetico'''; * e rispetti i '''formati standard''' in uso. In definitiva si tratta di adattare il testo agli esempi riportati nella pagina [[GuidaWiki/Standard|Standard]], che raccoglie gran parte delle casistiche esistenti.<<BR>> Per approfondire determinati argomenti la [[GuidaWiki|Guida Wiki]] presenta link a guide di vario genere come: inserimento di [[GuidaWiki/RegoleStilistiche#Note.2C_avvisi_e_suggerimenti|note e avvisi]], struttura delle [[GuidaWiki/Editor#Tabelle|tabelle]], ecc.. ||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>>||<style="padding:0.5em; border:none;">Spesso il metodo più pratico per risolvere l'editazione di alcuni passaggi, è prendere spunto dalle pagine già esistenti controllandone il codice.|| = Indicizzazione pagine = In base all'argomento trattato la pagina sarà linkata nel portale di appartenenza e il nome indicherà il portale o i portali di appartenenza.<<BR>> Aesempio la pagina sulla [[Hardware/DispositiviPartizioni/GestioneDisco|gestione del disco]]: * è stata nominata '''Hardware/DispositiviPartizioni/GestioneDisco'''; * ed è [[Hardware/DispositiviPartizioni|linkata]] nel portale '''Hardware/DispositiviPartizioni'''. ||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''In caso di afinità una pagina può essere linkata su portali differenti. Ad esempio una guida su di un lettore mp3 può essere indicata sia sul portale multimediale che sul portale hardware.'' || = Comunicare sul forum = Terminata la revisione fare presente sul forum le modifiche apportate comprese le aggiunte delle voci negli indici dei portali.<<BR>> Più in generale cercare di non essere parsimoniosi nell'uso dei link, in modo da fare sempre presente in modo chiaro a quale pagine si stia facendo riferimento. Questo tenendo anche conto che i post col tempo possono essere disseminati di link a pagine non più esistenti. = Ulterirori risorse = * [[GruppoDocumentazione/Organizzazione|Pagina del Gruppo Doc]] * [[GuidaWiki|Guida Wiki]] ---- CategoryComunitaDocumentazione |
Revisione delle pagine
Gli editori si occupano della pubblicazione delle pagine di documentazione svolte dagli utenti. Per fare questo è necessario eseguire una serie di controlli elencati in questa pagina.
Procedura generale
La procedura standard degli editori può essere riassunta nella sua globalità in questi sei passi:
Tenere d'occhio il forum: controllare di frequente la sezione del forum per la segnalazione di modifiche a pagine esistenti o la creazione di pagine nuove.
Tabella revisioni: inserire i dati di una pagina appena editata nella tabella delle revisioni.
Prendere in consegna: se si è in condizione di farlo, prenotarsi per la revisione della pagina inserendo il proprio nome nella tabella.
Revisionare la pagina: controllare (se possibile) la correttezza della guida e adeguarla agli standard in uso.
Tabella pagine svolte: spostare i dati dalla tabella delle revisioni a quella delle pagine svolte.
Comunicare nel forum: comunicare la fine della revisione e la pubblicazione della pagina nel forum.
Info pagina e macro
Assicurarsi che la pagina contenga:
Macro Indice: posta insieme al rimando a capo in cima alla pagina (sotto eventuali commenti), garantisce la strutura standard a capitoli e paragrafi:
<<BR>> <<Indice()>>
Macro Informazioni: posta sotto la macro Indice, indica versioni supportate e link alla relativa discussone sul forum. È del tipo:
<<Informazioni(forum="INSERIRE_LINK_DISCUSSIONE"; rilasci="12.04, 12.10")>>
Category: posta a fondo pagina indica le categorie di appartennenza. Ad esempio se una pagina fa parte dei portali Hardware e Multimedia sarà del tipo:
---- CategoryHardware CategoryMultimedia
Struttura pagina
La presenza della macro Indice garantisce la struttura in capitoli e paragrafi. Per una migliore leggibilità è bene cercare di mantenere basso il numero di paragrafi o sotto paragrafi.
Cercare (finché possibile) di utilizzare al massimo i capitoli, ossia i titoli di primo livello, del tipo:
= Capitolo =
La strutura di una pagina può variare in base agli argomenti trattati, non esiste uno schema unico. Tuttavia è bene evitare casi "estremi" come ad esempio una pagina costituita da un unico capitolo suddiviso in una decina di paragrafi.
Revisione tecnica
È buona cosa verificare di persona la correttezza dei contenuti. Purtroppo per vari motivi ciò non è sempre possibile (non si disponere dell'hardware trattato, non si conosce nel dettaglio il software trattato, ecc..).
In questi casi cercare comunque di verificare che i passaggi mantengano una logica corretta e che non manchino passaggi fondamentali nella procedura.
Revisione stilistica
È la parte più impegnativa, nella quale occorre controllare che la pagina sia scritta:
in italiano corretto;
in forma impersonale;
in modo sintetico;
e rispetti i formati standard in uso.
In definitiva si tratta di adattare il testo agli esempi riportati nella pagina Standard, che raccoglie gran parte delle casistiche esistenti.
Per approfondire determinati argomenti la Guida Wiki presenta link a guide di vario genere come: inserimento di note e avvisi, struttura delle tabelle, ecc..
Spesso il metodo più pratico per risolvere l'editazione di alcuni passaggi, è prendere spunto dalle pagine già esistenti controllandone il codice. |
Indicizzazione pagine
In base all'argomento trattato la pagina sarà linkata nel portale di appartenenza e il nome indicherà il portale o i portali di appartenenza.
Aesempio la pagina sulla gestione del disco:
è stata nominata Hardware/DispositiviPartizioni/GestioneDisco;
ed è linkata nel portale Hardware/DispositiviPartizioni.
In caso di afinità una pagina può essere linkata su portali differenti. Ad esempio una guida su di un lettore mp3 può essere indicata sia sul portale multimediale che sul portale hardware. |
Comunicare sul forum
Terminata la revisione fare presente sul forum le modifiche apportate comprese le aggiunte delle voci negli indici dei portali.
Più in generale cercare di non essere parsimoniosi nell'uso dei link, in modo da fare sempre presente in modo chiaro a quale pagine si stia facendo riferimento. Questo tenendo anche conto che i post col tempo possono essere disseminati di link a pagine non più esistenti.