Trabajando con nuestra comunidad

Este articulo necesita una revisión técnica. Cómo puedes ayudar.

Este articulo necesita una revisión editorial. Cómo puedes ayudar.

Lo mas importante para contribuir a la documentacion de MDN en cualquier escala es saber trabajar como parte de una comunidad. Este artuculo brinda tips que te ayudaran a sacarle el maximo partido a tus interacciones con documentadores y el equipo de desarrolladores.

Reglas generales de comportamiento.

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

  • Se cortes! incluso cuando no estes acuerdo, todos tenemos la misma mision: el mejoramiento de la Web.
  • Pide, no exijas. Las personas ayudan más cuando se pide de manera amable y cortes que cuando lo exijes,  el trabajo de documentacion es importante, y nuestra comunidad de desarrollo lo sabe, pero el instaito humano hace que las personas sean complicadas si no son tratadas con respeto.
  • Equilibra tu necesidad de informacion con la importancia de la misma con el tiempo que los demas para que sean de provecho las charlas. No presiones por más y más información pide solamente lo necesario.
  • Ten encuenta que la resúesta de tu solicitud requiere de tiempo valioso de la gente que esta en contacto, asegurate de aprovechar el tiempo.
  • Se consciente de las diferencias culturales. Mozilla es un equipo multinacional y multicultural, así que cuando hables con alguien cuya cultura sea  o pueda ser, diferente a la tuya, manten eso en mente mientras esten comunicados.
  • Inicia una conversacion nueva en vez de entrometerte en una existente. No pomgas tus preguntas en una conversacion sin relacion solo porque la gente con la que necesitas hablar esta prestandole atención; mientras esto puede ser conveniente para ti, esto puede molestar a las personas con las que intentas hablar, dando lugar a la perdida del resultado ideal.
  • Evita bikeshedding (trivialidad). No permitas que tu entusiasmo se transforme en una molesta pedanteria, esto hace las conversaciones desenfocadas y engorrosas.

Intercambio de conocimientos.

Al participar en el proyecto MDN, es util saber lo que esta pasando e interactuar con otros los demas miembros de nuestra comunidad. al hacer esto, podras compartir ideas, actualizaciones de estados y más. Ademas cotaos con los recursos y herramientas para ayudarte a saber que se esta haciendo y por quien.

Canales de comunicación

Existen varias formas en las que puedes participar con los miembros de la comunidad (sean documentadores o desarrolladores), cada una de las cuales tiene sus propias reglas de comportamiento y etiqueta.

IRC

Suele ser la manera más rápida y directa de "acercarce" a alguien: con solo hacer ping en el IRC. Encuentra el canal correspondiente al tema o área sobre la que estas escribiendo y solo tendras que hablar con ellos. Para  IRC especificos y concejos de etiqueta, mira el articulo de soporte Mozilla "primeros pasos en IRC." para discuciones sobre  documentacion  para desarrolladores, usa el canal #mdn.

Bugzilla

Cuando escribes documentacion para cubrir los cambios implementados como consecuencia de un error en Bugzilla, podras interactuar en ocaciones con las personas involucradas en estos errores. Asegurate de tener la guia de etiqueta Bugzilla en mente todo el tiempo!

Email

En ocasiones, el intercambio de correo electronico privado entre tu y uno o mas personas es el camino a seguir, si tienes dirección de correo electronio.

Nota: Como regla general, si alguien a publicado su email en los documentos sobre la tecnologia que estas documentando, te ha dado su correo, o es un correo muy conocido, un correo es un buen medio para realizar el "primer contacto". Si debes buscar esta, seria ,mejor conseguir un permiso de IRC o una lista de correo en primer lugar,a menos de que ya hayas agotado todos los medios para ponerte en contacto.

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

Tablero de revisión
Este es una herreienta 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 configuaración regional, nombre del contribuyente, y tema. una vez estas viendo la serie de revisiones, puedes ver los cambios realizados en cada una de ellas, abrir rapidamente la pagina,ver su historial completa 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 proveé una lista de todas las áreas de MDN que se han configurado para el seguimiento de estado, con informacion de algunas paginas y los diferentes trabajos que necesitan. Haz click en una área en particular y mira un listado de los contenidos que necesitan trabajo, como paginas que no tienen etiquetas, o etiquetas que requieren cierto trabajo. puedes ver una lista de paginas que no se han actualizado hace mucho tiempo asi como si estan fuera de fecha, asi como una lista de los errores encontrados y como han afectado estos en esa zona.
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 asi tener un registrio de lo que tenemos que hacer.

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 al hacer cada interacción que tienen con el equipo de redacción sea una buena.

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

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 en general impresionantes con un amor genuino de la Web, Mozilla, y / o la documentación, y la interacción con ellos es casi siempre bastante fácil.

Mira el articulo Únete a la comunidad para mas informacion acerca de la comunidad MDN.

El lugar mas frecuente donde podrás interactuar directamente con otros escritores es el canal #mdn en IRC. Este canal esta reservado especificamente para la discusión de documentación. para tips de etiqueta de en IRC, mira el articulo de soporte Mozilla "primeros pasos en IRC." tambien tendrás la oportunidad dediscutir con los otros miembros de la  lista de correo de dev-mdc. En general, IRC se usa generalmente para agilizar, para conversaciones mas personales, mientas que la lista de correo es generalmente para conversaciones mas largas.

By keeping in mind the Guia general de etiqueta, usted notara que las cosas salen bien por lo general.

Mira tambien

 

Etiquetas y colaboradores del documento

 Colaboradores en esta página: whitman, Sebastian.Nagles
 Última actualización por: whitman,