In questo articolo vengono spiegati alcuni aspetti del funzionamento della Knowledge Base.

La Knowledge Base è un wiki con i super-poteri

Essi sono:

• Sintassi wiki specifica: sebbene venga utilizzata la sintassi MediaWiki (come quella di Wikipedia) nella maggior parte dei casi, il nostro wiki è progettato specificamente per il supporto a Mozilla e comprende anche una speciale istruzione (chiamata {for}) con la quale è possibile mostrare ad esempio un insieme di informazioni agli utenti Windows ma non agli utenti Mac.
• Sistema di revisione: poiché vogliamo sempre essere sicuri che gli utenti ricevano informazioni corrette e aggiornate, le modifiche ai nostri articoli devono essere revisionate e approvate prima che vadano online.
• Traduzioni: la maggior parte dei nostri utenti parla una lingua diversa dall'inglese, e perciò abbiamo un sistema per consentire la traduzione degli articoli dall'inglese in altre lingue.

Utenti e perimetro della Knowledge Base

Con oltre 400 milioni di utenti di Firefox, la Knowledge Base deve essere scritta per un pubblico generale più che per chi ha già familiarità con la terminologia tecnica relativa ai computer. Principalmente vengono trattate le caratteristiche dei programmi (come le schede, i segnalibri e Sync) e la risoluzione dei problemi (come i crash o difficoltà nel caricare le pagine web). Non viene trattato ogni aspetto, configurazione o problema, ma ci basiamo invece sul riscontro degli utenti (nelle discussioni relative agli articoli, nei forum di supporto e nel numero di visualizzazioni) e utilizziamo la nostra esperienza e giudizio per decidere esattamente di che cosa occuparci.

Quali sono gli argomenti di cui NON ci occupiamo nella Knowledge Base?

• Trucchi o modifiche avanzate dei prodotti
• Caratteristiche avanzate o destinate agli sviluppatori come la console degli errori o la console web

Organizzazione del lavoro

Come si stabiliscono le priorità?

Ci concentriamo sugli articoli a seconda della loro popolarità. Ciò generalmente rappresenta la priorità dei nostri utenti. Attualmente i 20 articoli più visitati assorbono più della metà delle visualizzazioni. Migliorando i nostri articoli più visitati può potenzialmente aiutare lo stesso numero di persone che possono beneficiare del miglioramento degli ultimi 100. Teniamo traccia delle modifiche da effettuare in questo pannello, ordinato secondo le priorità in modo da poter capire subito su quali articoli occorre lavorare prima.

Eccezioni:
Ovviamente la popolarità non è l'unica discriminante. Vengono tenute in conto anche queste eccezioni:

• Problemi critici: occasionalmente, nuovi problemi riportati nel nostro forum di supporto vengono gestiti meglio aggiornando tempestivamente un articolo. Per esempio, un problema che colpisce gli utenti del plugin Flash (il 99% degli utenti di Firefox) assumerà priorità maggiore rispetto a una modifica di poco conto destinata a comparire in una prossima versione di Firefox.
• Richieste anticipate: occasionalmente aggiorniamo un articolo in previsione dell'introduzione di una nuova caratteristica o della modifica di una esistente. L'articolo in questione potrebbe non avere una priorità alta, ma siamo sufficientemente sicuri che diverrà popolare basandoci sull'esperienza e sulle previsioni di marketing.
• Documentazione per piattaforma mobile: i prodotti Firefox per Android e Firefox OS hanno relativamente pochi utenti e gli articoli che li riguardano non possono "competere" in popolarità con quelli relativi a Firefox. Quindi questi numeri vanno comunque contestualizzati alla richiesta di informazioni e documentazione dello specifico prodotto.
• Link interni: articoli richiamati da altri prodotti o pagine presenti sul sito mozilla.org.

Localizzazione:
Al fine di minimizzare il lavoro per i localizzatori, cerchiamo di concentrare in un periodo di sei settimane le modifiche ai 20 articoli più consultati. Gli aggiornamenti non essenziali per questi articoli (nuove caratteristiche, piccoli aggiustamenti e miglioramenti) vengono fatti per la versione inglese ma non immediatamente marcati come pronti per la localizzazione. Quattro settimane prima del rilascio di una nuova versione, gli aggiornamenti per i 20 articoli più consultati vengono marcati come pronti per la localizzazione. Si cerca quindi di mantenere questi articoli stabili per le successive sei settimane. Talvolta, problemi improvvisi o errori possono richiedere ulteriori modifiche. Ogni sei settimane viene creato un elenco delle priorità (come ad esempio questo), basato sulla nostra esperienza relativamente alla sezione in inglese della Knowlesge Base, da utilizzare come falsariga dai localizzatori.

Dove si discute degli articoli?

Generalmente le discussioni sono di due tipi:

• Singoli articoli: ciascun articolo presenta una scheda relativa alle discussioni. Gli utenti registrati possono inserire commenti e suggerimenti per l'articolo e in questo spazio è possibile discutere su ciò che è possibile fare per migliorarlo.
  
• Intera Knowledge Base: le nuove idee e le strategie relative a tutta la KB possono essere discusse nel forum degli articoli.

Come mantenere gli articoli coerenti con le ultime versioni dei prodotti Mozilla?

Ci sono quattro versioni per ciascun prodotto Mozilla (ossia Firefox, Firefox per piattaforma Mobile, Firefox OS). Ci si riferisce ad esse come "treni". Ciascun treno si muove da un canale (o binario, per continuare ad usare la metafora del treno) all'altro ogni sei settimane. I canali sono Nightly, Aurora, Beta e Release. Per sei settimane, mentre si trovano nel canale Nightly, ai prodotti vengono aggiunte nuove caratteristiche e funzionalità. Successivamente, quella versione passa nel canale Aurora per essere sottoposto a verifiche. Dopo sei settimane su Aurora, si sposta sul canale Beta. E finalmente, dopo sei settimane di test sul canale Beta, quella versione diventa il rilascio stabile per il prodotto. Al fine di rimanere aggiornati relativamente alle modifiche di prodotto, anche la scrittura della documentazione segue un ciclo di sei settimane.

Ciclo della documentazione: settimane 1 - 4

• Localizzazione di Beta: una volta finalizzati gli articoli (nel ciclo precedente), ci saranno a disposizione quattro settimane per la localizzazione prima del rilascio. Essi saranno marcati come pronti per la localizzazione in modo da comparire nel pannello di localizzazione dei vari gruppi di lavoro.
  • Nota: nelle due settimane precedenti potremmo aver effettuato anche altre modifiche basandoci sui suggerimenti del rilascio precedente. In questo caso ci saranno altri articoli da localizzare in questa stessa tornata.
• Bozze per Aurora: avremo quattro settimane per abbozzare i nuovi articoli e gli aggiornamenti per quelli esistenti. Per identificare tutti le modifiche e le novità che necessitano di documentazione ci serviamo della pagina di Tracciamento dei rilasci.
• Tracciamento di Nightly: ci serviamo della pagina di Tracciamento dei rilasci per identificare tutti le modifiche e le novità che necessitano di documentazione. Questa operazione è un processo in divenire che continua fino alla fase Beta, ma, una volta su Aurora, le modifiche possibili coinvolgono soltanto l'eliminazione di caratteristiche dei prodotti.
• Archivio: dal momento che i nostri prodotti, servizi e documentazione si modificano con la progressione dei rilasci, viene utilizzato questo intervallo anche per valutare se esistano articoli:
  • obsoleti per modifiche ai prodotti o servizi
  • obsoleti a causa dell'esiguo numero di visite rispetto alla totalità degli utenti.

Ciclo della documentazione: settimane 5 e 6

• Aggiornamento di Release: verrà rilasciata una nuova versione dei prodotti Mozilla cosicché, se necessario, dobbiamo essere pronti a tornare sul lavoro fatto ed eseguire aggiustamenti alla documentazione basandoci sul riscontro prodotto dal forum di supporto.
• Completamento di Beta: a partire dallo spostamento di Aurora sul canale Beta, avremo due settimane per completare gli articoli in bozza. Durante questa fase verranno eseguite queste operazioni:
  • Aggiunta di immagini e filmati (se necessario)
  • Revisione e approvazione degli articoli
  • Contrassegno della versione finale come pronta per la localizzazione
• Inizio del tracciamento della nuova Nightly: una nuova versione sarà disponibile nel canale Nightly.

Come rimanere aggiornati sullo stato dei lavori?

• Mozilla Support (SUMO) blog: in questo blog compaiono gli ultimi aggiornamenti di progetto e di sviluppo.
• Pagina dei collaboratori: un'altra importante fonte di informazioni.
• Discussioni della comunità di SUMO: in questo spazio i collaboratori possono discutere tra loro.
• Forum degli articoli della KB: qui trovano spazio le discussioni generali sulla KB.
• Forum di localizzazione: in questo forum si discute della localizzazione di SUMO.

Migliorare gli articoli

Il miglioramento della Knowledge Base probabilmente costituisce il 90% del nostro lavoro. C'è sempre qualcosa da migliorare. Ci sono tre modi per rendere un articolo migliore:

• Aggiornarlo: gli aggiornamenti di prodotto e di servizi spesso introducono novità importanti e modifiche all'utilizzo. Le istruzioni dovrebbero sempre applicarsi all'ultima versione stabile.
• Correggerlo: alcuni collaboratori hanno il dono di saper trovare gli errori che i correttori ortografici dei programmi non trovano. C'è sempre bisogno di:
  • Correggere l'ortografia, la grammatica e la puntaggiatura
  • Risolvere i problemi di stile e formattazione (vedere Writing guide for Knowledge Base articles, Come utilizzare l'istruzione For e Come utilizzare i modelli per le linee guida)
• Renderlo più comprensibile:
  • Trovare un modo più semplice per esprimere un concetto complicato o non molto chiaro
  • Aggiungere immagini per aiutare la comprensione dell'articolo
  • Aggiungere filmati

Qual è il processo di modifica di un articolo?

La risposta semplice: occorre fare clic sul pulsante Edit Article, effettuare qualche modifica e sottoporlo a revisione. L'intero processo è il seguente:

1. Visitare la pagina Modifiche necessarie del pannello dei collaboratori.
2. Scegliere un articolo in base ai commenti che descrivono le modifiche da effettuare. Espandere la sezione Editing Tools e dare un'occhiata alla sezione discussioni per ottenere altre informazioni utili.
3. Modificare l'articolo. Per consigli sullo stile, leggere How to write knowledge base articles.
   • Servirsi del pulsante Preview Content per controllare le modifiche apportate.
4. Fare clic sul pulsante Submit for Review per salvare le modifiche. In questo modo l'articolo modificato sarà elencato nella sezione Da revisionare del pannello dei collaboratori.

Se passa troppo tempo prima di una revisione, si può contattare Michael Verdi (michaelverdi nel canale IRC di #sumo o via email a questo indirizzo).

Se le modifiche vengono rifiutate, il revisore spiegherà i motivi di questo rifiuto nello spazio relativo alle discussioni sull'articolo. Talvolta verrà creata una nuova versione in base alle modifiche proposte, ulteriormente corrette o arricchite con contributi di altri utenti.

Creare un nuovo articolo

Se si ritiene che alla Knowledge Base occorra un nuovo articolo:

1. Fare clic su Create a new article e riempire i campi utilizzando il sorgente di un altro articolo come falsariga.
2. Scrivere la bozza dei contenuti.
3. Servirsi del pulsante Preview Content per controllare il lavoro fatto.
4. Fare clic sul pulsante Submit for Review e scrivere nel commento il motivo per cui si è deciso di creare l'articolo.
   • In questo modo l'articolo comparirà nel pannello della KB per essere sottoposto a modifica e revisione.
   • L'articolo non sarà pubblicato se non dopo revisione e approvazione.

Stile

Vogliamo che il Supporto Mozilla sia fruibile da tutti gli utenti. Ciò significa scrivere per un pubblico generalista piuttosto che per persone già familiari con la terminologia tecnica.

• Le persone a cui ci rivolgiamo non sanno come modificare una preferenza o aggiungere un pulsante sulla barra degli strumenti senza essere guidate passo passo.
• Dare per scontato che queste persone non hanno mai modificato alcuna impostazione del prodotto o del sistema operativo utilizzato.
• Stile di scrittura: per l'inglese si utilizza uno stile collquiale e informale simile al parlato, per l'italiano lo stile è impersonale e formale.
• Immagini e video: un'immagine o un video possono quasi essere l'equivalente del supporto di una persona fisicamente presente.

Per ulteriori dettagli vedere:

• Writing guide for Knowledge Base articles per la lingua inglese
• Regole generali di traduzione per l'italiano

Sintassi

Il nostro wiki utilizza la sintassi MediaWiki (e alcune altre caratteristiche speciali) per per i pulsanti, i tasti, i menu, ecc. ecc. Leggere Sintassi Wiki per l'elenco e gli esempi.

{for}

Nell'articolo Come utilizzare l'istruzione For sono contenute le istruzioni e gli esempi per mostrare e nascondere le istruzioni relative alle diverse versioni di Firefox e ai diversi sistemi operativi.

Modelli

Abbiamo un elenco di modelli da utilizzare negli articoli per evitare di scrivere e localizzare più volte lo stesso insieme di istruzioni ricorrenti. Leggere Come utilizzare i modelli per informazioni sui modelli.

Immagini e filmati

I nostri articoli devono poter essere leggibili anche senza la presenza di immagini o video. Anche se le immagini e i video sono molto importanti e aumentano la leggibilità degli articoli, non possono essere obbligatori. I localizzatori dovranno sentirsi liberi di utilizzarli o di eliminarli all'occorrenza.

Priorità per i sistemi desktop

1. Windows: essendo il 90% degli utilizzatori su piattaforma Windows, la presenza di immagini prese su questo sistema è fuori discussione. Si può utilizzare Windows 7 o Windows 8.x.
2. Mac: la versione attuale è la 10.9 (Mavericks).
3. Linux: si preferisce Ubuntu per le schermate.

Piattaforma Mobile

1. Android 4.0 o superiori (4.0, 4.1, 4.2, 4.3).

Aggiungere e rimuovere articoli

Proporre nuovi articoli

La nostra Knowledge Base è il risultato di tutto il nostro sforzo nel supportare centinaia di milioni di utenti di Firefox. La cosa più efficace che possiamo fare è rispondere alle domande degli utenti sui prodotti e i servizi di Mozilla con un articolo. Ma gli articoli hanno un loro costo. Ogni articolo deve essere scritto, localizzato e mantenuto. Con molte caratteristiche e problemi già documentati, spesso l'uso migliore del nostro tempo collettivo è quello di migliorare gli articoli esistenti. Prima di gettarsi a capofitto nella creazione di nuovi articoli, è necessario soffermarsi su alcune considerazioni:

Abbiamo davvero bisogno di questo articolo?
Di seguito riportiamo i motivi principali che determinano l'aggiunta di un nuovo articolo alla Knowledge Base sebbene in molti casi avrebbe più senso aggiornare o integrare un articolo esistente.

• Nuove caratteristiche: quando ci si trova di fronte a caratteristiche che sono in grado di generare un grande interesse e numerose domande da parte degli utenti. Questo può essere un aspetto intrinseco di una caratteristica, il risultato di una strategia di marketing e di link interni al prodotto o una combinazione dei due fattori.
• Nuovi problemi: problemi che generano molte discussioni recenti e voti nel forum di supporto .
• Alto impatto: criticità e problemi sensibili che necessitano di documentazione temporanea (ad esempio un problema che riguarda la riproduzione dei video in formato Flash).

Archiviazione degli articoli

Periodicamente procediamo all'archiviazione di alcuni articoli della Knowledge Base per concentrarci sulle esigenze più pressanti degli utenti. Dal momento che i prodotti Mozilla vengono rilasciati ogni sei settimane, i problemi e gli elementi di cui gli utenti necessitano documentazione cambiano ad un ritmo molto più veloce. Ci saranno molti articoli (come ad esempio Segnalibri o Impostare la pagina iniziale) che rimarranno validi per molto tempo, ma ce ne saranno altri che diventeranno obsoleti o di scarsa utilità e interesse per gli utenti.

Come funziona l'archiviazione:
I collaboratori con privilegi di revisione possono contrassegnare un articolo come obsoleto modificando l'articolo utilizzando la sezione relativa alla descrizione. Ciò farà in modo di eliminare l'articolo da tutti i pannelli (compresi i pannelli di localizzazione) e dalla normale ricerca. Sarà ancora possibile vedere l'articolo utilizzando la ricerca avanzata e naturalmente verranno conservati i link relativi all'articolo. Tuttavia, verrà visualizzato un avviso sulla parte superiore dell'articolo archiviato che informerà l'utente che l'articolo non è più mantenuto e potrebbe non essere aggiornato.

L'archiviazione di un articolo non è una procedura irreversibile. Anche quando un articolo è stato archiviato, continueremo a monitorarne le statistiche per assicurarci che esso non sia tra quelli maggiormente consultati. Se ci accorgiamo che l'archiviazione dell'articolo è stata un errore o inopportuna, l'articolo potrà essere facilmente reso di nuovo pubblico e disponibile nei pannelli.

Fattori da considerare prima di archiviare un articolo:

• Bassa percentuale di visite: generalmente, gli articoli con meno di circa 1500 visite/mese.
• Poche segnalazioni recenti: problemi che presentano relativamente poche discussioni recenti e voti nel forum di supporto.
• Basso impatto: la rimozione dell'articolo non è in grado di causare o acuire un problema serio.
• Modifiche a prodotti e servizi: casi in cui un problema è stato risolto o un cambiamento nel comportamento ha reso obsoleto l'articolo.

Linee guida per la revisione di un articolo

Si rimanda alla lettura dell'articolo Article review guidelines.