Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.
Si estás aqui, es probable que sea porque estas interesado en contribuir con el área de aprendizaje de MDN. ¡Esas son grandes noticias!
En esta página, encontrarás todo lo que necesitas para comenzar ayudando a mejorar el contenido de aprendizaje en MDN. hay muchas cosas que puedes hacer, dependiendo de cuanto tiempo tienes y de si eres un principiante, un desarrollador web , o un maestro.
Nota: Si ya eres un colaborador de MDN, no dudes en volver a revisar la página de status de la documentación para mantener un seguimiento del trabajo que se ha realizado y obsevar cuales son nuestras prioridades de escritura.
Nota: Los colaboradores están usando Trello board (tableros trello) para organizar sus actividades.Si quieres usarlos, solo crea una cuenta Trello y mándale un ping a Jeremie para que te de acceso de escritura en el tablero.
Soy un Principiante
¡Sorprendente! los principiantes son muy importantes y valiosos para crear y dar retroalimentación sobre el material de aprendizaje . tu tienes una perspectiva única sobre estos artículos como miembro de la audiencia a la que están dirigidos, lo cual puede convertirte en un miembro invaluable de nuestro equipo. De hecho, si estás aprendiendo algo de uno de nuestros artículos y te encuentras atascado, o consigues el artículo confuso de algún modo, bien puedes arreglarlo o hacernos saber acerca del problema para asegurarnos de que sea resuelto.
Colaborar es un gran modo de divertirse mientras se aprenden cosas nuevas. Si alguna vez te sientes perdido o tienes algunas preguntas, no dudes en contactarnos a través de nuestra lista de correo o nuestro canal IRC (ve al final de la página para más detalles).
A continuación, algunas sugerencias de, las formas en que puedes contribuir:
- Añade etiquetas a nuestros artículos (5 min)
- Etiquetando contenido de MDN es una de las formas más sencillas de contribuir con MDN. como muchas de las características de nuestra plataforma usan etiquetas para ayudar a presentar la información en contexto, la ayuda con el etiquetado es una contribución muy valiosa. Hecha un vistazo a la lista de entradas del glosario y a los artículos de aprendizaje sin etiquetas para comenzar.
- Lee y revisa una entrada de glosario (15 min)
- Como eres un principiante, necesitamos que tu vista fresca observe nuestro contenido. Si encuentras alguna entrada del glosario dificil de entender, significa que la entrada necesita ser mejorada. Sientete libre de realizar cualquier cambio que creas necesario. Si consideras que no tienes las habilidades necesarias para editar la entrada, al menos infórmanos a través de nuertra lista de correo.
- Escribe una nueva entrada de glosario (1 hour)
- Esta es la forma más efectiva de aprender algo nuevo. Escoge un concepto que quieres entender, y mientras aprendes, escribe una entrada del glosario acerca de él. Explicar algo a otros es un buen modo de "fijar" el conocimiento a tu cerebro , y de ayudarte a darle sentido a las cosas, todo mientras ayudas a otras personas. ¡Todo el mundo gana!
- Lee y revisa un artículo de aprendizaje (2 hours)
- Esto es bastante similar a revisar entradas del glosario (ver arriba); solo que toma más tiempo, ya que estos artículos son un poco más largos.
Soy un desarrollador web
Fantastico! Tus habilidades técnicas son justo lo que necesitamos para asegurarnos de que proporcionamos contenido tecnicamente preciso para los principiantes . Como esta parte específica de MDN está dedicada al aprendizaje de la web, asegurate de que tus explicaciones son lo más simple posible, sin hacerlas tan simples que no sean útiles. Es más importante ser entendible que ser extremadamente preciso.
- Lee y revisa una entrada de glosario (15 min)
- Como desarrollador web, te necesitamos para asegurarnos de que nuestro contenido es tecnicamente correcto sin ser demasiado pedante. Sientete libre de realizar cualquier cambio que consideres necesario. Si quieres discutir el contenido antes de editarlo, mandanos un ping a nuestra lista de correo o al canal IRC.
- Escribe una nueva entrada de glosario (1 hour)
- Clarificar nuestra jerga técnica es un muy buen modo de aprender y ser técnicamente preciso y simple. Los principiantes te lo agradecerán. Tenemos muchos términos indefinidos que necesitan tu atención. Escoge uno de antemano gracias.
- Lee y revisa un artículo de aprendizaje (2 hours)
- Esto es lo mismo que revisar entradas del glosario (ver arriba); solo que toma más tiempo, ya que estos artículos son bastante largos.
- Escribe un nuevo artículo de aprendizaje (4 hours)
- MDN está falta de artículos sencillos y prácticos , acerca del uso de tecnologias web (HTML, CSS, JavaScript, etc). Incluso tenemos contenido viejo en MDN que merece ser revisado y reformado. Lleva tus habilidades al límite para hacer las tecnologias web utilizables incluso por principiantes.
- Crea ejercicios, ejemplos de código o herramientas de aprendizaje interactivo. (? hours)
- Todos nuestros artículos de aprendizaje requieren lo que nosotros llamamos materiales de "Aprendizaje activo", Porque la gente aprende mejor haciendo algo. Tales materiales son: ejercicios o contenido interactivo que ayude a los usuarios a aplicar y manejar los conceptos detallados en un artículo. Hay muchas formas de crear contenido activo de aprendizaje, desde crear ejemplos de código con JSFiddle o similares, hasta crear contenido interactivo completamente hackeable con Thimble. ¡Libera tu creatividad!
I'm a teacher
MDN has a long history of technical excellence, but we lack a good sense of the best way to teach concepts to newcomers. This is where we need you, as a teacher or educator. You can help us ensure that our materials provide a good, practical educational track for our readers.
- Read and review a glossary entry (15 min)
- Check out a glossary entry and feel free to make any changes you think are necessary. If you want to discuss the content before editing, ping us on our mailing list or IRC channel.
- Write a new glossary entry (1 hour)
- Clear, simple definitions of terms and basic overviews of concepts in the glossary are critical in meeting beginners' needs. Your experience as an educator can help create excellent glossary entries; we have many undefined terms which need your attention. Pick one and go for it.
- Add illustrations and/or schematics to articles (1 hour)
- As you might know, illustrations are an invaluable part of any learning content. This is something we often lack on MDN and your skills can make a difference in that area. Check out the articles that lack illustrative content and pick one you'd like to create graphics for.
- Read and review a learning article (2 hours)
- This is similar to reviewing glossary entries (see above), but it requires more time since the articles are typically quite a bit longer.
- Write a new learning article (4 hours)
- We need simple, straightforward articles about the Web ecosystem and other functional topics around it. Since these learning articles need to be educational rather than trying to literally cover everything there is to know, your experience in knowing what to cover and how will be a great asset.
- Create exercises, quizzes or interactive learning tools (? hours)
- All our learning articles require what we call "active learning" materials. Such materials are exercises or interactive content which help a user learn to use and expand upon the concepts detailed in an article. There are lots of things you can do here, from creating quizzes to building fully hackable interactive content with Thimble. Unleash your creativity!
- Create learning pathways (? hours)
- In order to provide progressive and comprehensible tutorials, we need to shape our content into pathways. It's a way to gather existing content and figure out what is missing to create a learning article to write.