Getting started

  • Enlace amigable (slug) de la revisión: Project:Getting_started
  • Título de la revisión: Getting started
  • Id de la revisión: 380295
  • Creada:
  • Creador: Aligo
  • ¿Es la revisión actual? No
  • Comentario

Contenido de la revisión

{{ MDCProjectPagesTOC() }}

Introducción

Ayudar a la  Comunidad de Desarrolladores de Mozilla es tan fácil como usar tu navegador. Si alguna vez has rellenado un formulario web o has usado un área de texto para escribir una entrada en un weblog, tienes todas las destrezas necesarias para comenzar.

Le animamos a ayudar a escribir, editar, revisar y traducir cualquier documentación que encuentres en la wiki. Por favor hágalo con el espíritu de superación cooperativa, y no se decepcione si alguien corrige o mejora sobre sus contribuciones. Todos estamos aquí para tratar de hacer la documentación de Mozilla mucho mejor (salvo para unos pocos spammers desagradables), por lo que la cooperación y la ayuda mutua siempre es animada.

Trabajando con el sitio y la comunidad

La comunidad de documentación es un grupo, compuesto en gran parte de los voluntarios, con el objetivo de proporcionar documentación útil para los usuarios de los productos de Mozilla y la web en general. Siempre estamos dispuestos a ayudar a los nuevos escritores y editores de participar y animar a todos a participar para contribuir a hacer de la documentación lo mejor que puede ser.

Todos somos conscientes de que unirse a un grupo nuevo puede ser difícil por lo que aquí está una lista corta que puede ayudarle.

  • El contenido es más importante que el estilo, la gramática e incluso la ortografía.
  • ¡Está bien cometer errores! Usted puede simplemente editar la página de nuevo para arreglarlo. En el peor de los casos cada cambio puede ser rápida y fácilmente revertido, hasta lo puede hacer por usted mismo.
  • Nadie se va a enojar si usted hace un cambio a la página que ellos crearon. Todos en la comunidad de documentación tienen el mismo objetivo, la mejor documentación posible.
  • No se preocupe si alguien edita poco después la misma página que usted editó. Seguramente es porque su edición apareció en el feed RSS de los cambios recientes y alguien revisando este feed se dió cuenta de que había algo en que podía contribuir.
  • A veces los cambios pueden ser totalmente revertidos. Esto es algo muy raro, y puede ser una buena oportunidad para que usted se presente a otro miembro de la comunidad.
  • Hay gente en muchas zonas horarias diferentes participando en la documentación, por lo que si usted no recibe una respuesta de inmediato a su correo electrónico, o en el IRC por favor sea paciente.
  • Mozilla cuenta con un pequeño personal amable para manejar el proceso de documentación. Ellos revisan todos los cambios realizados y solucionarán cualquier problema de estilo o redacción, ¡así que no seas tímido! Si comete un error, alguien va a ayudarle a arreglarlo.

Tenemos controladores para áreas temáticas específicas. Si se coordina con ellos, ¡su vida como un contribuyente puede ser mejor!

La base

Aquí tienes una guía corta para crear y editar páginas en los wikis MDN. Te invitamos a practicar tus wiki habilidades en el Sandbox.

Editando páginas

Para editar una página, necesitas registrarte usando Persona.

Ahora verás un botón "Editar" en la parte superior de cada página. Al pulsar en este vínculo cambias a modo edición en la página en que te encuentres. En ese momento podrás realizar y previsualizar los cambios que desees, y luego podrás grabarlos en el wiki. Una vez que se hayan grabado tus cambios, podrás verlos inmediatamente en la página. Puedes grabarlos y cerrar el editor pulsando en "Guardar cambios" o grabarlos y seguir trabajando pulsando en "Guardar y continuar editando".

Nota: No podrás guardar tus cambios si tu navegador está configurado para no enviar información de referencia; en Firefox, asegúrate de que la preferencia {{pref("network.http.sendRefererHeader")}} está establecida a su valor por defecto (por el momento es "2"). En caso contrario, te saldrá una página de "Permiso Denegado".

También puedes marcar el subtítulo de una página y hacer click en el botón de edición que aparece a su lado para editar sólo esa sección.

Nota: La edición de una sección se encuentra actualmente desactivada mientras la mejoramos.

Comenzando una página nueva

Si no sabes donde colocar un artículo nuevo, ¡no te preocupes por eso! Ponlo en cualquier lugar, y nosotros lo encotraremos y lo pondremos en el lugar que le corresponda, o lo uniremos a contenido ya existente si fuera el caso y lo más conveniente. Tampoco tienes porqué preocuparte si no te sale perfecto. Tenemos gnomos ayudantes encantados de ayudar a que tu contenido quede perfecto.

Usando el editor WYSIWYG:

  1. Teclea el nombre del artículo que quieres crear en el texto de una página.
  2. Subraya el título y haz click en el icono () en la barra de herramientos del editor. Se abrirá el diálogo del Vínculo de Actualización y el texto subrayado aparecerá en el campo Víncular A.
  3. Inserta "/en-US/docs/" (o el código de otra lengua si estás creando una página traducida) al principio del campo de la URL, y después el título que quieres dar al artículo (no tiene porqué ser el mismo que el texto del vínculo).
  4. Haz click en OK para crear e insertar el vínculo.

El vínculo aparecerá en rojo si la página no existe todavía. Si existe, el vínculo aparecerá en azul. Si quieres crear una página nueva pero el título está ocupado, comprueba primero si tiene sentido ayudar a editar y mejorar la página existente. De lo contrario, busca un título diferente para tu página nueva y crea un vínculo para él.

Cuando quieres añadir contenido a tu página nueva, simplemente haz click en el vínculo rojo que acabas de crear (después de grabar y cerrar el editor) y empieza a escribir. Recuerda usa el botón "Guardar" de la barra de herramientas del editor para guardar tu trabajo (asegúrate de hacerlo a menudo si el artículo es largo).

Guía para nombrar páginas

Para más información sobre la forma de crear y nombrar páginas, ojea nuestra guía para nombrar las páginas.

Marcado Wiki

Kuma, el software desarrollado por Mozilla que se utiliza en la Red de Desarrollo de Mozilla, utiliza HTML como lenguaje de marcas para la documentación. Si deseas ver o editar el contenido HTML, puedes hacerlo con un click en el botón "Fuente" de la barra de herramientas mientras estás en el modo edición. Haz click de nuevo en ese botón para volver al editor WYSIWYG.

Escribiendo, editando y revisando

A continuación hay una introducción algo más extensa para los escritores, editores y revisores de la MDN.

Escritores

La MDN siempre está interesada en contenido nuevo, por lo que te animamos a escribir artículos sobre cualquier tema que aparezca actualmente en el wiki. Contenido nuevo puede ser algo tan sencillo como una página o tan complejo como una guía de programación o de referencia del tamaño de un libro. La cantidad de contenido nuevo con el que contribuyas depende enteramente de ti.

Hay muchos errores en Bugzilla relacionados con la documentación; repasa el artículo sobre Temas de seguimiento de documentación para obtener información sobre cómo encontrar y priorizar los errores de documentación.

Si vas a iniciar un proyecto grande, te sugerimos que te unas a la Comunidad MDN y lo comentes alli en primer lugar por si alguien más estuviera planeando iniciar (o ya hubiera iniciado) un proyecto parecido.

Refer to our writer's guide if you have questions about style or usage policies within the wiki.

Editors

Copy editing is always welcomed in this wiki, particularly to improve or correct writing style, grammar, or spelling. Please see our writer's guide for more information.

You do not need special privileges to edit the wiki; simply sign up for a free MDN account and dive right in!

Reviewers

Technical improvements and review are always welcome. If you are reading through a page and spot a technical error (be it in code or text), please feel free to correct it. If it is a controversial change, make a note in the "talk" page (accessed by clicking the "Talk page" option in the "More options" menu) and leave a note that outlines your reasons for the change.

Writer's guide

We have a writer's guide outlining preferred writing style practices for the MDN wiki. If you have questions about usage and style that are not covered there, I recommend referring to the Economist style guide or, failing that, the Chicago Manual of Style.

We will be expanding the guide over time, so if you have specific questions that are not covered by the writer's guide, please send them to the MDN mailing list or developer documentation lead.

Migrating old documentation

One longer ongoing subproject at the MDN is to migrate all currently existing developer documentation from the mozilla.org web site into the MDN wiki. The procedure is fairly simple:

  1. Pick a document you would like to migrate from the existing content list.
  2. Refer to the page naming guide and decide what the page or pages for that document should be called in the wiki.
  3. Create those pages and migrate the content, marking it up as best you can using the wiki markup reference as a guide.
  4. Delete the item from the existing content list.
  5. Add the item to the needs redirect list.

If you are keen on doing a comprehensive job on this, you will also:

  1. Use our search system to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
  2. Check for external redirects to the original document, and flag those redirects for deletion by adding the "Junk" tag to them.

Localizing the MDN

If you are interested in helping translate the documentation in any of the MDN wikis to another language, simply visit the relevant language's wiki and create or edit pages.

Existing localization projects

Currently the MDN has wikis for the following languages: Català,Čeština, 中文(简体), Deutsch, English, Español, Français, Italiano, 日本語, Magyar, Nederlands, Polski, Português, 한국어, 中文(正體), Русский, Suomi, Türkçe, فارسی.

How to start a new localization project

If you would like to start a new localization project for a language we do not currently have a wiki for, please read the localization projects page and follow the instructions there.

Resolving "edit wars" or other conflicts

If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.

Should no resolution be possible, please bring it to the attention of either (ideally) the MDN mailing list or (as a last resort) the developer documentation lead. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.

Requesting page deletions

Should you create a page by accident or stumble across a page you think should be deleted, mark it as such by adding the "Junk" tag to it.

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

Note: Please do not delete other content or categories from the pages you flag as "Junk".

Joining the MDN community

Mailing list / newsgroup

View MDN forums...

{{ DiscussionList("dev-mdc", "mozilla.dev.mdc") }}

IRC channel

We also hang out on the irc.mozilla.org server in the #devmo channel: #devmo on irc.mozilla.org.

Project lead

The MDN and developer documentation is overseen by Eric Shepherd.

Fuente de la revisión

<p>{{ MDCProjectPagesTOC() }}</p>
<h3 id="Introducci.C3.B3n">Introducción</h3>
<p>Ayudar a la&nbsp; Comunidad de Desarrolladores de Mozilla es tan fácil como usar tu navegador. Si alguna vez has rellenado un formulario web o has usado un área de texto para escribir una entrada en un weblog, tienes todas las destrezas necesarias para comenzar.</p>
<p><strong><span id="result_box" lang="es"><span class="hps">Le animamos a</span> <span class="hps">ayudar a escribir</span><span>, editar</span><span>, revisar y</span> <span class="hps">traducir cualquier</span> <span class="hps">documentación</span> <span class="hps">que encuentres</span> <span class="hps">en la</span> <span class="hps">wiki.</span></span></strong> <span id="result_box" lang="es"><span class="hps">Por favor</span> <span class="hps">hágalo con el</span> <span class="hps alt-edited">espíritu de superación</span> <span class="hps">cooperativa</span><span>, y no</span> <span class="hps">se decepcione</span> <span class="hps">si alguien</span> <span class="hps">corrige o</span> <span class="hps">mejora sobre</span> <span class="hps">sus contribuciones.</span> <span class="hps">Todos estamos</span> <span class="hps">aquí para tratar de</span> <span class="hps">hacer la documentación</span> <span class="hps">de Mozilla</span> <span class="hps atn">mucho mejor (</span><span>salvo para unos</span> <span class="hps">pocos</span> <span class="hps">spammers</span> <span class="hps">desagradables</span><span>)</span><span>, por lo que</span> <span class="hps">la cooperación y la</span> <span class="hps">ayuda mutua</span> <span class="hps">siempre es</span> <span class="hps">animada.</span></span></p>
<h3 id="Trabajando_con_el_sitio_y_la_comunidad">Trabajando con el sitio y la comunidad</h3>
<p><span id="result_box" lang="es"><span class="hps">La comunidad de</span> <span class="hps">documentación</span> <span class="hps">es un grupo,</span> <span class="hps">compuesto en gran parte</span> <span class="hps">de los voluntarios,</span> <span class="hps">con</span> <span class="hps">el objetivo de proporcionar</span> <span class="hps">documentación útil</span> <span class="hps">para los usuarios de</span> <span class="hps">los productos de Mozilla</span> <span class="hps">y la web</span> <span class="hps">en</span> <span class="hps">general.</span> <span class="hps">Siempre estamos dispuestos</span> <span class="hps">a</span> <span class="hps">ayudar a</span> <span class="hps">los nuevos escritores</span> <span class="hps">y editores</span> <span class="hps">de participar y</span> <span class="hps">animar a todos a</span> <span class="hps">participar</span> <span class="hps">para contribuir a hacer de la</span><span class="hps"> documentación</span> <span class="hps">lo mejor</span> <span class="hps">que puede ser.</span></span></p>
<p><span id="result_box" lang="es"><span class="hps">Todos somos conscientes de</span> <span class="hps">que unirse a un</span> <span class="hps">grupo</span> <span class="hps">nuevo puede ser</span> <span class="hps">difícil por lo que</span> <span class="hps">aquí</span> <span class="hps">está</span> <span class="hps">una lista corta</span> <span class="hps alt-edited">que puede</span> <span class="hps">ayudarle.</span></span></p>
<ul>
  <li>El contenido es más importante que el estilo, la gramática e incluso la ortografía.</li>
  <li><span class="st">¡</span>Está bien cometer errores! Usted puede simplemente editar la página de nuevo para arreglarlo. En el peor de los casos cada cambio puede ser rápida y fácilmente revertido, hasta lo puede hacer por usted mismo.</li>
  <li>Nadie se va a enojar si usted hace un cambio a la página que ellos crearon. Todos en la comunidad de documentación tienen el mismo objetivo, la mejor documentación posible.</li>
  <li><span id="result_box" lang="es"><span class="hps">No se preocupe</span> <span class="hps">si</span> <span class="hps">alguien</span> <span class="hps">edita poco después la</span> <span class="hps">misma página</span> <span class="hps">que usted editó</span><span class="hps">.</span></span> <span id="result_box" lang="es"><span class="hps">Seguramente</span> <span class="hps">es porque</span> <span class="hps">su edición</span> <span class="hps">apareció</span> <span class="hps">en el feed RSS de los cambios</span> <span class="hps">recientes</span> <span class="hps">y alguien</span> <span class="hps">revisando</span> <span class="hps">este feed</span> se dió <span class="hps">cuenta de que había</span> <span class="hps">algo en que podía</span> <span class="hps">contribuir.</span></span></li>
  <li><span id="result_box" lang="es"><span class="hps">A veces</span> <span class="hps">los cambios</span> <span class="hps">pueden ser</span> <span class="hps">totalmente</span> <span class="hps">revertidos.</span> <span class="hps">Esto es algo</span> <span class="hps">muy</span> <span class="hps">raro</span><span>, y puede</span> <span class="hps">ser una buena oportunidad</span> <span class="hps">para que usted se presente a</span> <span class="hps">otro miembro de la</span> <span class="hps">comunidad.</span></span></li>
  <li><span id="result_box" lang="es"><span class="hps">Hay gente en</span> <span class="hps">muchas</span> <span class="hps">zonas horarias</span> <span class="hps">diferentes participando en</span> <span class="hps">la documentación,</span> <span class="hps">por lo que si</span> <span class="hps">usted no recibe</span> <span class="hps">una respuesta</span> <span class="hps">de inmediato a su</span> <span class="hps">correo electrónico, o</span> <span class="hps">en el IRC</span> <span class="hps">por favor sea</span> <span class="hps">paciente.</span></span></li>
  <li><span id="result_box" lang="es"><span class="hps">Mozilla</span> <span class="hps">cuenta con</span> <span class="hps">un pequeño personal amable</span> <span class="hps">para manejar el</span> <span class="hps">proceso de documentación.</span> <span class="hps">Ellos revisan</span> <span class="hps">todos los cambios realizados</span> <span class="hps">y</span> <span class="hps">solucionarán</span> <span class="hps">cualquier problema de estilo o </span><span class="hps">redacción</span><span>, </span></span><span class="st">¡</span><span id="result_box" lang="es"><span>así que no</span> <span class="hps">seas tímido!</span> <span class="hps">Si comete un</span> <span class="hps">error</span><span>, alguien va a</span> <span class="hps">ayudarle a arreglarlo</span><span class="hps">.</span></span></li>
</ul>
<p><span id="result_box" lang="es"><span class="hps">Tenemos</span> <span class="hps"><a href="/Project:en/Topic_drivers" title="/Project:en/Topic_drivers">controladores</a> para</span> <span class="hps">áreas temáticas</span> <span class="hps">específicas.</span> <span class="hps">Si</span> se <span class="hps">coordina</span> <span class="hps">con ellos, </span></span><span class="st">¡</span><span id="result_box" lang="es"><span class="hps">su</span> <span class="hps">vida como</span> <span class="hps">un contribuyente</span> <span class="hps">puede ser mejor</span><span>!</span></span></p>
<h3 id="La_base">La base</h3>
<p>Aquí tienes una guía corta para crear y editar páginas en los wikis MDN. Te invitamos a practicar tus wiki habilidades en el <a href="/en-US/docs/Sandbox" title="Sandbox: An area of the wiki for experiments">Sandbox</a>.</p>
<h4 id="Editando_p.C3.A1ginas">Editando páginas</h4>
<p>Para editar una página, necesitas registrarte usando <a href="http://www.persona.org/" title="http://www.persona.org/">Persona</a>.</p>
<p>Ahora verás un botón "Editar" en la parte superior de cada página. Al pulsar en este vínculo cambias a modo edición en la página en que te encuentres. En ese momento podrás realizar y previsualizar los cambios que desees, y luego podrás grabarlos en el wiki. Una vez que se hayan grabado tus cambios, podrás verlos inmediatamente en la página. Puedes grabarlos y cerrar el editor pulsando en "Guardar cambios" o grabarlos y seguir trabajando pulsando en "Guardar y continuar editando".</p>
<div class="note">
  <p><strong>Nota:</strong> No podrás guardar tus cambios si tu navegador está configurado para no enviar información de referencia; en Firefox, asegúrate de que la preferencia {{pref("network.http.sendRefererHeader")}} está establecida a su valor por defecto (por el momento es "2"). En caso contrario, te saldrá una página de "Permiso Denegado".</p>
</div>
<p>También puedes marcar el subtítulo de una página y hacer click en el botón de edición que aparece a su lado para editar sólo esa sección.</p>
<div class="note">
  <p><strong>Nota:</strong> La edición de una sección se encuentra actualmente desactivada mientras la mejoramos.</p>
</div>
<h4 id="Comenzando_una_p.C3.A1gina_nueva">Comenzando una página nueva</h4>
<p>Si no sabes donde colocar un artículo nuevo, <strong>¡no te preocupes por eso! </strong>Ponlo en cualquier lugar, y nosotros lo encotraremos y lo pondremos en el lugar que le corresponda, o lo uniremos a contenido ya existente si fuera el caso y lo más conveniente. Tampoco tienes porqué preocuparte si no te sale perfecto. Tenemos gnomos ayudantes encantados de ayudar a que tu contenido quede perfecto.</p>
<p>Usando el editor WYSIWYG:</p>
<ol>
  <li>Teclea el nombre del artículo que quieres crear en el texto de una página.</li>
  <li>Subraya el título y haz click en el icono (<img alt="" src="/files/3810/link-icon.png" style="width: 29px; height: 28px;" />) en la barra de herramientos del editor. Se abrirá el diálogo del Vínculo de Actualización y el texto subrayado aparecerá en el campo Víncular A.</li>
  <li>Inserta "/en-US/docs/" (o el código de otra lengua si estás creando una página traducida) al principio del campo de la URL, y después el título que quieres dar al artículo (no tiene porqué ser el mismo que el texto del vínculo).</li>
  <li>Haz click en OK para crear e insertar el vínculo.</li>
</ol>
<p>El vínculo aparecerá en rojo si la página no existe todavía. Si <em>existe</em>, el vínculo aparecerá en azul. Si quieres crear una página nueva pero el título está ocupado, comprueba primero si tiene sentido ayudar a editar y mejorar la página existente. De lo contrario, busca un título diferente para tu página nueva y crea un vínculo para él.</p>
<p>Cuando quieres añadir contenido a tu página nueva, simplemente haz click en el vínculo rojo que acabas de crear (después de grabar y cerrar el editor) y empieza a escribir. Recuerda usa el botón "Guardar" de la barra de herramientas del editor para guardar tu trabajo (asegúrate de hacerlo a menudo si el artículo es largo).</p>
<h4 id="Page_naming_guide">Guía para nombrar páginas</h4>
<p>Para más información sobre la forma de crear y nombrar páginas, ojea nuestra <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">guía para nombrar las páginas</a>.</p>
<h4 id="Wiki_markup">Marcado Wiki</h4>
<p><a href="https://github.com/mozilla/kuma" title="https://github.com/mozilla/kuma">Kuma</a>, el software desarrollado por Mozilla que se utiliza en la Red de Desarrollo de Mozilla, utiliza HTML como lenguaje de marcas para la documentación. Si deseas ver o editar el contenido HTML, puedes hacerlo con un click en el botón "Fuente" de la barra de herramientas mientras estás en el modo edición. Haz click de nuevo en ese botón para volver al editor WYSIWYG.</p>
<h3 id="Writing.2C_editing.2C_and_reviewing">Escribiendo, editando y revisando</h3>
<p>A continuación hay una introducción algo más extensa para los escritores, editores y revisores de la MDN.</p>
<h4 id="Writers">Escritores</h4>
<p>La MDN siempre está interesada en contenido nuevo, por lo que te animamos a escribir artículos sobre cualquier <a href="/Special:Tags?tag=All_Categories&amp;language=en" title="Special:Tags?tag=All_Categories&amp;language=en">tema</a> que aparezca actualmente en el wiki. Contenido nuevo puede ser algo tan sencillo como una página o tan complejo como una guía de programación o de referencia del tamaño de un libro. La cantidad de contenido nuevo con el que contribuyas depende enteramente de ti.</p>
<p>Hay muchos errores en Bugzilla relacionados con la documentación; repasa el artículo sobre <a href="/Project:en/Tracking_documentation_issues" title="Project:en/Tracking documentation issues">Temas de seguimiento de documentación</a> para obtener información sobre cómo encontrar y priorizar los errores de documentación.</p>
<p>Si vas a iniciar un proyecto grande, te sugerimos que te unas a la <a href="/Project:en/Getting_started#Joining_the_MDN_community" title="Project:en/Getting_started#Joining_the_MDN_community">Comunidad MDN</a> y lo comentes alli en primer lugar por si alguien más estuviera planeando iniciar (o ya hubiera iniciado) un proyecto parecido.</p>
<p>Refer to our <a href="/Project:en/Writer's_guide" title="Project:en/Writer's_guide">writer's guide</a> if you have questions about style or usage policies within the wiki.</p>
<h4 id="Editors">Editors</h4>
<p>Copy editing is always welcomed in this wiki, particularly to improve or correct writing style, grammar, or spelling. Please see our <a href="/Project:en/Writer's_guide" title="Project:en/Writer's_guide">writer's guide</a> for more information.</p>
<p>You do not need special privileges to edit the wiki; simply <a class="external" href="/Special:Userlogin" title="https://developer.mozilla.org/index.php?title=Special:Userlogin&amp;register=true">sign up for a free MDN account</a> and dive right in!</p>
<h4 id="Reviewers">Reviewers</h4>
<p>Technical improvements and review are always welcome. If you are reading through a page and spot a technical error (be it in code or text), please feel free to correct it. If it is a controversial change, make a note in the "talk" page (accessed by clicking the "Talk page" option in the "More options" menu) and leave a note that outlines your reasons for the change.</p>
<h4 id="Writer's_guide">Writer's guide</h4>
<p>We have a <a href="/Project:en/Writer's_guide" title="Project:en/Writer's_guide">writer's guide</a> outlining preferred writing style practices for the MDN wiki. If you have questions about usage and style that are not covered there, I recommend referring to the <a class="external" href="http://www.economist.com/research/StyleGuide/">Economist style guide</a> or, failing that, the <a class="external" href="http://www.amazon.com/gp/product/0226104036/">Chicago Manual of Style</a>.</p>
<p>We will be expanding the guide over time, so if you have specific questions that are not covered by the <a href="/Project:en/Writer's_guide" title="Project:en/Writer's_guide">writer's guide</a>, please send them to the <a href="/Project:en/Community" title="Project:en/Community">MDN mailing list</a> or <a href="/User:Sheppy" title="User:Sheppy">developer documentation lead</a>.</p>
<h2 id="Migrating_old_documentation">Migrating old documentation</h2>
<p>One longer ongoing subproject at the MDN is to migrate all currently existing developer documentation from the <a class="external" href="http://www.mozilla.org">mozilla.org</a> web site into the MDN wiki. The procedure is fairly simple:</p>
<ol>
  <li>Pick a document you would like to migrate from the <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> list.</li>
  <li>Refer to the <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">page naming guide</a> and decide what the page or pages for that document should be called in the wiki.</li>
  <li>Create those pages and migrate the content, marking it up as best you can using the <a href="/Project:En/MDC_style_guide" title="Project:en/Wiki_Markup_Reference">wiki markup reference</a> as a guide.</li>
  <li>Delete the item from the <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> list.</li>
  <li>Add the item to the <a href="/Project:en/Needs_Redirect" title="Project:en/Needs_Redirect">needs redirect</a> list.</li>
</ol>
<p>If you are keen on doing a comprehensive job on this, you will also:</p>
<ol>
  <li>Use <a href="/Special:Search" title="Search">our search system</a> to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.</li>
  <li>Check for <a href="/Project:en/External_Redirects" title="Project:en/External_Redirects">external redirects</a> to the original document, and flag those redirects for deletion by adding the "Junk" tag to them.</li>
</ol>
<h3 id="Localizing_the_MDN">Localizing the MDN</h3>
<p>If you are interested in helping translate the documentation in any of the MDN wikis to another language, simply visit the relevant language's wiki and create or edit pages.</p>
<h4 id="Existing_localization_projects">Existing localization projects</h4>
<p>Currently the MDN has wikis for the following languages: <a class="external" href="/ca" title="ca">Català</a>,<a class="external" href="/cs" title="cs">Čeština</a>, <a class="external" href="/cn" title="cn">中文(简体)</a>, <a class="external" href="/de" title="de">Deutsch</a>, <a class="external" href="/en" title="en">English</a>, <a class="external" href="/es" title="es">Español</a>, <a class="external" href="/fr" title="fr">Français</a>, <a class="external" href="/it" title="it">Italiano</a>, <a class="external" href="/ja" title="ja">日本語</a>, <a href="/hu" title="hu">Magyar</a>, <a class="external" href="/nl" title="nl">Nederlands</a>, <a class="external" href="/pl" title="pl">Polski</a>, <a class="external" href="/pt" title="pt">Português</a>, <a class="external" href="/ko" title="ko">한국어</a>, <a class="external" href="/zh_tw" title="zh_tw">中文(正體)</a>, <a class="external" href="/ru" title="ru">Русский</a>, <a class="external" href="/fi" title="fi">Suomi</a>, <a class="external" href="/Tr" title="Tr">Türkçe</a>, <a class="external" href="/fa" title="fa">فارسی</a>.</p>
<h4 id="How_to_start_a_new_localization_project">How to start a new localization project</h4>
<p>If you would like to start a new localization project for a language we do not currently have a wiki for, please read the <a href="/Project:en/Localization_Projects" title="Project:en/Localization_Projects">localization projects</a> page and follow the instructions there.</p>
<h2 id="Resolving_.22edit_wars.22_or_other_conflicts">Resolving "edit wars" or other conflicts</h2>
<p>If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.</p>
<p>Should no resolution be possible, please bring it to the attention of either (ideally) the <a href="/Project:en/Community" title="Project:en/Community">MDN mailing list</a> or (as a last resort) the <a href="/User:Sheppy" title="User:Sheppy">developer documentation lead</a>. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.</p>
<h2 id="Requesting_page_deletions">Requesting page deletions</h2>
<p>Should you create a page by accident or stumble across a page you think should be deleted, mark it as such by adding the "Junk" tag to it.</p>
<p>Items tagged as <a class="internal" href="/Special:Tags?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>Note</strong>: Please do not delete other content or categories from the pages you flag as "Junk".</div>
<h2 id="Joining_the_MDN_community">Joining the MDN community</h2>
<h3 id="Mailing_list_.2F_newsgroup">Mailing list / newsgroup</h3>
<p>View MDN forums...</p>
<p>{{ DiscussionList("dev-mdc", "mozilla.dev.mdc") }}</p>
<h3 id="IRC_channel">IRC channel</h3>
<p>We also hang out on the irc.mozilla.org server in the #devmo channel: <a class="link-irc" href="irc://irc.mozilla.org/devmo">#devmo on irc.mozilla.org</a>.</p>
<h3 id="Project_lead">Project lead</h3>
<p>The MDN and developer documentation is overseen by <a class="link-mailto" href="mailto:eshepherd@mozilla.com">Eric Shepherd</a>.</p>
Revertir a esta revisión