Siamo una comunità aperta di sviluppatori che stanno creando risorse per un Web migliore, indipendentemente da marchi, browser o piattaforme. Tutti possono contribuire. Ogni nuovo collaboratore ci rende più forti. Insieme possiamo continuare a guidare il processo di innovazione sul Web per il bene comune. E cominciamo da qui, da te.
Tutte le varie parti di MDN (documentazione, demo, il sito stesso) sono create da una comunità aperta di sviluppatori. Unisciti a noi!
3 semplici passi per contribuire a MDN
MDN è un wiki, dove tutti possono aggiungere e modificare contenuti. Non è necessario essere programmatori o sapere tutto sulla tecnologia. Esistono molti compiti che necessitano di volontari, dai più semplici (revisione e correzione degli articoli) ai più complessi (scrivere la documentazione delle API).
Contribuire è facile e sicuro. Anche se fai errori è semplice sistemarli. Anche se non sai esattamente quale deve essere l'aspetto delle cose o la tua grammatica non è perfetta, non ti preoccupare! Abbiamo un gruppo di persone che ha il compito di assicurarsi che il contenuto di MDN sia il migliore possibile. Ci sarà sempre qualcuno pronto ad assicurarsi che il tuo lavoro sia ordinato e ben scritto. Condividi quello che sai.
Passo 1: creare un account su MDN
Per iniziare a collaborare con MDN, devi avere un account su MDN. Per i dettagli leggi come creare un account.
Passo 2: scegli un compito da portare a termine
Ora che sei registrato e hai effettuato l'accesso, leggi le descrizioni dei vari tipi di compiti nella lista qui sotto e decidi quale ti attira di più. Puoi scegliere qualsiasi compito preferisci per iniziare a collaborare.
Passo 3: esegui il compito
Una volta che hai deciso che tipo di compito vuoi eseguire, trova una pagina specifica, un esempio di codice ecc. su cui lavorare. E buon lavoro!
Non preoccuparti di farlo alla perfezione; altri collaboratori di MDN sono qui per aiutare a correggere gli errori che potresti commettere. Se in corso d'opera hai qualche dubbio o bisogno di chiarimenti, vedi la pagina Comunità per informazioni sulle mailing list e i canali di chat dove puoi trovare le risposte ai tuoi quesiti.
Nota: se vuoi fare qualche esperimento prima di affrontare un vero compito su MDN, puoi modificare la pagina Sandbox. Per favore limita i tuoi esperimenti a questa pagina e non effettuare modifiche non necessarie alle altre pagine solo per vedere cosa succede; creeresti confusione che altri dovrebbero poi sistemare.
Quando hai portato a termine il compito che hai scelto, sentiti libero di scegliere un altro compito o scopri quali altre cose puoi fare su MDN.
Tipi di compiti possibili
Esistono vari modi per collaborare a MDN a seconda delle tue capacità e interessi. Anche se alcuni compiti possono essere veramente impegnativi, sono disponibili anche molte attività più semplici. Molte di queste richiedono solo cinque minuti (o meno). Insieme ai compiti e a una breve descrizione, viene indicato anche il tempo approssimativamente necessario al loro completamento.
Opzione 1: mi piace scrivere
Puoi aiutarci a revisionare o modificare la documentazione corrente e applicarle le etichette corrette.
- Scrivi l'introduzione di una pagina (5-15 minuti)
- Effettua revisioni editoriali (5–30 minuti)
- Aggiorna un articolo esistente con nuove informazioni (5 minuti-1 ora)
- Scrivi un nuovo termine per il glossario (15 minuti-1 ora)
- Scrivi un articolo su una nuova tecnologia o API (30 minuti-2 ore)
- Scrivi un articolo per aiutare a imparare il Web (1 ora-3 ore)
Opzione 2: mi piace programmare
Abbiamo bisogno di più esempi di codice! Puoi anche aiutare nello sviluppo della piattaforma del sito, Kuma!
- Converti gli esempi di codice perché siano "vivi" (30 minuti)
- Crea un ambiente di sviluppo per Kuma (1 ora)
- Condividi le tue modifiche dei sorgenti di Kuma (1 ora)
- Invia una nuova demo (1 ora)
Opzione 3: mi piace sia scrivere che programmare
Abbiamo dei compiti che richiedono capacità sia tecniche che linguistiche, come ad esempio la scrittura di nuovi articoli, la revisione tecnica o l'adattamento dei documenti.
- Etichetta le pagine su JavaScript (5 minuti)
- Promuovi MDN sul tuo sito (5 minuti)
- Effettua revisioni tecniche (30 minuti)
- Aggiorna il layout delle pagine delle API (30 minuti)
- Scrivi un nuovo articolo su un argomento con cui hai familiarità (1 ora o più)
- Crea un esercizio interattivo per aiutare ad imparare il Web (1 ora o più)
Opzione 4: voglio MDN tradotto nella mia lingua
Tutto il lavoro di localizzazione e traduzione di MDN viene svolto dalla nostra fantastica comunità di volontari.
- Traduci le pagine (2 ore)
- Connettiti con gli altri traduttori presenti negli elenchi dei Progetti di localizzazione (30 minuti)
Opzione 5: ho trovato informazioni sbagliate ma non so come correggerle
Puoi segnalare problemi aprendo un bug riguardo la documentazione. (5 minutes)
Usa questi valori per i campi richiesti:
Campo su Bugzilla | Valore |
product |
Developer Documentation |
component |
[scegli un'area appropriata all'argomento o "General" se non sei sicuro su quale sia quella corretta] |
URL |
La pagina in cui hai trovato il problema |
Description |
Il maggior numero possibile di informazioni per permetterci di replicare il problema e trovare informazioni utili alla sua risoluzione. Puoi includere nomi di persone ("chiedete a tizio o caio") o anche collegamenti web. |
Altre cose che puoi fare su MDN
- Unisciti alla comunità MDN.
- Compila il tuo profilo per permettere agli altri di saperne di più su di te.
- Scopri maggiori dettagli su come contribuire a MDN.