Som una comunitat oberta de persones que generem recursos per a una millor web, independent de marques, navegadors o plataformes. Qualsevol pot contribuir i cada persona que ho fa enforteix la comunitat. Com a comunitat, podem continuar impulsant la innovació a la xarxa per servir el bé més gran. Això comença aquí, amb tu.
Cada part de MDN Web Docs (des del codi que fa que el lloc funcioni a la documentació, exemples de codi i demostracions) és creada per una comunitat de persones. Tothom té alguna cosa per oferir i esperem que t'uneixis a nosaltres!
3 senzills passos per MDN Web Docs
MDN és una wiki, on qualsevol persona pot afegir i editar contingut. No necessiteu saber programació o conèixer molt sobre les tecnologies. Hi ha moltes coses que cal fer, des de tasques simples com ara revisar correctament i corregir errors tipogràfics fins a tasques complexes com ara escriure la documentació de l'API.
Contribuir és fàcil i segur. Fins i tot si cometeu un error, és fàcil de solucionar; si no sabeu exactament com han de quedar les coses, o la vostra gramàtica no és la millor, no us preocupeu. Tenim un equip de persones, que fan la feina d'assegurar-se que els continguts de MDN siguin tan bons com sigui possible. Algú estarà atent per assegurar que la vostra aportació estigui ordenada i ben escrita. Compartiu el vostre coneixement, seguiu les vostres fortaleses i confieu en la resta de la comunitat per ajudar a millorar el vostre treball.
Pas 1: Crear un compte a MDN
Per començar a fer les vostres contribucions al MDN, heu de tenir un compte a MDN. Per obtenir més informació, consulteu com crear un compte.
Pas 2: Triar una tasca
Ara que heu iniciat la sessió, llegiu les descripcions dels diferents tipus de tasques a la llista de sota, i decidiu quina us crida més l'atenció. Podeu triar qualsevol tasca que vulgueu i començar la vostra contribució.
Pas 3: Fer la tasca
Un cop hàgiu decidit quin tipus de tasca voleu fer, cerqueu una pàgina específica, un exemple de codi, etc. perquè treballar-hi i, senzillament, feu-la.
No us preocupeu de fer-la perfectament; altres persones col·laboradores de MDN estan aquí per ajudar a corregir els errors que hi hagi. Si teniu preguntes a mesura que aneu fent, consulteu la pàgina de la Comunitat per obtenir informació sobre les llistes de correu i els canals de xat on podeu obtenir respostes.
Nota: Si vols experimentar amb l'edició a MDN abans de fer alguna cosa "real", tenim una pàgina Sandbox perquè hi juguis. Limita't a fer els teus experiments en aquesta pàgina. No facis canvis innecessaris a les pàgines de contingut només per veure què passa; això pot crear un embolic per qui hagi de netejar-ho.
Quan hàgiu acabat amb la tasca escollida, no dubteu a triar un altre element, o consulteu a continuació altres coses que podeu fer a MDN.
Tipus de tasques possibles
Hi ha molts camins que pots triar per contribuir a MDN, en funció de les teves habilitats i interessos. Malgrat que algunes tasques poden ser desencoratjadores, tenim un munt d'activitats simples disponibles. Moltes necessiten només cinc minuts (o menys!) del teu temps. Sota, juntament amb la tasca i la seva descripció curta, trobaràs el temps aproximat que dura cada tipus de tasca.
Opció 1: M'agraden les paraules
Ens pots ajudar revisant o editant documents que ja existeixen i aplicant-hi les etiquetes correctes.
- Escriu el resum d'una pàgina (5-15 minuts)
- Revisions Editorials (5-30 minuts)
- Actualitza un article existent amb nova informació (5 minuts-1 hora)
- Escriu una nova entrada al Glossari (15 minuts-1 hora)
- Escriu un article sobre una nova tecnologia o API (30 minuts-2 hores)
- Escriu un article per ajudar a la gent a aprendre sobre el web (1-3 hores)
Opció 2: M'agrada el codi
Necessitem més exemples! Fins i tot pots ajudar a construir la nostra plataforma de llocs, Kuma!
- Converteix mostres de codi per estar "en viu" (30 minuts)
- Configura un entorn de Kuma (1 hora)
- Envia la teva correció de codi a la base de codi de Kuma (1 hora)
- Envia una nova demostració (1 hora)
Opció 3: M'agraden el codi i les paraules
Tenim tasques que requereixen habilitats tant tècniques com lingüístiques, com escriure nous articles, revisar We have tasks that require both technical and language skills, like writing new articles, assegurar precisió tècnica o adaptació de documents.
- Etiqueta pàgines de JavaScript (5 minuts)
- Promociona MDN a la teva pròpia pàgina web (5 minuts)
- Revisions tècniques (30 minuts)
- Escriu un nou article sobre un tema amb el que estiguis familiaritzat (1 hora o més)
- Crea un exercici interactiu per ajudar a la gent a aprendre coses sobre el web (1 hora o més)
- Arregla un error de documentació de MDN category in Bugs Ahoy (1 hora o més)
Opció 4: Vull MDN en el meu idioma
Tota la feina de localització i traducció a MDN és realitzada per la nostra increible comunitat de voluntaris.
- Tradueix pàgines (2 hores)
- Connecta amb altres traductors llistats a Projectes de localització (30 minuts)
Opció 5: He trobat informació incorrecte però no sé com arreglar-la
Pots informar sobre problemes omplint un bug de documentació. (5 minuts)
Altres coses que pots fer a l'MDN
- Uneix-te a la Comunitat MDN
- Completa el teu perfil per que els altres puguin saber més de tu
- Aprèn més sobre com contribuir a l'MDN
- Utilitza l'MDN per aprendre