#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read All:read #format wiki #LANGUAGE it <> <
> <> = Introduzione = Questa pagina raccoglie le principali attività svolte dagli [[GruppoEditori|editori]] su wiki e forum. = 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: 0. '''Tenere d'occhio il forum''': controllare di frequente la [[http://forum.ubuntu-it.org/viewforum.php?f=46|sezione]] 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 e aggiornare. 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]] e aggiornare la [[GruppoDocumentazione/LavoroSvolto|tabella di riepilogo]]. == 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 struttura standard a capitoli e paragrafi:{{{ <
> <> }}} * '''Macro Informazioni''': posta sotto la macro Indice, indica versioni supportate e link alla relativa discussione sul forum. È del tipo:{{{ <> }}} {{{#!wiki note In modo analogo il primo messaggio di una discussione sul [[#forum|forum]] dovrà riportare il link alla rispettiva guida. }}} * '''Category''': posta a fondo pagina indica le [[GuidaWiki/Categorie|categorie]] di appartenenza. 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 [[DocumentazioneModello|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 struttura 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 dispone 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 == 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.<
> 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.. {{{#!wiki tip Spesso il metodo più pratico per risolvere l'editazione di alcuni passaggi, è prendere spunto dalle pagine già esistenti controllandone il codice. }}} == Licenze dei contenuti == La licenza utilizzata dal wiki è la Creative Commons [[http://creativecommons.org/licenses/by-sa/3.0/deed.it|BY-SA 3.0]]. Immagini e testi pubblicati su altri siti con la medesima licenza possono essere a sua volta pubblicati sul nostro wiki, riportando nel capitolo '''Ulteriori risorse''' il link al documento originale. {{{#!wiki important Assicurarsi che non vengano inseriti testi e immagini coperti da licenze restrittive. Se proprio dovesse essere necessario, occorre chiedere un'autorizzazione esplicita agli autori originari. }}} In linea di principio per evitare qualsiasi problema è buona cosa che gli utenti riportino con parole proprie le procedure riportate sulle guide, evitando i copia/incolla da altre guide e procurando in prima persona eventuali immagini. == Nome e indicizzazione pagine == In base all'argomento trattato la pagina sarà linkata nel portale di appartenenza e il nome, oltre all'argomento trattato dovrà indicare il portale e gli eventuali sotto-portali di appartenenza. Ad esempio la pagina sulla [[Hardware/DispositiviPartizioni/Partizioni|Partizioni]]: * è stata nominata '''Hardware/DispositiviPartizioni/Partizioni'''; * ed è [[Hardware/DispositiviPartizioni|linkata]] nel portale '''Hardware/DispositiviPartizioni'''. Se una pagina in revisione non ha già un nome appropriato, è opportuno rinominarla attraverso il menù a tendina '''Altre azioni:''' (presente in alto in ogni pagina) selezionando la voce '''Rinomina pagina'''.<
> Se la pagina in questione è una '''pagina di prova''' per una guida già esistente, allora a revisione ultimata sarà sufficiente eseguire il copia/incolla dei contenuti sulla pagina ufficiale, inserendo un commento in modo che sia chiaro quale utente abbia contribuito alle modifiche. {{{#!wiki note In caso di affinità 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. }}} == Aggiornare le tabelle == A lavoro terminato spostare i dati dalla [[GruppoDocumentazione/PagineDaFare|tabella delle revisioni]] alla tabella delle [[GruppoDocumentazione/LavoroSvolto|pagine svolte]]. <> == Comunicare sul forum == 0. Fare presente sul [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] le modifiche apportate comprese le aggiunte delle voci negli indici dei portali. 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; 0. Assicurarsi inoltre che nel primo messaggio della discussione sia inserito il link alla rispettiva guida (o guide se più di una). {{{#!wiki important Utilizzare la modifica dei messaggi solo ed esclusivamente per: inserire link alla guida nel primo post della discussione, mettere o togliere discussioni in evidenza, unire discussioni che parlano della medesima guida, solo se non crea confusione spostare un nuovo post relativo ad un altro tema in una nuova discussione. Qualsiasi altra modifica è di competenza dei moderatori del [[GruppoForum|Gruppo Forum]]. }}} Per modificare il primo post: 0. Fare clic sul tasto '''Modifica'''. 0. In fondo al messaggio inserire il link con un testo del tipo:{{{ ::::::::::::::::::::::::::::: Link alla guida [wiki]Hardware/DispositiviSenzaFili/Ndiswrapper[/wiki] }}} 0. Alla voce '''Motivo della modifica del messaggio''' inserire un breve messaggio, tipo:{{{ Inserimento link alla pagina wiki }}}In questo modo verrà stampata la data dell'ultima modifica, il nome di chi l'ha eseguita e il motivo. 0. Fare clic su '''Invia''' per applicare la modifica. <> = Pagine rinominate e redirect = Quando una pagina già esistente deve essere rinominata è opportuno creare una nuova pagina con il vecchio nome e impostare su di essa un '''redirect'''. In questo modo si evita di "rompere" i link che puntano a quella stessa pagina col vecchio nome (link presenti nel wiki, indicizzati dai motori di ricerca o semplicemente salvati nei segnalibri dai singoli utenti). Esempio dove una pagina è stata rinominata '''!PaginaConNuovoNome'''. 0. Ricreare una pagina con il vecchio nome: '''!PaginaConVecchioNome'''. 0. Inserire il redirect nella '''!PaginaConVecchioNome''': {{{ #redirect PaginaConNuovoNome }}} 0. Salvare la pagina. = Pagine obsolete = == Pagine da verificare == Quando un rilascio va fuori supporto (EOL), le pagine che erano verificate fino a tale rilascio divengono obsolete e necessitano di essere verificate con un rilascio ancora supportato.<
> In questi casi, se non si riesce a testare e verificare la pagina personalmente, inserire a fine pagina il testo:{{{ CategoryDaRevisionare}}} in modo tale che la guida venga inserita nell'elenco delle [[CategoryDaRevisionare|guide che necessitano di verifica e aggiornamento]]. == Cestino == {{{#!wiki note Prima di passare al cestinamento o alla cancellazione delle pagine, consultarsi in [[http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-doc|mailing list]] o nelle discussioni di riferimento sul forum. }}} Quando una pagina contiene informazioni o procedure datate e non più attuabili, è necessario rinominare la pagina e inserirla nel [[Cestino]]: 0. Controllare e se necessario rimuovere o commentare i collegamenti dalle altre pagine wiki alla pagina interessata. 0. Rinominare la pagina in `Cestino/NomeDellaPagina`; ad esempio `Hardware/Notebook/DellInspirion6400` va rinominata in `Cestino/DellInspiron6400`. 0. Inserire ad inizio pagina la '''!MacroCestino''':{{{ <> }}} 0. Cancellare tutte le '''Categorie''' a fine pagina e inserire:{{{ CategoryDaCancellare }}} == Cancellazione pagine == Talvolta può essere necessario cancellare pagine in disuso tramite il menù a tendina '''Altre azioni:''' selezionando la voce '''Elimina pagina'''.<
> A causa di un malfunzionamento è possibile che alcune pagine particolarmente datate non siano cancellabili. Tali pagine mostrano l'avviso:{{{ La copia di backup di questa pagina è deprecata e il suo punteggio nelle ricerca sarà basso. }}} Si può ovviare a questo problema ripristinando una versione precedente della pagina e quindi cancellarla in un secondo momento. 0. Selezionare il link '''Informazioni''' in alto a sinistra per visualizzare l'elenco delle revisioni. 0. Fare clic sul link '''Mostra''' di una delle revisioni precedenti (preferibilmente la prima). 0. Dal menù a tendina '''Altre azioni:''' selezionare '''Elimina pagina'''. = Ulteriori attività = Infine, un elenco di attività da svolgere occasionalmente: * '''Versioni in EOL''' * Commentare o eliminare dalla documentazione i riferimenti a versioni di Ubuntu non più supportate. Si ricorda di __non__ cancellare le pagine relative a note di rilascio e file torrent, in quanto contengono collegamenti incrociati con forum, sito web e newsletter. * '''Redirect''' * Controllare la situazione dei redirect all'interno del wiki e valutare quali siano veramente necessari e quali superflui. * Correggere i redirect multipli; in alcuni casi è possibile trovare pagine che reindirizzano più volte, ad esempio: <
>'''''Synaptic → AmministrazioneSistema/Synaptic → !AmministrazioneSistema/InstallareProgrammi/GestorePacchetti'''''. <
>In questi casi, va corretto il redirect nella pagina '''Synaptic''' in modo che rimandi direttamente all'ultima pagina. * '''Collegamenti''' * Sfogliare la documentazione e controllare i collegamenti in cerca di pagine spostate o sparite. Una volta trovata la pagina morta, correggere il collegamento alla pagina nuova. * '''Immagini''' * Solo all'interno della [[Documentazione|documentazione wiki]], sostituire le immagini [[http://wiki.ubuntu-it.org/CercaPagina?action=fullsearch&advancedsearch=1&mimetype=image%2Fjpeg&excludeunderlay=1|.jpg]] con immagini in formato `.png`. Ignorare le immagini presenti nelle pagine personali degli utenti o quelle riguardanti altri gruppi di lavoro.<
>Una volta sostituite, correggere il collegamento alle immagini nelle pagine wiki. * '''Categorie''' * Controllare che le [[GuidaWiki/Categorie|Categorie]] al termine delle pagine wiki siano corrette. = Ulteriori risorse = * [[GruppoDocumentazione/Organizzazione|Pagina del Gruppo Doc]] * [[GuidaWiki|Guida Wiki]] ---- CategoryComunitaDocumentazione