mozilla
Los resultados de tu búsqueda

    ¿Cómo ayudar?

    Hay un montón de formas en las que puedes contribuir a la red de desarrolladores de Mozilla, y no todas requieren que seas capaz de escribir. Aquí encontrarás una gran guía para todo el tipo de cosas que puedes hacer para mejorar MDN, así como enlaces a las listas de las tareas específicas que necesitan ser revisadas. Tanto si eres un programador casual, un desarrollador de Firefox principal, o uno de los desarrolladores web con un millón de seguidores en Twitter, se puede encontrar una manera de ayudar a hacer MDN mejor.

    ¿Cómo puedo ayudar?

    Aquí hay algunas sugerencias específicas para el tipo de ayuda que podrías proporcionar, en función del tipo de usuario MDN que seas.

    Reportar un problema

    Mientras estás leyendo el MDN, siempre existe la posibilidad de que haya algo erróneo. Hay varias posibilidades, por supuesto, incluyendo contenido incompleto o incorrecto, escritura confusa, formato incorrecto, o ejemplos de código que no funcionan. Ahora, ya que MDN es una wiki, lo mejor que puedes hacer, es solucionar los problemas en base a tus conocimientos. Pero tal vez no conoces la respuesta o te encuentras en medio de un mar de dudas o algo así, y prefieres marcar el problema para que alguien pueda revisarlo más tarde.

    Como ocurre con todas las cosas de Mozilla, se notifica un problema de documentación mediante la presentación de un "bug". Es entonces cuando la entra en juego nuestro formulario de solicitud de información útil, que reunirá la información necesaria para que podamos empezar a solucionar la incidencia.

    Por supuesto, nuestra comunidad puede estar ocupada, así que a veces la forma más rápida de resolver un problema es repararlo uno mismo ...

    Arreglar un error

    Entre las cosas más fáciles que puedes hacer para ayudar es copiar y editar el contenido existente. Si ves algo mal, arreglalo!. Si crees que algo no está claro, trata de hacerlo mejor. Nos encanta cuando la gente arregla errores y hace pequeñas cosas para hacer MDN un poco mejor, porque este es el tipo de trabajo que hace brillar el contenido!

    Algunos recursos útiles:

    Agregar o actualizar las etiquetas de las páginas

    Las etiquetas en las páginas nos ayudan a clasificar y organizar la información, también nos ayudan a identificar las páginas que necesitan atención especial. Las etiquetas también se usan para marcar las páginas que estan obsoletas y necesitan ser marcadas como tal, o incluso eliminarlas. Es muy útil tener etiquetas correctas en las páginas.

    Hay varios tipos de problemas con las etiquetas que puedes ayudar a solucionar:

    No hay etiquetas
    Todos los artículos deberían tener por lo menos una etiqueta, y normalmente más de una. En general, como mínimo, los artículos deben tener por lo menos una etiqueta "categoría" y una etiqueta "tema". A menudo, otras etiquetas también son necesarias, pero si puedes ayudar a que al menos éstas estén presentes, ¡serás un héroe de la documentación!
    Etiquetas incorrectas
    Si estás buscando un artículo sobre HTML y tiene la etiqueta "JavaScript", ¡probablemente sea incorrecto!. Del mismo modo, si un artículo sobre punto internos de Mozilla, tiene la etiqueta "Web", probablemente tambien sea incorrecto. Quita las siguientes etiquetas (y si hace falta, añade las correctas). Este tipo de problema incluye las etiquetas incorrectas. "JavaScrpit" o "Javascrpit", por ejemplo (este último en realidad coincide, ya que las etiquetas distinguen entre mayúsculas y minúsculas, ¡pero no es correcto!).
    Etiquetas ausentes
    Si un artículo tiene algunas etiquetas, pero no todas son adecuadas, no dudes en añadir más. Tal vez buscando en una página sobre JavaScript, que está correctamente etiquetada como "JavaScript", esta no tenga más etiquetas. Ya que es una página de referencia, también debería tener la etiqueta de "Referencia". ¡Estas invitado a añadirla!
    Etiquetas spam o no deseadas
    Esta etiqueta es la más odiada de todas: algunos robots Web ha depositado sus excrementos en las etiquetas de una página, dejando una página con etiquetas como "warez gratis!" o "Hey, yo estaba navegando su sitio y quería preguntarle si usted podría ayudarme a resolver este problema que estoy teniendo con Flash todo el tiempo". ¡Estas deben ser eliminadas rápidamente!

    Si ves uno (o más) de estos problemas, puedes ayudar entrando en MDN, a continuación, haz clic en el botón Editar en la parte superior derecha de la ventana del MDN. Una vez que el editor se cargue arriba, desplázate hasta la parte inferior de la página, donde puedes encontrar la caja de la etiqueta. Para más detalles sobre la interfaz de marcado, consulte "La caja de etiquetas" en la guía del editor MDN.

    Agregar o actualizar el contenido

    Siempre hay cosas que se pueden agregar o actualizar el MDN. Si se trata de nuevos documentos para una nueva API o la revisión de un API mayor que ha cambiado sutilmente, encontrarás un montón de oportunidades para ayudar.

    Edición de una página existente

    Si has encontrado una página que deseas revisar, simplemente hazclic en el botón Editar en la esquina superior derecha. Esto abrirá el editor WYSIWYG para trabajar en los contenidos de la página. Consulta la guía del editor MDN para obtener más información sobre cómo trabajar con el editor, así como la forma de trabajar con el sistema de macro se utiliza para ayudar a automatizar la construcción y el formato del contenido.

    Hay muchas razones por las que puedes querer editar una página existente:

    • Has encontrado un error o un error de tipografía.
    • Quieres volver a redactar algo para que sea más fácil de entender.
    • El diseño o el formato de la página está desordenado.
    • La API documentada ha cambiado y la documentación necesita una actualización para que coincida con los cambios.
    • Quieres añadir información sobre la diferencia entre el comportamiento de varios navegadores de una API.
    • Si deseas añadir o mejorar un ejemplo de código. Ver {{anch ("Agregar un ejemplo de código")}} más detalles.
    • El artículo está en construcción, o simplemente faltan detalles importantes.

    Agregar una nueva página

    ¡Esto es algo grandioso! Agregar una nueva página a MDN hace que la Web te quiera y quiere abrazarte. Hay varias razones obvias para crear una nueva página, incluyendo documentar una API que aún no está documentada o añadir un nuevo tutorial o guía sobre un tema.

    Hay maneras de crear una nueva página en MDN, una vez que hayas iniciado sesión:

    Haz clic en el enlace "página que falta"
    Mientras navegas por MDN, ocasionalmente encontrarás enlaces a páginas que aún no existen. A menudo, a medida que creamos artículos, se incluyen enlaces a páginas que necesitan ser creadas, aunque no se ha hecho todavía. Esto ayuda a mantener un registro de las cosas que hay que hacer con el tiempo, aunque a veces se necesita algo de tiempo para volver a ellos. ¡Siéntete libre de hacerlo! Simplemente hazclic en estos vínculos y serás llevado directamente al editor de la nueva página.
    Crear una subpágina
    Cerca de la esquina superior derecha de cada artículo aparece "Esta página" en el menú desplegable. En este menú hay una opción "Nueva sub-página". Al hacer clic en esta opción se abre el editor de páginas de una nueva página, cuyo padre en la jerarquía del sitio es la página en la que se ha elegido "Nueva sub-página". Basta con rellenar el título y empezar a escribir el contenido del artículo.
    Crear un clon
    También puede clonar una página existente utilizando la opción "Clonar esta página" en el menú desplegable de "Esta página". Al hacer clic en esta opción se hace una copia de la página actual,  y abre el editor de esta página, cuya página padre es la misma que la actual, y abre el editor de esta página, donde se puede establecer el título, así como editar el contenido de la página. Esta suele ser una buena manera de añadir una nueva página a un área de referencia que ya existe, por ejemplo, ya que te lleva a un ejemplo del diseño del contenido.
    Crear un enlace a una página que aún no existe, haga clic en él
    Esto es un poco un método híbrido. Dado que cada página debería ser referenciada desde alguna parte, podrías empezar por crear un link al nuevo artículo añadiéndolo a una página ya existente, después de salvar a esa página, puedes hacer clic en el enlace que acabas de insertar para abrir un editor del nuevo artículo.

    Nota: Si no estas registrado, recibirás un error 404 al intentar visitar un artículo que no existe, en lugar de que se ofrece un editor de la nueva página.

    Revisión del contenido

    Cuando los escritores añaden o modifican artículos, tienen la opción de marcarlo como pendiente de revisión. Es decir, pueden indicar que alguien debe revisar el artículo para asegurar su calidad. Hay tres clases de revisión:

    Revisión técnica
    Una revisión técnica es cuando alguien con gran conocimiento sobre el tema cubierto por el texto del artículo, lee el artículo y asegura que es técnica y objetivamente correcto. O bien toma notas y las envia junto con el escritor/es (este último es el enfoque preferible).
    Revisión editorial 
    Una revisión editorial es aquella en la que el revisor lee el artículo y corrige errores ortográficos, errores gramaticales, problemas de formato o diseño. Esto también implica garantizar que el artículo coincide con la guía de estilo de MDN.
    Revisión de plantilla
    MDN utiliza macros (a veces llamadas "plantillas") para automatizar la generación de contenidos. Estos son JavaScrips ejecutados en el servidor que ejecutan JavaScript con algunas extensiones que, juntos, llamamos KumaScript. Los usuarios con permisos avanzados de edición de macros pueden realizar revisiones de plantilla para solicitar una doble revisión de su trabajo.

    Los artículos que necesitan ser  revisados tienen uno o ambos de estos banners en la parte superior de la página:

    Screen shot: Review banners

    Tu misión (si decides aceptarla) es leer el artículo y opinar sobre sus contenidos. Obviamente, solo debes revisar artículos técnicos cuya tecnología conozcas correctamente. Y de manera similar, sólo debes llevar a cabo una revisión editorial si dominas el idioma en el que está escrito el artículo.

    Buscar artículos para revisar

    Aunque te puedes tropezar con artículos que necesitan revisión durante la navegación en MDN, también hay una manera de obtener una lista actualizada de artículos pendientes de revisión:

    Revisión rápida

    Si lees el artículo y no hay ningún problema, no tiense que abrir el editor de artículo para marcar el artículo como "revisado". En su lugar, puedes utilizar el apartado de "revisión rápida" en la parte inferior de la página. Algo parecido a esto:

    Screen shot: Quick review box

    Basta con marcar la casilla/s de las revisiones que has realizado y hacer clic en "Confirmar revisiones". Si no estas conectado a MDN, te pedirá que entres. Entonces se actualizarán los banners de revisión del artículo adecuadamente.

    Revisión en el editor

    Por otro lado, tal vez has revisado el artículo, y has tenido que hacer algunos cambios, por lo que estas en el editor. Puede marcar el artículo como revisado también:

    Screen shot: In-editor review box

    En este caso, es necesario marcar las casillas de verificación de las revisiones que has realizado, a continuación, guardar el artículo.

    Agregar un ejemplo de código

    Como un sitio Web cuya función principal es proporcionar la documentación para desarrolladores, el código de ejemplo es una parte vital de lo que hacemos. ¡Añadir o mejorar el código de ejemplo es una gran manera de ayudar a nuestros lectores y una fantástica manera de contribuir si eres programador más que escritor!

    MDN apoya los ejemplos de código on-line, estos ejemplos utilizan HTML, CSS y/o JavaScript que está incrustado en un artículo para representar el contenido en un sandbox {{HTMLElement ("iframe")}} que permite al usuario probar el ejemplo, en tiempo real, sin tener que salir del artículo y del código fuente que muestran cómo funciona el ejemplo.

    Consulta "Utiliza el live-sample" en la guía editor MDN para más detalles.

    Etiquetas y colaboradores del documento

    Contributors to this page: nekside, beatlm
    Última actualización por: beatlm,