Qhathanisa Izibukezo

knowledge base

In questo articolo vengono spiegati alcuni aspetti del funzionamento della Knowledge Base del SUpporto MOzilla (SUMO).

In questo articolo vengono spiegati alcuni aspetti del funzionamento della Knowledge Base del SUpporto MOzilla (SUMO). __TOC__ = Che cos'è la Knowledge Base? = La Knowledge Base è un wiki con i super-poteri: *'''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 [[How to use For|<nowiki>{</nowiki>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 = Dal momento che i [https://support.mozilla.org/it/products prodotti Mozilla] vengono utilizzati da milioni di persone con diversi livelli di capacità, la Knowledge Base dovrebbe 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, come ad esempio la configurazione delle preferenze avanzate ''about:config'' * Caratteristiche avanzate o destinate agli sviluppatori come la console web {note}'''Nota''': gli articoli per la risoluzione dei problemi spesso sono un'eccezione a questa regola. Se un problema si può risolvere solamente con una modifica avanzata, ciò viene documentato. Questa regola non si applica anche agli articoli di [https://support.mozilla.org/it/products/firefox-enterprise Firefox per le aziende], che sono scritti per gli amministratori di sistema che desiderano configurare Firefox sui computer della propria azienda.{/note} = 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 [/contributors/most-visited 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 [/contributors/need-changes questo pannello], ordinato secondo le priorità in modo da poter capire subito su quali articoli occorre lavorare prima. '''Eccezioni:'''<br> 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. *'''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 Mozilla per i dispositivi portatili, come ad esempio Firefox per Android e Firefox per iOS, 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. == Priorità per i sistemi desktop == #'''Windows''': essendo il 90% degli utilizzatori su piattaforma Windows, la presenza di immagini prese su questo sistema è fuori discussione. Per le schermate si preferisce Windows 10. #'''Mac''': la versione attuale è macOS 13.0 (Ventura) a partire dal mese di ottobre 2022. #'''Linux''': si preferisce Ubuntu per le schermate. '''Piattaforma Mobile''' *'''Android''' 4.0 o superiori (4.0, 4.1, 4.2, 4.3, ecc.). <!-- Needs review and update for current process (Are we still doing this?) '''Localizzazione:'''<br> 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. All'incirca ogni sei settimane viene creato un elenco delle priorità (come ad esempio [/forums/l10n-forum/708538 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 ha il suo forum specifico per la discussione accessibile nel menu Strumenti di modifica ("Editing Tools").<br>[[Image:SUMOEditingToolsDiscussion]]<br> 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 '''[/forums/knowledge-base-articles/ forum delle discussioni della Knowledge Base]'''. <!--Needs review and update for current process (Are we still doing this?) == Come mantenere gli articoli coerenti con le ultime versioni dei prodotti Mozilla? == Ci sono molteplici versioni per ciascun prodotto Mozilla. 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. [[Image:doc schedule]] === 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 '''[https://wiki.mozilla.org/Features/Release_Tracking Tracciamento dei rilasci]'''. *'''Tracciamento di Nightly''': ci serviamo della pagina di '''[https://wiki.mozilla.org/Features/Release_Tracking 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 '''[[#w_ready-for-localization|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? == *'''[http://blog.mozilla.com/sumo Mozilla Support (SUMO) blog]''': in questo blog compaiono gli ultimi aggiornamenti di progetto e di sviluppo. *'''[[Contributor News & Resources]]''': un'altra importante fonte di informazioni aggiornata all'incirca ogni settimana. *'''[/forums/contributors Discussioni della comunità di SUMO]''': in questo spazio i collaboratori possono discutere tra loro. *'''[/forums/knowledge-base-articles Discussioni sugli articoli della KB]''': qui trovano spazio le discussioni generali sulla KB. *'''[/forums/l10n-forum Discussioni sulla localizzazione]''': in questo forum si discute della localizzazione di SUMO. <!-- Below will be moved to a new article about "Guidelines to write a new KB article" == Creare un nuovo articolo== Se si ritiene che alla Knowledge Base occorra un nuovo articolo: {note}Assicurarsi per prima cosa che effettivamente non esista un articolo su questo argomento.{/note} #Fare clic su '''[/en-US/kb/new Create a new article]''' e riempire i campi utilizzando il sorgente di un altro articolo come falsariga. #Scrivere la bozza dei contenuti. #Servirsi del pulsante {button Preview Content} per controllare il lavoro fatto. #Fare clic sul pulsante {button 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: * '''[[How to write Knowledge Base articles]]''' per la lingua inglese * '''[http://www.mozillaitalia.org/home/regole-generali-di-traduzione 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 '''[[Markup chart]]''' per l'elenco e gli esempi. == <nowiki>{</nowiki>for<nowiki>}</nowiki> == Nell'articolo '''[[How to use 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 [/kb/category/60 modelli] da utilizzare negli articoli per evitare di scrivere e localizzare più volte lo stesso insieme di istruzioni ricorrenti. Leggere '''[[How to use Templates]] ''' 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. --> = 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 iniziare a creare nuovi articoli, è necessario soffermarsi su alcune considerazioni: '''Abbiamo davvero bisogno di questo articolo?'''<br> 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 il recupero dei dati utente mancanti dopo un aggiornamento di Firefox). == Archiviazione degli articoli == Per garantire che la nostra Knowledge Base rimanga focalizzata sulle richieste più attuali e urgenti degli utenti, esaminiamo e archiviamo periodicamente gli articoli che non riflettono più le ultime versioni dei prodotti o servizi Mozilla di interesse degli utenti. L'archiviazione non è la fine di un articolo ma è un modo per segnalare che il contenuto potrebbe essere obsoleto o meno rilevante per la nostra attuale base di utenti, preservandone comunque il valore storico e l'accesso per coloro che potrebbero averne bisogno. === Come funziona l'archiviazione === Il personale Mozilla (staff) e i collaboratori con privilegi di revisione possono contrassegnare un articolo come obsoleto. Questo viene fatto modificando la pagina ''Description'' (Descrizione) dell'articolo accessibile tramite l'opzione ''Edit Article Metadata'' ("Modifica metadati articolo") disponibile negli ''Strumenti di Modifica'' ("Editing Tools"). Un articolo archiviato viene rimosso da tutti i pannelli ("dashboard"), inclusi i pannelli di localizzazione, e non verrà visualizzato nei normali risultati di ricerca. Tuttavia, eventuali link diretti esistenti all'articolo continueranno a funzionare. Verrà visualizzato un avviso ("banner") sulla parte superiore dell'articolo archiviato che informerà l'utente che l'articolo non è più mantenuto e potrebbe non essere aggiornato. L'archiviazione è reversibile. In caso di necessità, i collaboratori possono visitare nuovamente la pagina {button Edit Article Metadata} e deselezionare l'opzione ''Obsoleto'', riportando l'articolo allo stato attivo. ===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 l'archiviazione di articoli della Knowledge Base=== Quando si decide di archiviare un articolo, considerare quanto segue per garantire che la decisione sia in linea con i migliori interessi della nostra base utenti e l'accuratezza della nostra Knowledge Base: *'''Obsolescenza e irrilevanza''': gli articoli dovrebbero essere archiviati se il contenuto non è più pertinente con le versioni attuali dei prodotti o servizi Mozilla. Per i dettagli, vedere la politica di supporto della versione di Firefox per il contenuto della Knowledge Base. *'''Ridondanza''': il contenuto che è stato sostituito da articoli più completi o duplicato in più articoli senza aggiungere valore univoco dovrebbe essere archiviato per semplificare la Knowledge Base. *'''Contenuto storico''': gli articoli che servono più come documentazione storica piuttosto che come supporto pratico e attuale possono essere archiviati per mantenere la base di conoscenza attiva focalizzata sul supporto degli utenti. ==Visibilità limita== La funzionalità Restrict Visibility (Visibilità limita) è una recente aggiunta volta a migliorare la flessibilità della gestione dei contenuti all'interno della piattaforma SUMO. Questa funzionalità consente ad articoli specifici di essere visibili solo a gruppi designati, come membri dello staff o determinati collaboratori, consentendo la distribuzione di contenuti sensibili o in fase iniziale in modo controllato. [[Image:Restrict visibility feature]] ===Come funziona=== La Visibilità limitata consente allo staff e ai collaboratori di disporre dei privilegi di revisore per gestire l'accessibilità degli articoli a un pubblico specifico. Questa funzionalità è importante per controllare la diffusione di informazioni sensibili o in fase iniziale che non sono ancora destinate al pubblico più ampio. Ecco come funziona: *'''Impostazione delle restrizioni''': un membro dello staff o un collaboratore con i privilegi necessari può limitare la visibilità di un articolo. Ciò si ottiene accedendo alla pagina Descrizione dell'articolo e selezionando le impostazioni di visibilità appropriate dalla sezione "Modifica metadati articolo" disponibile in Strumenti di modifica. *'''Impatto della restrizione''': una volta impostata la visibilità limitata per un articolo, diventa inaccessibile al pubblico in generale e visibile solo ai membri dello staff e ai gruppi designati (come circoli specifici di collaboratori, collaboratori con [https://it.wikipedia.org/wiki/Accordo_di_non_divulgazione NDA], ecc.). Questa azione rimuove l'articolo dai risultati di ricerca generali e dalle dashboard pubbliche, anche se i link diretti all'articolo rimangono funzionali per coloro che vi hanno accesso. *'''Indicatori di visibilità''': gli articoli con visibilità limitata presenteranno indicatori o banner per chiarire il loro stato ai visualizzatori che hanno l'accesso. Questo li avvisa che il contenuto è limitato e potrebbe contenere informazioni non ancora pubbliche o destinate a un pubblico specifico. *'''Reversibilità e regolazione''': l'impostazione di limitazione della visibilità non è permanente e può essere modificata in base alla necessità di modifiche della restrizione. Lo staff e i collaboratori con i privilegi appropriati possono tornare alle impostazioni dei metadati dell'articolo per modificare le restrizioni di visibilità, rendendo l'articolo disponibile a un pubblico più ampio o modificando i gruppi che hanno accesso all'articolo. ===Considerazioni prima di limitare la visibilità=== Prima di applicare la funzionalità Limita visibilità a un articolo, è fondamentale valutare quanto segue per garantire che la funzionalità venga utilizzata in modo efficace: *'''Necessità del pubblico''': assicurarsi che il contenuto sia effettivamente destinato a un pubblico specifico e non vantaggioso per una base di utenti più ampia. *'''Sensibilità del contenuto''': valutare la sensibilità delle informazioni per determinare se è garantita una visibilità limitata. *'''Impatto sul supporto del forum''': valutare se limitare la visibilità dell'articolo potrebbe avere un impatto negativo sugli utenti che potrebbero altrimenti trarre vantaggio dalle informazioni e, in tal caso, cercare metodi alternativi per risolvere eventuali dubbi. *'''Rilevanza temporanea''': per i contenuti sensibili solo temporaneamente (ad esempio, funzionalità sotto protezione dalla diffusione a tutti gli utenti fino a una determinata data), pianificare di modificare le impostazioni di visibilità una volta che le informazioni non saranno più limitate. ===Linee guida per limitare la visibilità=== *'''Contenuti pre-release''': ideale per articoli che descrivono in dettaglio le funzionalità o i prodotti imminenti che non sono ancora pubblici. *'''Comunicazione mirata''': consente la condivisione di informazioni con gruppi specifici all'interno della nostra comunità, come collaboratori con NDA o leader locali, senza rendere pubblico il contenuto. *'''Gestione delle informazioni sensibili''': utile per contenuti che, per la loro natura sensibile, richiedono un accesso limitato. = Linee guida per la revisione di un articolo = Si rimanda alla lettura dell'articolo [[Article review and approval guidelines]]. = Linee guida complete della Knowledge Base = Se si è veramente interessati a modificare e scrivere documentazione, ecco alcune risorse che dovrebbero aiutare a capire come facciamo le cose '''Creare nuovi articoli di supporto''' * [[Write articles for the Knowledge Base]]: guida alle tecniche e agli stili di scrittura che utilizziamo per rendere gli articoli più coinvolgenti ed efficaci. Per i meccanismi di creazione o modifica effettiva degli articoli, vedere: ** [[Create a new Knowledge Base article]]: passaggi per la creazione di un nuovo articolo, insieme ad alcuni marcatori di esempio per iniziare. ** [[Anatomy of a Knowledge Base article]]: spiega le basi di come vengono costruiti gli articoli. ** [[Article Description]]: spiega come scrivere la descrizione per un articolo di supporto. '''Migliorare gli articoli di supporto esistenti''' * [[Improve the Knowledge Base]]: spiega come collaborare al miglioramento della Knowledge Base di SUMO. * [[Edit a Knowledge Base article]]: riporta le procedure da seguire per modificare un articolo esistente. '''Altre linee guida''' * '''[[About the Knowledge Base]]: una panoramica dei meccanismi della nostra Knowledge Base (la guida che stai leggendo)''' * [[How to make screenshots]]: una guida passo passo alla creazione di schermate da utilizzare negli articoli. * [[Article review and approval guidelines]]: linee guida per i revisori della Knowledge Base. * [[Add images and screenshots to Knowledge Base articles]]: spiega come aggiungere immagini agli articoli e visualizzarle correttamente. * [[Markup cheat sheet]]: i marcatori più comunemente utilizzati negli articoli della Knowledge Base. * [[Markup chart]]: riferimento ai marcatori del wiki. Fornisce esempi e mostra il marcatore che li produce. * [[How to use "For" tags|Come utilizzare l'istruzione <nowiki>{</nowiki>for}]]: marcatore speciale che consente di mostrare le istruzioni ''per'' (for) diverse versioni dell'applicazione (ad esempio, Firefox 115) e sistemi operativi come Windows e macOS. * [[Using Templates]]: i modelli sono parti di contenuto riutilizzabili. Si può includere una serie complicata di istruzioni dettagliate in più articoli utilizzando un unico modello. * [[When and how to use keywords to improve an article's search ranking]]: spiega quando è appropriato aggiungere parole chiave a un articolo. * Per visualizzare ulteriori linee guida sul contributo alla Knowledge Base, fare clic [https://support.mozilla.org/en-US/products/contributor/kb qui].