mozilla

Revision 336971 of Iniziare

  • Slug della versione: Project:en/Project:Getting_started
  • Titolo della versione: Getting started
  • ID versione: 336971
  • Data di creazione
  • Autore: Grino
  • Versione corrente? No
  • Commento

Contenuto della versione

Il Mozilla Developer Network ha tanti incarichi da adattarsi a qualunque livello di conoscenza tecnica. Non è necessario essere un programmatore o conoscere un sacco di tecnologia. Esistono talmente tanti compi che devono essere svolti, dal semplice (prova di lettura e correzione di battitura) al complesso (scrittura della documentazione delle API).

MDN ha una semplice interfaccia basata sul web che lo rende familiare a chiunque abbia utilizzato un elaboratore di testi. Per favore aiutaci! Il successo di MDN è costruito sullo spirito di miglioramento cooperativo della comunità dei Mozzilliani.

  • Il contenuto è più importante dello stile, grammatica e compitazione. Se il tuo inglese non è perfetto - non preoccuparti! Se non memorizzi la guida allo stile - non preoccuparti! Se commetti un errore di battitura - non preoccuparti! Gli errori sono semplici da correggere, ed i cambiamenti possono essere velocemente e facilmente ripristinati.
  • Chiedi aiuto e chatta con i tuoi nuovi amici nella comunità MDN. La comunità (sia staff a pagamento che volontari) sono amichevoli. Vogliamo bene (AMIAMO!) i nuovi collaboratori! Se non ricevi una rapida risposta alla tua email o domanda su IRC, ricorda che ci sono persone in molti fusi orari differenti che lavorano su molti differenti progetti. Sentiti libero di chiedere più di una volta e/o di chiedere a più di una persona. Non sei stato ignorato. Contatta Eric Shepherd, il capo di MDN, se non riesci ad ottenere l'aiuto di cui hai bisogno. Non c'è niente di più importante per noi dell'aiutare i collaboratori.
  • Chiunque può cambiare qualunque cosa. Nessuno si sconvolgerà se cambi il suo contenuto, e tu non dovresti sconvolgerti se qualcuno cambia il tua roba (sebbene tu sia liber odi chiedere ragguagli sui cambiamenti). I cambiamenti non sono la criticità - essi sono (quasi sempre) miglioramenti costruttivi.
  • Abbiamo guide per specifiche aree di argomenti. Se stai lavorando su una particolare area, possono aiutarti.

Guida all'Avvio Rapido

Log in

MDN utilizza Persona per l'autenticazione. Crearae un account Persona e poi eseguire il log in a MDN.

Pratica

Fai pratica nella Sandbox, l'area del wiki destinata a raccogliere guai, apprendimento e sperimentazioni.

Modifica una pagina

  1. Fai clic sul pulsante "Edit" in cima a qualunque pagina
  2. Click the"Edit" button at the top of any page.
  3. Fai i tuoi cambiamenti. Clicca "PREVIEW CHANGES" per vedere come appaio i cambiamenti.
  4. clicca "SAVE AND KEEP EDITING" per salvare i cambiamenti senza chiudere l'interfaccia di modifica. Clicca su "SAVE CHANGES" per salvare la pagina e chiudere l'interfaccia di modifica. Clicca "DISCARD CHANGES" per tornare alla versione originale della pagina.

Non saria in grado di salvare i cambiamenti ed otterrai un errore "Permission Denied" se il tuo browser è stato configurato per non inviare le informazioni del referrer. Se non puoi salvare i cmabiamenti, in FireFox, assicurati che la preferenza {{pref("network.http.sendRefererHeader")}} sia impostata al suo valroe di predefinito (al momento è "2").

Creare una nuova pagina

Se non sai dove mettere un nuovo articolo, non preoccuparti! Mettilo dove capita, e noi lo troveremo e sposteremo nel luogo cui appartiene, o lo uniremo a del contenuto esistente se ha più senso. Non devi neanche preoccuparti di farlo perfetto. Abbiamo felici gnomi aiutanti che aiuteranno a rendere il contenuto pulito e succulento.

Collegametno da una pagina esistente

  1. Inserisci il nome della nuove pagina ocunque nel testo della pagina.
  2. Evidenzia il nome e fai clic sull'icona Link () nella barra degli strumenti dell'editor. La finestra di dialogo "Update Link" si apre, con il testo evidenziato nel campo "Link To".
  3. "/en-US/docs/" sarà inserito per default all'inizio del campo URL. Inserisci il nome della pagina dopo "/en-US/docs/". (Il nome della pagina non deve essere lo stesso del testo del collegamento.)
  4. Clicca OK per creare ed inserire il collegamento.

Se la pagina non esiste, il collegamento sarà rosso. Se la pagina esiste già, il collegamento sarà blu. Se vuoi creare una nuova pagina ma il titolo della pagina è giù utilizzato, verifica prima se non abbia più senso aiutare nella modifica e miglioramento della pagina già esistente. Altrimenti, pensa a un differente titolo per la tua nuova pagina e crea un collegamento ad essa. Fai riferimento alla guida per i nomi della pagine.

Per aggiungere contenuto alla tua nuova pagina, clicca sul collegamento rosso appena creato (dopo aver salvato e chiuso l'editor) e inizia a scrivere. Clicca "SAVE AND KEEP EDITING" mentre lavori per salvare le modifiche senza chiudere l'interfaccia di modifica. Clicca "SAVE CHANGES" quando hai finito.

Nuova pagina senza collegamento

Per creare una nuova pagina senza collegarla da un'altra pagina, inserisci un nome di pagina unico nel campo URL del tuo browser. Per esempio, se inserisci:

https://developer.mozilla.org/en-US/docs/FooBar

... MDN crea una nuova pagina con titolo "FooBar" e apre l'editor così che tu possa aggiungere il contenuto alla nuova pagina.

Marcatori del Wiki

Kuma, il software svilupparo da Mozilla e che il Mozilla Developer Network utilizza, fa uso di HTML come linguaggio a marcatori per la documentazione. Se desideri vedere o modificare il contenuto HTML, puoi farlo cliccando il pulsante "Source" nella barra degli strumenti nella modalità modifcia. Cliccalo ancora per tornare all'editor WYSIWYG.

Registrazione dei Bug della Documentazione

Pioi segnalare problemi complessi compilando il bug della documentazione. Utilizza quesi valori:

product
Mozilla Developer Network
component
Documentation requests
URL
La pagina in cui hai trovato il problema
Description
Per quanto sai o hai tempo per descrivere il problema e dove trovare le informazioni corrette. Questo può includere persone ("parlare a tal dei tali") nonchè collegamenti Web.

Migrare vecchia documentazione

Un lungo corso sottoprogetto al MDN è quello di eseguire la migrazione di tutta la documentazione sviluppatore attualmente esistente dal sito mozilla.org nel wiki MDN. La procedura è abbastanza semplice:

Un sottoprogetto di lungo corso alla MDN è quello di migrare tutta la documentazione dello sviluppatore dal sito mozilla.org nel wiki MDN. La procedura è abbastanza semplice:

  1. scgli un documento che desideri migrare dall'elenco dei contenuti esistenti.
  2. Fai riferimento alla guida per i nomi delle pagine e decidi  come la pagina o le pagine per quel documento devono essere chiamate nel wiki.
  3. Crea quelle pagine e migra il contenuto, marcandolo meglio che puoi utilizzando il riferimento ai marcatori del wiki come guida.
  4. Cancella la voce dall'elenco dei contenuti esistenti.
  5. Aggiungi la voce all'elenco dei bisognosi di ridirezione list.

Se sei interessato a fare un lavoro completo su questo, devi anche:

  1. Usare il nostro sistema di ricerca per cercare qualunque link al documento originale nel wiki, quindi cambiare questi collegamenti affiinchè puntino alla nuova pagina del wiki.
  2. Verificare ridirezioni esterne al documento originale, e seganlare queste ridirezioni per la cancellazione aggiungendo loro il tag "Junk".

Localizing MDN

Se sei interessato ad aiutare nella traduzione della documentazione del wiki MDN in altro linguaggio, visita semplicemente il wiki del linguaggi orilevante e crea o edita le pagine. Vedi il progetto di localizzazione per informazioni sul progetto e come iniziare un nuovo progetto.

Risolvere "guerre di modifiche" o altri conflitti

Se per qualunque ragione finisci in una "guerra di modifiche" su una pagina, in cui due o più persone stanno continuamente facendo dei ripristini, per favore cerca di risolvere il conflitto prima con le persone coinvolte.

Se non c'è soluzione possibile, si prega di portare all'attenzione della lista di distribuzione di MDN o (come ultima risorsa) al responsabile della documentazione degli sviluppatori. Saranno consultati altri tecnici esperti, scrittori e redattori come richiesto e la loro esperienza sarà utilizzata per risolvere il problema.

Richiedere la cancellazione di pagine

Se dovssi creare accidentalmente una pagina o capiti su una pagina che ritieni debba essere cancellata, segnala aggiungendole il tag "Junk".

Items tagged as Junk are checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.

Nota: Per favore non cancellare altro contenuto o categorie dalle pagine segnalate come "Junk".

Sorgente della versione

<p>Il Mozilla Developer Network ha tanti incarichi da adattarsi a qualunque livello di conoscenza tecnica. Non è necessario essere un programmatore o conoscere un sacco di tecnologia. Esistono talmente tanti compi che devono essere svolti, dal semplice (prova di lettura e correzione di battitura) al complesso (scrittura della documentazione delle API).</p>
<p>MDN ha una semplice interfaccia basata sul web che lo rende familiare a chiunque abbia utilizzato un elaboratore di testi. <strong>Per favore aiutaci!</strong> Il successo di MDN è costruito sullo spirito di miglioramento cooperativo della <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">comunità </a>dei Mozzilliani.</p>
<ul>
  <li><strong>Il contenuto è più importante dello stile, grammatica e compitazione. </strong>Se il tuo inglese non è perfetto - non preoccuparti! Se non memorizzi la <a href="/en-US/docs/Project:MDC_style_guide" title="/en-US/docs/Project:MDC_style_guide">guida allo stile</a> - non preoccuparti! Se commetti un errore di battitura - non preoccuparti! Gli errori sono semplici da correggere, ed i cambiamenti possono essere velocemente e facilmente ripristinati.</li>
  <li><strong>Chiedi aiuto e chatta con i tuoi nuovi amici nella comunità MDN.</strong> La <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">comunità</a> (sia staff a pagamento che volontari) sono amichevoli. Vogliamo bene (AMIAMO!) i nuovi collaboratori! Se non ricevi una rapida risposta alla tua email o domanda su IRC, ricorda che ci sono persone in molti fusi orari differenti che lavorano su molti differenti progetti. Sentiti libero di chiedere più di una volta e/o di chiedere a più di una persona. Non sei stato ignorato. Contatta <a class="link-mailto" href="mailto:eshepherd@mozilla.com">Eric Shepherd</a>, il capo di MDN, se non riesci ad ottenere l'aiuto di cui hai bisogno. Non c'è <em>niente</em> di più importante per noi dell'aiutare i collaboratori.</li>
  <li><strong>Chiunque può cambiare qualunque cosa.</strong> Nessuno si sconvolgerà se cambi il suo contenuto, e tu non dovresti sconvolgerti se qualcuno cambia il tua roba (sebbene tu sia liber odi chiedere ragguagli sui cambiamenti). I cambiamenti non sono la criticità - essi sono (quasi sempre) miglioramenti costruttivi.</li>
  <li><strong>Abbiamo <a href="/Project:en/Topic_drivers" title="Project:en/Topic_drivers">guide per specifiche aree di argomenti</a>.</strong> Se stai lavorando su una particolare area, possono aiutarti.</li>
</ul>
<h2 id="Guida_all'Avvio_Rapido">Guida all'Avvio Rapido</h2>
<h3 id="Log_in">Log in</h3>
<p>MDN utilizza <a href="http://www.persona.org/" title="http://www.persona.org/">Persona</a> per l'autenticazione. Crearae un account Persona e poi eseguire il log in a MDN.</p>
<h3 id="Pratica">Pratica</h3>
<p>Fai pratica nella <a href="/en-US/docs/Sandbox" title="Sandbox: An area of the wiki for experiments">Sandbox</a>, l'area del wiki destinata a raccogliere guai, apprendimento e sperimentazioni.</p>
<h3 id="Modifica_una_pagina">Modifica una pagina</h3>
<ol>
  <li>Fai clic sul pulsante "Edit" in cima a qualunque pagina</li>
  <li>Click the"Edit" button at the top of any page.</li>
  <li>Fai i tuoi cambiamenti. Clicca "PREVIEW CHANGES" per vedere come appaio i cambiamenti.</li>
  <li>clicca "SAVE AND KEEP EDITING" per salvare i cambiamenti senza chiudere l'interfaccia di modifica. Clicca su "SAVE CHANGES" per salvare la pagina e chiudere l'interfaccia di modifica. Clicca "DISCARD CHANGES" per tornare alla versione originale della pagina.</li>
</ol>
<div class="note">
  <p>Non saria in grado di salvare i cambiamenti ed otterrai un errore "Permission Denied" se il tuo browser è stato configurato per non inviare le informazioni del referrer. Se non puoi salvare i cmabiamenti, in FireFox, assicurati che la preferenza {{pref("network.http.sendRefererHeader")}} sia impostata al suo valroe di predefinito (al momento è "2").</p>
</div>
<h3 id="Creare_una_nuova_pagina">Creare una nuova pagina</h3>
<p>Se non sai dove mettere un nuovo articolo, <strong>non preoccuparti!</strong> Mettilo dove capita, e noi lo troveremo e sposteremo nel luogo cui appartiene, o lo uniremo a del contenuto esistente se ha più senso. Non devi neanche preoccuparti di farlo perfetto. Abbiamo felici gnomi aiutanti che aiuteranno a rendere il contenuto pulito e succulento.</p>
<h4 id="Collegametno_da_una_pagina_esistente">Collegametno da una pagina esistente</h4>
<ol>
  <li>Inserisci il nome della nuove pagina ocunque nel testo della pagina.</li>
  <li>Evidenzia il nome e fai clic sull'icona Link (<img alt="" src="/files/3810/link-icon.png" style="width: 29px; height: 28px;" />) nella barra degli strumenti dell'editor. La finestra di dialogo "Update Link" si apre, con il testo evidenziato nel campo "Link To".</li>
  <li>"/en-US/docs/" sarà inserito per default all'inizio del campo URL. Inserisci il nome della pagina dopo "/en-US/docs/". (Il nome della pagina non deve essere lo stesso del testo del collegamento.)</li>
  <li>Clicca OK per creare ed inserire il collegamento.</li>
</ol>
<p>Se la pagina non esiste, il collegamento sarà rosso. Se la pagina esiste già, il collegamento sarà blu. Se vuoi creare una nuova pagina ma il titolo della pagina è giù utilizzato, verifica prima se non abbia più senso aiutare nella modifica e miglioramento della pagina già esistente. Altrimenti, pensa a un differente titolo per la tua nuova pagina e crea un collegamento ad essa. Fai riferimento alla <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">guida per i nomi della pagine</a>.</p>
<p>Per aggiungere contenuto alla tua nuova pagina, clicca sul collegamento rosso appena creato (dopo aver salvato e chiuso l'editor) e inizia a scrivere. Clicca "SAVE AND KEEP EDITING" mentre lavori per salvare le modifiche senza chiudere l'interfaccia di modifica. Clicca "SAVE CHANGES" quando hai finito.</p>
<h4 id="Nuova_pagina_senza_collegamento">Nuova pagina senza collegamento</h4>
<p>Per creare una nuova pagina senza collegarla da un'altra pagina, inserisci un nome di pagina unico nel campo URL del tuo browser. Per esempio, se inserisci:</p>
<pre>
https://developer.mozilla.org/en-US/docs/FooBar</pre>
<p>... MDN crea una nuova pagina con titolo "FooBar" e apre l'editor così che tu possa aggiungere il contenuto alla nuova pagina.</p>
<h4 id="Marcatori_del_Wiki">Marcatori del Wiki</h4>
<p><a href="https://github.com/mozilla/kuma" title="https://github.com/mozilla/kuma">Kuma</a>, il software svilupparo da Mozilla e che il Mozilla Developer Network utilizza, fa uso di HTML come linguaggio a marcatori per la documentazione. Se desideri vedere o modificare il contenuto HTML, puoi farlo cliccando il pulsante "Source" nella barra degli strumenti nella modalità modifcia. Cliccalo ancora per tornare all'editor WYSIWYG.</p>
<h2 id="Registrazione_dei_Bug_della_Documentazione">Registrazione dei Bug della Documentazione</h2>
<p>Pioi segnalare problemi complessi <a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">compilando il bug della documentazione</a>. Utilizza quesi valori:</p>
<dl>
  <dt>
    product</dt>
  <dd>
    Mozilla Developer Network</dd>
  <dt>
    component</dt>
  <dd>
    Documentation requests</dd>
  <dt>
    URL</dt>
  <dd>
    La pagina in cui hai trovato il problema</dd>
  <dt>
    Description</dt>
  <dd>
    Per quanto sai o hai tempo per descrivere il problema e dove trovare le informazioni corrette. Questo può includere persone ("parlare a tal dei tali") nonchè collegamenti Web.</dd>
</dl>
<h2 id="Migrare_vecchia_documentazione">Migrare vecchia documentazione</h2>
<p><span id="result_box" lang="it"><span class="hps">Un</span> <span class="hps">lungo</span> <span class="hps">corso</span> <span class="hps">sottoprogetto</span> <span class="hps">al</span> <span class="hps">MDN</span> <span class="hps">è quello di</span> <span class="hps">eseguire la migrazione di</span> <span class="hps">tutta la documentazione</span> <span class="hps">sviluppatore</span> <span class="hps">attualmente esistente</span> <span class="hps">dal sito</span> <span class="hps">mozilla.org</span> <span class="hps">nel</span> <span class="hps">wiki</span> <span class="hps">MDN</span><span>.</span> <span class="hps">La procedura</span> <span class="hps">è abbastanza semplice</span><span>:</span></span></p>
<p>Un sottoprogetto di lungo corso alla MDN è quello di migrare tutta la documentazione dello sviluppatore dal sito <a class="external" href="http://www.mozilla.org">mozilla.org</a> nel wiki MDN. La procedura è abbastanza semplice:</p>
<ol>
  <li>scgli un documento che desideri migrare dall'elenco dei <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">contenuti esistenti</a>.</li>
  <li>Fai riferimento alla <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">guida per i nomi delle pagine</a> e decidi&nbsp; come la pagina o le pagine per quel documento devono essere chiamate nel wiki.</li>
  <li>Crea quelle pagine e migra il contenuto, marcandolo meglio che puoi utilizzando il <a href="/Project:En/MDC_style_guide" title="Project:en/Wiki_Markup_Reference">riferimento ai marcatori del wiki </a>come guida.</li>
  <li>Cancella la voce dall'elenco dei <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">contenuti esistenti</a>.</li>
  <li>Aggiungi la voce all'elenco dei <a href="/Project:en/Needs_Redirect" title="Project:en/Needs_Redirect">bisognosi di ridirezione</a> list.</li>
</ol>
<p>Se sei interessato a fare un lavoro completo su questo, devi anche:</p>
<ol>
  <li>Usare il <a href="/Special:Search" title="Search">nostro sistema di ricerca</a> per cercare qualunque link al documento originale nel wiki, quindi cambiare questi collegamenti affiinchè puntino alla nuova pagina del wiki.</li>
  <li>Verificare <a href="/Project:en/External_Redirects" title="Project:en/External_Redirects">ridirezioni esterne</a> al documento originale, e seganlare queste ridirezioni per la cancellazione aggiungendo loro il tag "Junk".</li>
</ol>
<h2 id="Localizing_MDN">Localizing MDN</h2>
<p>Se sei interessato ad aiutare nella traduzione della documentazione del wiki MDN in altro linguaggio, visita semplicemente il wiki del linguaggi orilevante e crea o edita le pagine. Vedi il <a href="/en-US/docs/Project:Localization_Projects" title="/en-US/docs/Project:Localization_Projects">progetto di localizzazione</a> per informazioni sul progetto e come iniziare un nuovo progetto.</p>
<h2 id="Risolvere_.22guerre_di_modifiche.22_o_altri_conflitti">Risolvere "guerre di modifiche" o altri conflitti</h2>
<p>Se per qualunque ragione finisci in una "guerra di modifiche" su una pagina, in cui due o più persone stanno continuamente facendo dei ripristini, per favore cerca di risolvere il conflitto prima con le persone coinvolte.</p>
<p><span lang="it"><span>Se non c'è soluzione possibile, si prega di portare all'attenzione della </span></span><a href="/Project:en/Community" title="Project:en/Community">lista di distribuzione di MDN</a> o (come ultima risorsa) al <a href="/User:Sheppy" title="User:Sheppy">responsabile della documentazione degli sviluppatori</a>. Saranno consultati altri tecnici esperti, scrittori e redattori come richiesto e la loro esperienza sarà utilizzata per risolvere il problema.</p>
<h2 id="Richiedere_la_cancellazione_di_pagine">Richiedere la cancellazione di pagine</h2>
<p>Se dovssi creare accidentalmente una pagina o capiti su una pagina che ritieni debba essere cancellata, segnala aggiungendole il tag "Junk".</p>
<p>Items tagged as <a class="internal" href="https://developer.mozilla.org/en-US/docs/tag/junk" title="Special:Tags?tag=Junk">Junk</a> are checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.</p>
<div class="note">
  <strong>Nota</strong>: Per favore non cancellare altro contenuto o categorie dalle pagine segnalate come "Junk".</div>
Ripristina questa versione