Linee Guida Editori |
||||
Indice
Introduzione
Queste linee guida servono per garantire il corretto svolgimento delle attività dei Redattori e degli Editori per la corretta revisione e pubblicazione della newsletter.
Stile della newsletter
La newsletter utilizza le stesse regole stilistiche adottate dal gruppo documentazione per la stesura del wiki. E' preferibile utilizzare le risorse della comunità italiana, per esempio le guide presenti nel wiki, inserendo nei vari articoli i relativi link; se per caso nel nostro wiki non è presente una certa pagina, allora si crea una pagina wiki e si importa il contenuto da tradurre, chiedendo a qualche membro del gruppo traduzione di tradurlo :).
Di seguito vengono riportati i casi più importanti da tenere a mente.
Redigere un articolo
In tutti gli articoli presenti nella newsletter presi da altri blog, siti oppure da altre newsletter, è obbligatorio citare esplicitamente la fonte da cui sono stai presi per tutelare i diritti dell'autore che ha realmente scritto l'articolo. Inoltre l'articolo deve essere riscritto di proprio pugno e non copiato spudoratamente dalla fonte.
Se è necessario mettere nell'articolo delle citazioni, queste ultime devono essere scritte in corsivo e subito dopo deve essere citato l'autore oppure la fonte della citazione. Ad esempio il testo:
''"La verità è che... io sono Iron Man"'' ha detto Mattia Rizzolo.
verrà visualizzato come:
"La verità è che... io sono Iron Man" ha detto Mattia Rizzolo.È buona norma inserire qualche termine in corsivo o in grassetto per attirare l'attenzione del lettore e in generale movimentare l'articolo che altrimenti risulterebbe piatto e poco interessante. Di norma i nomi di programmi, associazioni e eventi importanti vanno scritti in grassetto, mentre i termini inglesi vanno scritti in corsivo. Vale come sempre la regola del buon gusto: se troppi grassetti appesantiscono eccessivamente il testo, si tolgono.
Nel redigere un articolo è preferibile utilizzare o la seconda persona singolare:
se desideri collaborare con la comunità
o la forma impersonale:
si consiglia di effettuare subito l'aggiornamento
Prenotare un articolo
Nella pagina Lavori in Corso di solito ci sono diverse tracce di articoli da poter scrivere. Per prenotare l'articolo basta inserire la macro @SIG@ che genererà automaticamente una firma dell'utente con data ed ora della prenotazione.
Sintassi corretta
Nella creazione della newsletter per l'invio tramite email, viene utilizzato uno script recuperabile nella pagina Materiale (file newsletter.py). Affinché lo script svolga il suo lavoro, è necessario adottare della "sintassi" precisa per alcuni elementi della newsletter.
I collegamenti esterni (URL), se racchiusi tra parentesi quadre, vengono messi tra parentesi tonde. Questo per il fatto che è possibile "rinominare" un collegamento URL. Per esempio, se il collegamento è:
[[http://www.ubuntu-it.org | il sito di Ubuntu]]
viene reso come:
il sito di Ubuntu ( http://www.ubuntu-it.org )
I riferimenti interni al wiki devono essere indicati tra parentesi quadre. Per esempio:
Consultare la pagina [[PaginaProva | Pagina di prova]]...
viene reso come:
Consultare la Pagina di prova ( http://wiki.ubuntu-it.org/PaginaProva )
Per questi collegamenti è possibile utilizzare anche la sintassi:
[[PaginaProva]]
Per i riferimenti al wiki internazionale, è possibile utilizzare:
[[Ubuntu:PaginaWiki | pagina del wiki internazionale]]
che viene reso come:
pagina del wiki internazionale ( http://wiki.ubuntu.com/PaginaWiki )
Per non far riconoscere al motore del wiki una parola come una pagina wiki, è necessario utilizzare i due apici inversi (AltGr + ' ) all'interno della parola, non si può utilizzare il punto esclamativo in principio di parola. Per esempio:
il progetto Open``Office...
viene reso come:
il progetto OpenOffice...
e non sarà creato alcun collegamento alla pagina OpenOffice.
Redazione
In questa prima parte sono presenti le indicazioni per l'inserimento dei pacchetti -dev, delle statistiche dei bug e degli aggiornamenti di sicurezza.
Pacchetti -dev
Per inserire nell'apposita sezione i pacchetti -dev, si deve visitare la seguente pagina;
copiate e incollate il risultato nella sezione apposita, mettendo in ordine alfabetico i contributori.
Controllare periodicamente in questa pagina che lo script sia aggiornato, togliendo eventuali rilasci con supporto terminato, e aggiungere i rilasci che sono in sviluppo; inoltre chiedete ogni tanto al responsabile del gruppo sviluppo, se ci sono delle nuove leve che contribuiscono ai bugfix, ed eventualmente aggiungerli nella sezione apposita.
Statistiche dei bug
In questo caso si deve andare nella seguente pagina e copiate il numero dei bug delle seguenti categorie:
Open bugs → Aperti
Critical bugs → Critici
New bugs → Nuovi
fatto questo, prendete le statistiche della settinana precedente e calcolare la differenza, sia in positivo che in negativo.
Aggiornamenti di sicurezza
Per inserire gli aggiornamenti di sicurezza, consultate la sezione apposita del forum.
Pubblicazione
In questa sezione vengono descritti i passaggi per pubblicare la newsletter sui vari canali.
Pubblicazione nel wiki
Bisogna semplicemente spostare il contenuto di EdizioneInCorso, nella pagina definitiva, magari ricontrollando se ci sono dei typo che sono sfuggiti durante la revisione.
Pubblicazione nella mailing list
Per fare ciò, si deve usare un secondo script, sempre in python, disponibile al seguente indirizzo; questo script va lanciato dopo la pubblicazione sul wiki.
Per prima cosa va copiato il testo grezzo del numero pubblicato e salvato in un file di testo sul proprio pc; salvare il file e lanciare lo script con il seguente comando:
python ./newsletter-ml.py -i XX.txt -o XX_final.txt
dove al posto di XX va messo il numero della newsletter da pubblicare. Verrà creato un file di testo (XX_final.txt).
Infine cercate e rimuovete i link alle immagini, perchè non vengono incluse nel testo da inviare in mailing list.
Pubblicazione su Blog, Social e Telegram
- I contenuti devono essere interessanti e originali, senza mai scadere nel puccioso (no gatti con Ubuntu o cose del genere), nel politico/religioso o nel volgare. In generale evitare contenuti che non passino informazioni sul mondo Ubuntu o che siano un engagment senza contenuto (niente 'Metti mi piace se anche tu usi Ubuntu 14.04')
- I contenuti devono essere scritti in italiano, senza abbreviazioni, ovviamente vanno bene link ad articoli in inglese.
I contenuti devono riguardare Ubuntu o Debian (se hanno riflesso su Ubuntu). Contenuti sul software libero in generale possono esserci solo se riguardano eventi importanti o software particolarmente rilevante (ad esempio LibreOffice, GIMP, Firefox o altri programmi importanti, GNOME, KDE e altri DE in genere)
- I contenuti devono essere costruttivi, non distruttivi (niente articoli che dimostrano quanto faccia schifo Windows o altre distribuzioni Linux o contro il Software Libero in genere)
- Non importa la quantità dei contenuti, ma la qualità. Se qualche giorno non succede niente di interessante, non pubblicare niente.
- Pubblicare screenshot e immagini di versioni in via di sviluppo va bene ed è consigliato
- Anche notizie di cosa sarà incluso nelle prossime versioni, o su cosa stanno sviluppando gli sviluppatori, purché non si scenda troppo nel tecnico, è accettato
- Non pubblicare link che portano ad installare software in via di sviluppo o che consiglino di utilizzare PPA (a meno che non siano PPA ultrafidati (ammesso che esistano PPA ultrafidati))
- Le immagini/foto allegate ai contenuti sono quelle degli articoli a cui fanno riferimento, non serve caricarle, Facebook e Google+ e i social mendia in genere le includono automaticamente.
- Nel caso si vogliano includere immagini/foto, queste devono essere:
- licenziate sotto licenze libere (includere sempre un link all'autore)
- prelevate da siti che forniscono immagini e foto gratuitamente e senza vincoli per la pubblicazione (in questo caso inserire un link al sito web da cui sono state prelevate).
Fonti d'ispirazione
Di seguito vengono elencate alcune fonti da cui è possibile reperire informazioni per scrivere gli articoli:
- Ubuntu e Canonical
- Derivate ufficiali
- Software open source
- Mailing list
- altre fonti consigliate:
http://oneopensource.it (verificare l'affidabilità e la cura nella scrittura della notizia)
- post dagli sviluppatori di Ubuntu su G+ che spesso pubblicano foto e notizie in anteprima
Siti web che offrono immagini gratuite o con licenza libera: