From a55b575e8089ee6cab7c5c262a7e6db55d0e34d6 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 14:46:50 +0100 Subject: unslug es: move --- files/es/mdn/contribute/community/index.html | 118 -------------------- .../contribute/howto/crear_cuenta_mdn/index.html | 32 ------ .../plantilla_propiedad/index.html | 120 --------------------- .../howto/etiquetas_paginas_javascript/index.html | 83 -------------- .../howto/remover_macros_experimentales/index.html | 48 --------- .../contribute/howto/revision_editorial/index.html | 54 ---------- .../contribute/howto/revision_tecnica/index.html | 44 -------- .../howto/set_the_summary_for_a_page/index.html | 118 -------------------- .../index.html" | 78 -------------- .../index.html | 106 ------------------ files/es/mdn/contribute/procesos/index.html | 14 --- files/es/mdn/contribute/processes/index.html | 14 +++ files/es/mdn/contribute/tareas/index.html | 18 ---- 13 files changed, 14 insertions(+), 833 deletions(-) delete mode 100644 files/es/mdn/contribute/community/index.html delete mode 100644 files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html delete mode 100644 files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html delete mode 100644 files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html delete mode 100644 files/es/mdn/contribute/howto/remover_macros_experimentales/index.html delete mode 100644 files/es/mdn/contribute/howto/revision_editorial/index.html delete mode 100644 files/es/mdn/contribute/howto/revision_tecnica/index.html delete mode 100644 files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html delete mode 100644 "files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" delete mode 100644 files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html delete mode 100644 files/es/mdn/contribute/procesos/index.html create mode 100644 files/es/mdn/contribute/processes/index.html delete mode 100644 files/es/mdn/contribute/tareas/index.html (limited to 'files/es/mdn/contribute') diff --git a/files/es/mdn/contribute/community/index.html b/files/es/mdn/contribute/community/index.html deleted file mode 100644 index a80a67a1b4..0000000000 --- a/files/es/mdn/contribute/community/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: Trabajando con nuestra comunidad -slug: MDN/Contribute/Community -tags: - - Comunidad - - Guía - - MDN Meta -translation_of: MDN/Community/Working_in_community ---- -
{{MDNSidebar}}
- -

Lo más importante para contribuir a la documentacion de MDN en cualquier escala es saber trabajar como parte de una comunidad. Este artículo brinda tips que te ayudarán a sacarle el máximo partido a tus interacciones con documentadores y el equipo de desarrolladores.

- -

Reglas generales de comportamiento.

- -

Aquí encontraras algunas reglas generales de conducta para cuando trabajes en la comunidad Mozilla.

- - - -

Se cortés

- -

Siempre se diplomático y respetuoso cuando te comuniques con los demás.

- -

Señalando errores cortésmente

- -

Si tu propósito al contactar a alguien es pedirle que haga algo diferente o señalar un error que ha estado cometiendo (especialmente si lo hace repetidamente), comienza tu mensaje con un comentario positivo. Esto suaviza el golpe, por así decirlo, y demuestra que estás tratando de ayudar, en lugar de convertirte en 'el malo de la película'.

- -

Por ejemplo, si un colaborador nuevo ha estado creando muchas páginas sin etiquetas y te gustaría señalar este problema, tu mensaje podría verse así (las cosas que necesita cambiar para cada caso están subrayadas) :

- -
-

Hola, MrBigglesworth, he notado sus contribuciones a la documentación de la API de Wormhole, ¡y es fantástico contar con su ayuda! Me gusta especialmente la forma en que equilibraste tu nivel de detalle con la legibilidad. Dicho esto, sin embargo, podría hacer que estos artículos sean aún mejores y más útiles si agrega las etiquetas correctas a las páginas sobre la marcha.

- -

Consulte la guía de etiquetado de MDN (https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Tag) para obtener más detalles.

- -

Gracias de nuevo y espero sus futuras contribuciones.

-
- -

Intercambiando conocimiento

- -

Al participar en el proyecto MDN, es útil saber lo que está pasando e interactuar con otros los demas miembros de nuestra comunidad. Al hacer esto, puedes compartir ideas, actualizaciones de estado y más. Además contamos con recursos y herramientas para ayudarte a saber que se está haciendo y por quiénes.

- -

Canales de comunicación

- -

Existen varias formas en las que puedes participar con los miembros de la comunidad, ya sea con documentadores o desarrolladores, cada uno de los cuales tiene sus propias reglas de comportamiento.

- -

Discourse (en Inglés)

- -

El foro MDN Discourse es un buen lugar para hacer preguntas generales sobre la contribución a MDN y empezar discusiones.

- -

Chat (en Inglés)

- -

Utiliza el sistema de chat Matrix para contactar con personas en tiempo real. Los miembros del personal de MDN están disponibles en la sala de MDN Web Docs  y están activos durante los días laborales en Europa y América del Norte. Explora las otras salas de chat para encontrar personas involucradas en temas que te interesen.

- -

GitHub (en Inglés)

- -

Si encuentras un problema en MDN, o deseas hacer una pregunta, ¡puedes presentar un problema en nuestro repo de GitHub! Luego serán evaluados y procesados en algún momento en el futuro.

- -

Bugzilla

- -

Cuando escribes documentacion para cubrir los cambios implementados como consecuencia de un error en Bugzilla, podrás interactuar en ocasiones con las personas involucradas en estos errores. ¡Asegurate de tener guía de comportamiento Bugzilla en mente todo el tiempo!

- -

Email

- -

En ocasiones, el intercambio de correo electrónico privado entre tú y una o más personas es el camino a seguir, si tienes su dirección de correo electronico.

- -
-

Nota: Como regla general, si alguien a publicado su email en los documentos sobre la tecnología que estás documentando, te ha dado su correo, o es un correo muy conocido, un correo es un buen medio para realizar el "primer contacto". Si tienes que buscarlo, probablemente deberías intentar obtener permiso para Discourse o una lista de correo primero, a menos que hayas agotado todos los demás recursos para ponerte en contacto.

-
- -

Estado del contenido

- -

Tenemos varias herramientas útiles que te proporcionan información sobre el estado de la documentación.

- -
-
Tablero de revisión
-
Esta es una herramienta fantástica para la revisión de los cambios realizados  en el contenido de MDN. Puedes ver el historial, seleccionar un rango de tiempo para ver, y filtrar por cosas como la configuración regional, nombre del contribuyente, y tema. Una vez que estés viendo la serie de revisiones, puedes ver los cambios realizados en cada una de ellas, abrir rápidamente la pagina, ver el historial completo o revertir cambios  (si tienes los permisos).
-
Visión general del estado de la documentación
-
Nuestra pagina de vista del estado de documentación provee una lista de todas las áreas de MDN que se han configurado para el seguimiento de estado, con información de algunas páginas y los diferentes trabajos que se necesitan. Haz click en un área en particular y mira un listado de los contenidos que necesitan trabajo, como páginas que no tienen etiquetas, o etiquetas que requieren cierto trabajo. Puedes ver una lista de páginas que no se han actualizado hace mucho tiempo, están desactualizados, o una lista de los errores encontrados y cómo han afectado a la documentación en esa área.
-
Los planes del proyecto de documentación
-
Tenemos una serie de proyectos de escritura que se encuentran en etapa de planificación, o son grandes y se encuentran en curso, para los que se han escrito los documentos de planificación y así tener un registro de lo que tenemos que hacer.
-
MDN Taiga (en Inglés)
-
Los redactores del personal de MDN utilizan una herramienta llamada Taiga para gestionar proyectos de documentación actuales y futuros. Puedes echar un vistazo para ver lo que estamos haciendo y cómo va, también puedes ver qué proyectos nos gustaría que sucedan pronto. Algunos de ellos serán asumidos por escritores del personal, ¡pero no dudes en hacerte cargo de uno si lo deseas! Para obtener más información sobre los procesos ágiles que sigue el equipo de MDN, consulta nuestra página de procesos en la  wiki de Mozilla.
-
- -

La comunidad de desarrollo

- -

Posiblemente las relaciones más importantes para desarrollar y mantener, como miembro de la comunidad de la escritura MDN, son las que mantengas  con los desarrolladores. Ellos crean el software que estamos desarrollando, pero también son la fuente más útil de información que tenemos. Es crucial que mantengamos buenas relaciones con los desarrolladores, ¡así es más probable que respondan a tus preguntas de forma rápida, precisa y adecuada!

- -

Además, representas a la comunidad de escritura MDN. Por favor, ayuda a asegurar que mantengamos nuestra excelente relación de trabajo con el equipo de desarrollo haciendo que cada interacción que tengan con el equipo de escritura sea la mejor posible.

- -

En una nota relacionada, una gran manera de encontrar a la persona adecuada para hablar es mirar la lista de propietarios del módulo.

- -

La comunidad de escritura

- -

La comunidad de la escritura es grande. Mientras que el número de contribuyentes frecuentes o de gran escala es relativamente pequeño, hay muchas docenas o cientos de personas que contribuyen al menos de vez en cuando. Afortunadamente, se trata de personas impresionantes, con un amor genuino por la Web, Mozilla, y/o la documentación, además, la interacción con ellos es casi siempre bastante fácil.

- -

Mira el articulo Únete a la comunidad para mas información acerca de la comunidad MDN.

- -

 El lugar donde más frecuentemente podrás interactuar directamente con otros escritores es en el foro Discourse.

- -

Teniendo en cuenta la {{anch("Guía general de comportamiento")}} , usted notará que las cosas salen bien por lo general.

- -

Mira también

- - diff --git a/files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html b/files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html deleted file mode 100644 index 8e254f6ac0..0000000000 --- a/files/es/mdn/contribute/howto/crear_cuenta_mdn/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Cómo crear una cuenta MDN -slug: MDN/Contribute/Howto/Crear_cuenta_MDN -tags: - - Cuenta - - GitHub - - Perfil - - Persona - - Principiante - - account -translation_of: MDN/Contribute/Howto/Create_an_MDN_account ---- -
{{MDNSidebar}}
- -

Para editar contenido en MDN, necesitas un perfil MDN. No es necesario un perfil si solo quieres buscar y leer los documentos de MDN:

- -
    -
  1. En la parte superior de cada página en MDN encontrarás el botón de  Registrarse. Pasa el puntero del mouse por ahí (o toca sobre este botón si estás con un dispositivo móvil) para mostrar una lista de servicios de autenticación que son permitidos para registrarse en MDN.
    2. -
  2. Selecciona el servicio para registrarte. Actualmente, solo GitHub y Gmail están disponibles. Ten en cuenta que si seleccionas GitHub, un enlace a tu perfil de GitHub será incluido en tu página de perfil público de MDN.
    3. -
  3. Sigue las indicaciones de GitHub o de Gmail para conectar tu cuenta a MDN.
    4. -
  4. Una vez autenticado el servicio te retorna a MDN, se te pedirá que ingreses un nombre de usuario y una dirección de correo electrónico. Tu nombre de usuario será mostrado públicamente para darte el crédito del trabajo que has hecho. No utilices tu dirección de correo electrónico como nombre de usuario.
    5. -
  5. Click en Crear mi perfil MDN.
    6. -
  6. Si la dirección de correo electrónico que has especificado en el paso 4 no es el mismo que has utilizado  con el servicio de autenticación, revisa tu correo y dale click en el enlace en el correo de confirmación que se te envió.
    7. -
- -

¡Listo! ¡Ya tienes una cuenta MDN y puedes editar páginas inmediatamente!

- -

Puedes dar clic en tu nombre en la parte superior de cualquier página de MDN para ver tu perfil público. Desde ahí, puedes editar, hacer cambios o adicionar información en tu perfil.

- -
-

Nota: Los nuevos nombres de usuario no pueden contener espacios ni el carácter "@". Ten en cuenta que tu nombre de usuario será mostrado públicamente para identificar los trabajos que hayas hecho!

-
diff --git a/files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html b/files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html deleted file mode 100644 index a0bdd5267f..0000000000 --- a/files/es/mdn/contribute/howto/document_a_css_property/plantilla_propiedad/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: Plantilla de página para propiedades CSS -slug: MDN/Contribute/Howto/Document_a_CSS_property/Plantilla_propiedad -translation_of: MDN/Contribute/Howto/Document_a_CSS_property/Property_template ---- -
{{MDNSidebar}}
Esta es una página plantilla para las propiedades de CSS. Por favor utilice esto como una plantilla base cuando vaya a crear una nueva página para una propiedad de CSS. 
-Los comentarios en cursiva son información  sobre cómo usar parte de la plantilla
- -
{{CSSRef}}
- -
Agregue el encabezado no estándar si la propiedad no esta en el estándar. En la sección de resumen en una nota, describa como lograr su efecto usando tecnologías estándares de la Open Web.
- -
{{non-standard_header}}
- -
 
- -
Agregue el encabezado experimental si a su juicio es probable que el comportamiento de la propiedad cambie en el fututo, por ejemplo; debido a especificaciones muy inmaduras o implementaciones incompatibles.
- -
{{SeeCompatTable}}
- -

 

- -

Desripción de la propiedad. Debe comenzar por "La propiedad xyz CSS " seguido de una descripción de una oración. El primer párrafo de esta introducción se utilizará por defecto como la descripción de la página.

- -

{{note("Para cualquier mensaje especial")}} Pero no agregue varias notas. Estas deben ser realmente importantes, ¡o ser parte de la decripción!

- -

{{cssinfo}}

- -

Sintaxis

- -
/* Valores de palabras clave */
-property: value1;
-property: value2;
-
-/* <longitud> valores */
-property: 12.8em;   /* Una longitud válida */
-
-/* Valores globales */
-property: inherit;   <-- Para recordar que son valores posibles
-property: initial;
-property: unset;
-
- -

La segunda parte es una traducción simple de lo que dice la sintaxis formal. Está dirigido a usuarios de nivel medio que no comprenderán bien la sintaxis formal.

- -

Valores

- -

Cada elemento de la sintaxis formal debe ser explicado

- -
-
valor_1
-
Es una palabra clave que significa...
-
valor_2 {{ Non-standard_inline() }} {{experimental_inline()}}
-
Es una palabra clave que significa
-
- -

Sintaxis formal

- -

La sintaxis formal debe ser tomada de la especificación y agregarse a la plantilla de 'CSSData'. Es una herramienta importante para obtener información precisa de la sintaxis para los usuarios avanzados.

- -
{{csssyntax}}
- -

Ejemplos

- -

Agregue esto solo si hay un ejemplo. Sin enlace roto aqui.

- -

CSS

- -
elementName {
-  property: value;
-  estoes: "ejemplo";
-  dream: 10000000mm;
-  amor: "peligro";
-}
- -

HTML

- -
<elementName>foo bar</elementName>
- -

Resultado

- -

{{EmbedLiveSample("Examples")}}

- -

Especificaciones

- -

Utilizar exclusivamente esta tabla estándar. Coloque la especificación más antigua en la parte inferior. Use las plantillas SpecName() para el nombre y Spec2() para el estado. De esa manera, cuando la especificación progresa en el estándar, o se mueve, el contenido de la tabla se adaptará automáticamente.

- - - - - - - - - - - - - - - - - - - - - -
EspecificaciónEstadoComentario
{{SpecName("CSS3 Animations", "#fake-link", "fake-value")}}{{Spec2("CSS3 Animations")}}Sin cambios desde CSS 2.1
{{SpecName("CSS2.1", "#fake-link", "fake value")}}{{Spec2("CSS2.1")}}Definición inicial
- -

Compatibilidad del navegador

- -

(Ver Tablas de compatibilidad para más información)

- -

Ver también

- - diff --git a/files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html b/files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html deleted file mode 100644 index 42edc03ff0..0000000000 --- a/files/es/mdn/contribute/howto/etiquetas_paginas_javascript/index.html +++ /dev/null @@ -1,83 +0,0 @@ ---- -title: Cómo etiquetar páginas Javascript -slug: MDN/Contribute/Howto/Etiquetas_paginas_javascript -tags: - - Etiquetas - - JavaScript -translation_of: MDN/Contribute/Howto/Tag_JavaScript_pages ---- -
{{MDNSidebar}}

Etiquetar consiste en agregar meta-información (o información adicional) a las páginas para que el contenido relacionado pueda agruparse, por ejemplo en la herramienta de búsqueda.

- - - - - - - - - - - - - - - -
¿Dónde hay que hacerlo?Dentro de páginas específicas relacionadas con JavaScript que aún no tengan etiquetas
¿Qué necesitas saber para hacer esta tarea? -
    -
  • Conocimiento básico de código JavaScript, como saber qué es un método o una propiedad.
    • -
-
¿Cuáles son los pasos para hacerla? -
    -
  1. Elige una de las páginas del la lista que se encuentra en el enlace anterior.
    2. -
  2. Haz Click en el enlace del artículo para cargar la página.
    3. -
  3. Una vez cargada la página, haz click en el botón EDIT cerca de la parte superior ( esto te coloca en el editor MDN).
    4. -
  4. Cómo mínimo se debería agregar la etiqueta JavaScript. Aquí hay otras etiquetas que se pueden agregar:
    5. -

  5. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    TagWhat pages to use it on
    Methodmétodos
    Propertypropiedades
    prototypeprototipos
    Object type namemétodos de un objeto; por ejemplo String.fromCharCode debería llevar la etiqueta String
    ECMAScript6 and Experimentalcaracterísticas agregadas en una nueva versión ECMAScript
    Deprecatedcaracterísticas desaprobadas (cuyo uso está desaconsejado pero aún tiene soporte)
    Obsoletecaracterísticas obsoletas (que ya no tienen soporte en los navegadores modernos)
    othersVer Mestándares de etiquetado MDN para otras etiquetas posibles a aplicar
    -
    6. -
  6. Guarda con un comentario.
    7. -
  7. ¡Y Listo!
    8. -
-
-

 

diff --git a/files/es/mdn/contribute/howto/remover_macros_experimentales/index.html b/files/es/mdn/contribute/howto/remover_macros_experimentales/index.html deleted file mode 100644 index 25ee6439cd..0000000000 --- a/files/es/mdn/contribute/howto/remover_macros_experimentales/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Cómo y cuándo eliminar macros "experimentales" -slug: MDN/Contribute/Howto/Remover_Macros_Experimentales -tags: - - Experimental - - Guía - - MDN Meta - - Macros -translation_of: MDN/Contribute/Howto/Remove_Experimental_Macros ---- -
{{MDNSidebar}}{{IncludeSubnav("/en-US/docs/MDN")}}
- -

Las páginas en MDN pueden incluirmacrosKumaScriptpara notificar a los lectores que una característica es experimental y aún no está estandarizada. Sin embargo, algún elementos experimental pueden estandarizarse y sin embargo su página todavía no refleja este cambio. Puedes ayudar a mejorar MDN revisando las páginas que contienen estas macros "experimentales" y eliminando las macros de los elementos que ya no son experimentales.

- -

Las macros en cuestión son {{TemplateLink("experimental_inline")}} para marcar un elemento mencionado en una página, y {{TemplateLink("SeeCompatTable")}} para marcar toda la página.

- -
-

Advertencia: ya no recomendamos usarSeeCompatTable. Ahora se espera que todos los datos sobre compatibilidad se presenten dentro de la tabla de compatibilidad del navegador y cualquier nota al pie de página.

-
- -

Aquí está la definición de experimental del artículo MDN Definitions and Conventions:

- -

¿Dónde debe hacerse esta tarea?

- -

Páginas en las siguientes listas:

- -
-
- -
-
¿Qué necesitas saber para hacer la tarea?
-
Conocimiento del estado de estandarización o implementación del elemento relevante.
-
¿Cuáles son los pasos para hacer la tarea?
-
-
    -
  1. Revise la página para ver con qué elemento o elementos está asociada la macro.
    2. -
  2. Determine si cada elemento sigue siendo experimental o no. La tabla de compatibilidad en la página puede ser más actual que las macros; También puede probar utilizando el elemento en varios navegadores.
    3. -
  3. Si un elemento ya no es experimental, elimine la llamada de macro "experimental" asociada a él. (Nota: un elemento en una página de resumen que tiene la macro {{TemplateLink ("experimental_inline")}} al lado suele ser un enlace a una página de referencia completa, que contiene la macro {{TemplateLink ("SeeCompatTable")}}.
    4. -
  4. Guarde la página con un comentario sobre lo que hizo.
    5. -
  5. Si ha eliminado todas las macros "experimentales" de una página (para las macros en línea, puede eliminar solo algunas de ellas), fuerce una actualización (Mayús + Actualizar) en la página de resultados de búsqueda relevante (vinculada anteriormente) para asegurarse de que la lista esté actualizado.
    6. -
-
-
diff --git a/files/es/mdn/contribute/howto/revision_editorial/index.html b/files/es/mdn/contribute/howto/revision_editorial/index.html deleted file mode 100644 index 454da031a0..0000000000 --- a/files/es/mdn/contribute/howto/revision_editorial/index.html +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Cómo hacer una revisión editorial -slug: MDN/Contribute/Howto/revision_editorial -tags: - - Cómo hacerlo - - Documentación - - Guía - - Revisiones -translation_of: MDN/Contribute/Howto/Do_an_editorial_review ---- -
{{MDNSidebar}}
- -

La revisión editorial consiste en reparar errores tipográficos y de ortografía, gramática, o errores de uso en un artículo. No todos los contribuyentes son expertos en escribir en español, pero gracias a su conocimiento han contribuído en los artículos en enorme cantidad, los cuales necesitan correcciones y revisiones. Esto se hace en la revisión editorial.

- - - - - - - - - - - - - - - - - - - - -
¿Cuál es la tarea? Verificar y corregir la gramática, ortografía y contexto de los artículos.
¿Dónde hay que hacerla?Dentro de artículos específicos que están marcados como que requieren una revisión editorial.
¿Qué necesitas saber para hacer la tarea?Necesitas tener buen manejo de la gramática española y su ortografía.
¿Cuáles son los pasos para hacerlo? -
    -
  1. Elige un artículo: -
      -
    1. Ve a la lista de artículos que necesitan revisión editorial.  Esto lista todas las páginas para las que se solicitó una revisión editorial.
      2. -
    2. Elige una página que tenga un título en español y cuya ruta no empiece con Template:.
      3. -
    3. Haz click en el enlace del artículo para cargar la página.
      4. -
    -
    2. -
  2. Una vez cargada la página, haz click en el boton editar (EDIT) de la parte superior; esto te lleva al editor MDN. No dudes en cambiar a una página diferente si la primera que eliges no te conviene.
    3. -
  3. Corrige todos los errores tipográficos y ortográficos, gramática, o de uso que veas.
    4. -
  4. Ingresa un Comentario Revisión en la parte superior del artículo; algo como "Revisión editorial: errores de tipografía, gramática y ortografía reparados."
    5. -
  5. Haz click en el boton GUARDAR LOS CAMBIOS (SAVE CHANGES).
    6. -
  6. Una vez que el artículo corregido aparezca en la pantalla después de haberse cerrado el editor, marca la entrada Editorial al costado debajo de Se han solicitado las siguientes revisiones (The following reviews have been requested) y haz click en ENVIAR REVISION (SUBMIT REVIEW).
    7. -
  7. -

    ¡Listo!

    -
    8. -
-
- -

 

diff --git a/files/es/mdn/contribute/howto/revision_tecnica/index.html b/files/es/mdn/contribute/howto/revision_tecnica/index.html deleted file mode 100644 index e1fc2d5d5a..0000000000 --- a/files/es/mdn/contribute/howto/revision_tecnica/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: Cómo hacer una revisión técnica -slug: MDN/Contribute/Howto/revision_tecnica -translation_of: MDN/Contribute/Howto/Do_a_technical_review ---- -
{{MDNSidebar}}

La revisión técnica consiste en revisar la precisión técnica y lo completo que se encuentra un artículo, y corregirlo si es necesario. Si un escritor de un artículo quiere que alguien más chequee su contenido técnico, debe marcar la casilla "Revisión Técnica" (Technical review) al editarlo. A menudo el escritor contacta a un ingeniero específico para desempeñar la revisión técnica, pero cualquiera con habilidad técnica en el tema puede hacerla.

- -

Este artículo describe cómo hacer para ejecutar una revisión técnica, ayudando así a asegurar que el contenido de MDN es preciso.

- - - - - - - - - - - - - - - - -
¿Dónde hay que hacerla?En artículos específicos marcados requiriendo revisión técnica.
¿Qué necesitas saber para hacer la tarea? -
    -
  • Conocimiento experto del tema del artículo que estás revisando.
    • -
  • Habilidad para editar un artículo wiki en MDN.
    • -
-
¿Cuáles son los pasos para hacerlo? -
    -
  1. Vé a la lista de páginas que necesitan revisiones técnicas. Ésta lista todas las páginas para las cuales se solicitó revisión técnica.
    2. -
  2. Elige una página con cuyo tema estés muy familiarizado.
    3. -
  3. Haz click en el enlace del artículo para cargar la página.
    4. -
  4. Una vez cargada la página, haz click en el botón  EDITAR (EDIT) de la parte superior; esto te lleva al editor MDN. No dudes en cambiar a una página diferente si la primera que eliges no te conviene.
    5. -
  5. Mientras lees el artículo, corrige cualquier información técnica que no esté correcta y agrega cualquier información importante que falte.
    6. -
  6. Ingresa un comentario al pie del artículo que describa lo que hiciste, como "Revisión técnica completa". Si corregiste la información, incluye eso en tu comentario, por ejemplo "Revisión Técnica: descripciones de parámetros arregladas".
    7. -
  7. Haz click en el botón GUARDAR LOS CAMBIOS (SAVE CHANGES).
    8. -
  8. Una vez que corregiste el artículo aparece en la pantalla después que el editor se haya cerrado, chequea la entrada Técnica al costado, debajo de Las siguientes revisiones han sido solicitadas (The following reviews have been requested) y haz click en ENVIAR REVISIÓN (SUBMIT REVIEW).
    9. -
  9. Y listo!
    10. -
-
- -

 

diff --git a/files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html b/files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html deleted file mode 100644 index 26f62b04a2..0000000000 --- a/files/es/mdn/contribute/howto/set_the_summary_for_a_page/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: Cómo colocar el resumen de una página -slug: MDN/Contribute/Howto/Set_the_summary_for_a_page -tags: - - Documentación - - Resumen - - SEO - - Summary - - primeros pasos -translation_of: MDN/Contribute/Howto/Set_the_summary_for_a_page ---- -
{{MDNSidebar}}
- -
-
{{IncludeSubnav("/en-US/docs/MDN")}}
- -
-

En este artículo te mostraremos cómo configurar el resumen SEO (también conocido como la descripción o simplemente como el resumen) de un artículo en el sitio de MDN Web Docs. El resumen se usa de varias maneras:

- -
    -
  • Lo utilizan Google y otros motores de búsqueda para ayudar a catalogar e indexar páginas.
    • -
  • Los motores de búsqueda muestran el resumen en las páginas de resultados de búsqueda para ayudar a los lectores a elegir la página que mejor se adapte a sus necesidades.
    • -
  • Los menús de MDN a menudo muestran el resumen debajo del título del artículo para ayudar a los usuarios a encontrar la información que buscan.
    • -
  • Los enlaces en MDN tienen información sobre las herramientas del resumen, para proporcionar una visión rápida a los usuarios sin tener que hacer clic en el artículo en sí.
    • -
- -

Por lo tanto, el resumen debe ser un texto que tenga sentido tanto en el contexto del artículo como cuando se presenta solo en otros contextos. Se debe tener en cuenta la guía de estilo de escritura MDN al escribir el texto de resumen.

-
-
- -

El resumen predeterminado

- -

Las páginas para las que no se ha establecido un resumen toman como resumen el texto completo del primer bloque de {{Glossary("HTML")}} que parezca tener contenido de texto en lugar de un título. Sin embargo, este texto puede no se el mejor para usar por varias razones:

- - - -

Por esto es mejor establecer explícitamente el resumen de la página, para ayudar a garantizar que el resumen sea lo más útil posible.

- -

Estableciendo el resumen

- -

Veamos cómo configurar el resumen de una página.

- -

¿Cuál es la tarea?

- -

Marcar el texto dentro de una página que debe usarse como resumen en otros contextos; Si el texto apropiado no está disponible, esta tarea puede incluir escribir una pequeña cantidad de texto apropiado.

- -

¿Dónde necesita ser hecho?

- -

En las páginas que carecen de un resumen, las que tengan un resumen que no sea útil, o que tengan un resumen que no cumpla innecesariamente con las pautas recomendadas.

- -

¿Qué necesitas saber para hacer la tarea?

- -

Necesitas saber usar el editor MDN. También necesitas buenas habilidades de escritura y familiaridad con el tema de la página a resumir.

- -

¿Cuáles son los pasos para hacerlo?

- -
    -
  1. Elige una página a la que quieras colocarle un resumen: -
      -
    1. En la página de estado de la documentación MDN, haz clic en el enlace debajo de  Secciones (Sections) para un tema en el que tengas conocimientos (por ejemplo, HTML).
      -
      2. -
    2. En la página de estado de la documentación del tema, haz clic en la cabecera Páginas (Pages) de la tabla Resumen (Summary). Esto te va a llevar a un índice de todas las páginas en esa sección del tema. Muestra los enlaces de la página en la columna izquierda y las etiquetas y resúmenes en la columna derecha.
      -
      3. -
    3. Elige una página en la que falte el resumen o que tenga uno pobre.
      -
      4. -
    4. Haz clic en el enlace para ir a esa página.
      5. -
    -
    2. -
  2. Haz clic en Editar (Edit) para abrir la página en el editor MDN.
    3. -
  3. Busca una oración o dos que anden como resumen fuera del contexto. Si fuera necesario, edita el contenido existente para crear o modificar las oraciones y así obtener un buen resumen.
    4. -
  4. Selecciona el texto a usar como resumen.
    5. -
  5. En el widget Estilos (Styles) de la barra de herramientas del editor selecciona Resumen SEO (SEO Summary). (En el código fuente de la página, esto crea un elemento  {{HTMLElement("span")}} con class="seoSummary" encerrando el texto seleccionado).
    -
    6. -
  6. Guarda tus cambios con un comentario de revisión como "Coloqué el resumen a la página".
    7. -
- -

Elaboración de un buen resumen

- -

El resumen se utiliza en diversos escenarios entre los que se pueden incluir:

- - - -

Es importante tener presentes estos escenarios mientras se crea un resumen. Para garantizar que el resumen funcione bien en todas estas situaciones, esfuérzate por ceñirte a las pautas que se indican a continuación.

- -
-

Nota: a menos que se indique específicamente lo contrario, estas son orientaciones, no reglas rígidas y rápidas. Aunque debes esforzarte por cumplir estas directrices, en ocasiones se presentan excepciones que no se pueden evitar.

-
- - - -

Piensa en el resumen como si fuera una especie de {{interwiki("wikipedia", "blurb")}} en el interior de la cubierta o la contracubierta de un libro. Este texto corto tiene que captar la atención del lector rápidamente y animarle a seguir leyendo.

- -

Puede ser un poco complicado redactar un resumen que funcione bien tanto para las páginas de resultados de los motores de búsqueda como dentro del propio texto del artículo, pero en el momento MDN no ofrece una forma de crear un resumen SEO separado del contenido de la página, de modo que haz tu mejor esfuerzo.

- -

Ver también

- - diff --git "a/files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" "b/files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" deleted file mode 100644 index 4ba8e4e4e4..0000000000 --- "a/files/es/mdn/contribute/howto/usar_barras_laterales_de_navegaci\303\263n/index.html" +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Cómo usar las barras laterales de navegación -slug: MDN/Contribute/Howto/Usar_barras_laterales_de_navegación -translation_of: MDN/Contribute/Howto/Use_navigation_sidebars ---- -

{{MDNSidebar}}{{Draft}}

- -

La navegación en MDN se realiza frecuentemente usando barras laterales que listan otros artículos en una serie así como contenido relacionado tanto en la misma suite de documentación como en otras áreas de MDN. Las barras laterales de MDN no se crean automáticamente; para incluirlas en la página, es necesario crear y utilizar una macro de algún tipo. En este artículo, revisaremos el proceso de creación de las macros de MDN en la barra lateral y cómo utilizarlas en un artículo.

- -

Macros actuales de las barras laterales de MDN

- -

MDN ya tiene varias macros para crear barras laterales. La mayoría son específicas para secciones particulares de MDN, mientras que otras tienen la intención de crear barras laterales genéricas para áreas de documentación que de otra manera no tendrían ninguna.

- -
-
{{TemplateLink("AddonSidebar")}}
-
Inserts a sidebar for navigating the add-ons documentation; this is primarily content about creating browser extensions.
-
{{TemplateLink("APIRef")}}
-
Inserts a sidebar used within API interface reference pages and subpages.
-
{{TemplateLink("CanvasSidebar")}}
-
Inserts a sidebar used within the HTML/DOM Canvas documentation.
-
{{TemplateLink("DefaultAPISidebar")}}
-
Inserts a default sidebar that can be used on the API overview page of an API that doesn't have its own sidebar type.
-
{{TemplateLink("FirefoxSidebar")}}
-
Inserts a sidebar used on the documentation that's specific to Firefox.
-
{{TemplateLink("GamesSidebar")}}
-
Inserts a sidebar for navigating MDN's content about developing games using web technologies.
-
{{TemplateLink("HTMLSidebar")}}
-
Inserts the sidebar used within MDN's HTML documentation.
-
{{TemplateLink("HTTPSidebar")}}
-
Inserts a sidebar for use on pages within MDN's HTTP documentation.
-
{{TemplateLink("JSSidebar")}}
-
Inserts a sidebar for use within the JavaScript documentation.
-
{{TemplateLink("LearnSidebar")}}
-
Inserts the Learning Area sidebar.
-
{{TemplateLink("MDNSidebar")}}
-
Inserts a sidebar for navigating MDN's "meta-documentation;" that is, documentation about using and editing the MDN Web Docs site itself. You can actually see that macro in use on this page.
-
{{TemplateLink("ServiceWorkerSidebar")}}
-
Inserts a sidebar for use within documentation about Service Workers.
-
{{TemplateLink("SpiderMonkeySidebar")}}
-
Inserts a sidebar for use on pages documenting SpiderMonkey, Mozilla's JavaScript engine.
-
{{TemplateLink("ToolsSidebar")}}
-
Inserts a sidebar listing pages about Firefox developer tools.
-
{{TemplateLink("WebAssemblySidebar")}}
-
Inserts a sidebar containing links related to WebAssembly.
-
{{TemplateLink("WebExtAPISidebar")}}
-
Inserts a sidebar used to navigate the API reference documentation about browser e3dtensions (WebExtensions).
-
{{TemplateLink("WebGLSidebar")}}
-
Inserts a sidebar that provides navigation of WebGL-related content.
-
{{TemplateLink("WebRTCSidebar")}}
-
Inserts a sidebar whose contents provide navigation of WebRTC documentation on MDN.
-
{{TemplateLink("XSLTRef")}}
-
Inserts a sidebar with documentation for XSLT, EXSLT and XPath.
-
- -

Using sidebars

- -

To add a sidebar to a page, find the right macro, then, on the page on to which you want to insert the sidebar, click the "Edit" button. Add to the page a {{HTMLElement("p")}} block whose contents are simply the call to the macro. Once there, you can add the macro call. Typically, sidebar macros don't require any parameters, so you can just do, for example:

- -
<p>\{{MDNSidebar}}</p>
- -

Usually, you should do this as the first line of the document. In some documents, it's been done at the bottom instead. This works fine, but for the sake of consistency, try to place it at the top.

- -

If there's already a {{HTMLElement("p")}} block with macro calls at the top of the page, such as those that create banners like \{{Non-standard_Header}}, you can put the sidebar macro inside the same {{HTMLElement("p")}}, like this:

- -
<p>\{{HTTPSidebar}}\{{Non-standard_Header}}</p>
- -

Creating sidebars

- -

details coming

- -

Talk about {{TemplateLink("SidebarUtilities")}}.

- -

There are some macros that can be used to help build sidebars:

- -
-
{{TemplateLink("ListSubpagesForSidebar")}}
-
Creates a tree of links structured for use in a sidebar, using the subpages of the specified page.
-
diff --git a/files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html b/files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html deleted file mode 100644 index 05d72dd7f7..0000000000 --- a/files/es/mdn/contribute/howto/write_an_article_to_help_learn_about_the_web/index.html +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: Cómo escribir un artículo para ayudar a las personas a aprender sobre la Web. -slug: MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web -tags: - - Aprender - - Como - - Guía - - MDN Meta -translation_of: MDN/Contribute/Howto/Write_an_article_to_help_learn_about_the_Web ---- -
{{MDNSidebar}}
- -

El área de aprendizaje de MDN es nuestro hogar para artículos que presentan conceptos web a nuevos desarrolladores. Debido a que su contenido está dirigido principalmente a principiantes, es un gran lugar para compartir tus conocimientos y ayudar a los recién llegados a conocer la web. Es importante asegurarse de que los nuevos desarrolladores puedan seguir este contenido, por lo que le prestamos especial atención.

- -

Este artículo explica cómo escribir páginas para el Área de aprendizaje.

- -

Cómo escribir un artículo en el Área de aprendizaje

- -

Para comenzar a aportar tu conocimiento, simplemente haz clic en el botón verde grande, luego sigue los cinco pasos a continuación. Si estás buscando ideas, echa un vistazo al tablero de Trello de nuestro equipo.

- -
Escribe un nuevo artículo
- -

Este artículo podría no terminar exactamente en el lugar correcto, pero al menos está en MDN. Si necesitas hablar con alguien para que lo trasladen al lugar correcto, por favor contáctanos.

- -

Paso 1: Escribe en dos líneas

- -

La primera oración de tu artículo debe resumir qué tema vas a cubrir y la segunda debe entrar en algunos detalles más sobre los elementos que pondrías en el artículo. Por ejemplo:

- -
-

Mientras {{glossary("HTML")}} los archivos contienen contenido estructurado, {{Glossary("CSS")}}, otra tecnología web, hace que el contenido se vea como tú quieres. En este artículo vamos a cubrir cómo funciona esta tecnología y cómo escribir tu propio ejemplo básico.

-
- -

Observa cómo el ejemplo explica brevemente que CSS es una tecnología web central que se usa para diseñar páginas. Eso es suficiente para que el lector tenga una idea bastante buena de lo que cubre el artículo.

- -

Debido a que los artículos del Área de aprendizaje se dirigen principalmente a los principiantes, cada artículo debe cubrir un tema directo para no abrumar al lector con demasiada información nueva. Si no puedes resumir el artículo en una oración, ¡podrías estar intentando hacer demasiado en un artículo!

- -

Paso 2: Agregar un cuadro superior

- -

Luego, agrega un cuadro superior para ayudar a los lectores a orientarse sobre dónde se encuentran en el proceso de aprendizaje. Aquí hay un ejemplo de un cuadro superior de "Entendiendo las URLs y su estructura". Puedes usar este artículo como modelo cuando escribas tu propio artículo.

- - - - - - - - - - - - -
Requisitos previos:Primero necesitas saber cómo funciona Internet, qué es un servidor web  y los conceptos detras de los enlaces de la web.
Objetivo:Aprenderás qué es una URL y cómo funciona en la web.
- -
-
Requisitos previos
-
¿Qué debe saber ya el lector para seguir el artículo? Cuando sea posible, haz de cada requisito previo un enlace a otro artículo del Área de aprendizaje que cubra el concepto (a menos que sea un artículo realmente básico que no requiere conocimiento previo).
-
Objetivos
-
Esta sección explica brevemente lo que el lector aprenderá a lo largo del artículo. Esto es un poco diferente al de una sola línea; (el one-liner resume el tema del artículo), mientras que la sección de objetivos establece específicamente lo que el lector puede esperar lograr en el transcurso del artículo.
-
- -
-

Nota: Para crear esta tabla, puedes copiar y pegar la tabla del ejemplo anterior o usar la herramienta de tabla del editor de MDN. Si eliges usar la herramienta de tabla, tienes que agregar específicamente la clase CSS learn-box además de la clase predeterminada standard-table.Para hacer esto, cuando crees o edites las propiedades de la tabla, ve al panel "Avanzado" y configura el campo Stylesheet Classes a "standard-table learn-box".

-
- -

Paso 3: Escribir una descripción completa

- -

A continuación, escribe una descripción más larga que ofrezca una visión más completa del artículo, destacando los conceptos más importantes. ¡No olvides explicar por qué el lector debe tomarse el tiempo para aprender este tema y leer tu artículo!

- -

Paso 4: Cavar más profundo

- -

Cuando hayas terminado con todo eso, finalmente puedes sumergirte profundamente en el tema. Puedes estructurar esta parte de tu artículo como desees (aunque no dudes en consultar nuestra guía de estilo). ¡Esta es tu oportunidad para brillar! Entra en detalles explicando el tema sobre el que estás escribiendo. Proporciona enlaces a la documentación de referencia completa, explica cómo funciona la tecnología en detalle, brinda detalles de sintaxis y uso, etc. ¡Tú decides!

- -

Como guía, aquí hay algunos consejos de escritura para principiantes:

- - - -

Eche un vistazo a las primeras secciones de nuestras Funciones - Bloques de código reutilizables para algunas buenas secciones descriptivas.

- -

Paso 5: Proporcionar material de "aprendizaje activo"

- -

Para ilustrar el artículo y ayudar al lector a comprender mejor lo que están aprendiendo, asegúrese de proporcionar ejercicios, tutoriales y tareas que cumplir. Al hacer que utilicen y experimenten de forma activa y práctica con los conceptos que explica su artículo, puede ayudar a "bloquear" la información en sus cerebros.

- -

Puede elegir incluir los ejemplos directamente en la página como muestras en vivo, o vincularlos si realmente no funcionan como una muestra en vivo. Si está interesado en ayudar a crear estos valiosos materiales, lea el artículo Cree un ejercicio interactivo para ayudar a aprender la web.

- -

Si no puede proporcionar enlaces a materiales de aprendizaje activos existentes (no sabe de ninguno o no tiene tiempo para crearlos), debe agregar la etiqueta{{Tag("NeedsActiveLearning")}}  al artículo. De esa manera, otros colaboradores pueden encontrar artículos que necesitan materiales de aprendizaje activo y quizás ayudarlo a encontrarlos.

- -

Eche un vistazo a Aprendizaje activo: seleccione diferentes elementos para un ejercicio de aprendizaje interactivo en vivo, o Aprendizaje activo juegue con posibilidades para un estilo diferente de ejercicio que les exija descargar una plantilla localmente y modificarla siguiendo los pasos proporcionados.

- -

Paso 6: Obtenga el artículo revisado y póngalo en el menú de navegación del Área de aprendizaje

- -

Después de que hayas escrito tu artículo, avísanos para que podamos echarle un vistazo, hacer una revisión y sugerir mejoras. Una vez más, consulte nuestra sección Contáctenos para conocer las mejores maneras de comunicarse.

- -

En el menú de navegación principal del Área de aprendizaje. Este menú es generado por la macro Barra de aprendizaje, que necesita privilegios especiales para editar, así como una vez más, hable con uno de nuestro equipo sobre cómo agregarlo.

- -

Al menos debe agregarlo a su página. Esto se hace agregando la llamada a la macro \{{LearnSidebar}} en un párrafo en la parte superior de su página.

- -

Artículos sugeridos

- -

¿Así es que quieres contribuir?

- -

El equipo del Área de Aprendizaje Mantiene ONU Tablero de Trello las ideas Con de Artículos para Escribir. ¡Siéntete libre de elegir uno y ponte a trabajar!

diff --git a/files/es/mdn/contribute/procesos/index.html b/files/es/mdn/contribute/procesos/index.html deleted file mode 100644 index a408f11fb7..0000000000 --- a/files/es/mdn/contribute/procesos/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Procesos de documentación -slug: MDN/Contribute/Procesos -tags: - - Landing - - MDN Meta - - Procesos -translation_of: MDN/Contribute/Processes ---- -
{{MDNSidebar}}
{{IncludeSubnav("/es/docs/MDN")}}
- -

El proyecto de Documentación MDN es enorme; hay un sinfín de teconologías que cubrimos a través de la asistencia de cientos de colaboradores de todo el mundo. Para ayudarnos a llevar orden al caos, tenemos procesos estandarizados para seguir cuando se trabaja en tareas específicas relacionadas con la documentación. Aquí encontrarás guías para estos procesos.

- -

{{LandingPageListSubPages()}}

diff --git a/files/es/mdn/contribute/processes/index.html b/files/es/mdn/contribute/processes/index.html new file mode 100644 index 0000000000..a408f11fb7 --- /dev/null +++ b/files/es/mdn/contribute/processes/index.html @@ -0,0 +1,14 @@ +--- +title: Procesos de documentación +slug: MDN/Contribute/Procesos +tags: + - Landing + - MDN Meta + - Procesos +translation_of: MDN/Contribute/Processes +--- +
{{MDNSidebar}}
{{IncludeSubnav("/es/docs/MDN")}}
+ +

El proyecto de Documentación MDN es enorme; hay un sinfín de teconologías que cubrimos a través de la asistencia de cientos de colaboradores de todo el mundo. Para ayudarnos a llevar orden al caos, tenemos procesos estandarizados para seguir cuando se trabaja en tareas específicas relacionadas con la documentación. Aquí encontrarás guías para estos procesos.

+ +

{{LandingPageListSubPages()}}

diff --git a/files/es/mdn/contribute/tareas/index.html b/files/es/mdn/contribute/tareas/index.html deleted file mode 100644 index 225d69bf1d..0000000000 --- a/files/es/mdn/contribute/tareas/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: Cosas para hacer en MDN -slug: MDN/Contribute/Tareas -translation_of: MDN/Contribute/Getting_started -translation_of_original: MDN/Contribute/Tasks ---- -
{{MDNSidebar}}

¿Estás buscando formas de ayudar a mejorar MDN? Hay muchas formas de ayudar: desde corregir errores tipográficos hasta escribir nuevo contenido, o incluso ayudar a desarrollar la plataforma Kuma en la que se construye el sitio web. La guía para el contribuyente de MDN cubre todas las formas en las que puedes ayudar y cómo hacerlo. Más abajo, encontrarás listas de tareas más específicas que faltan hacer.

-

Hay un montón de cosas que puedes hacer para ayudar en MDN. Tenemos una guía para las tareas que puedes llevar a cabo como parte de nuestro artículo Comenzando en MDN. Entre las posibles formas de ayudar se encuentran:

- -

Para más ideas acerca de cosas en las que puedes colaborar con MDN, vé nuestras Guías de cómo hacerlo. Puedes encontrar listas de páginas categorizadasque necesitan de tu ayuda en nuestra sección de  Estado de la Documentación.

-- cgit v1.2.3-54-g00ecf