Nuestros Revisores de la Base de conocimientos son colaboradores y empleados de Mozilla con experiencia y habilidad para escribir documentos de ayuda. Como bien indica el título, este artículo ofrece una guía para revisar artículos. Esta es la versión corta (la parte más aburrida está bajo el índice de contenidos):

Mejores artículos (más de 64000 visitas por mes):

• Para las actualizaciones de contenido ya existente, puedes aprobar todas las revisiones (incluyendo las tuyas) que creas que mejoran el artículo.
• Para cambios importantes, por favor, coméntalo en el foro del artículo antes de aprobarlos. No apruebes tus propias revisiones si hay cambios importantes.

Otros artículos (menos de 64000 visitas por mes):

• Aprueba todos las actualizaciones y todos los cambios importantes (incluyendo los tuyos) que creas que mejoran el artículo.

Respuesta para los editores: Cuando revises, asegúrate de incluir un mensaje para el editor agradeciéndole la colaboración. Si no apruebas una revisión, deberías dar detalles específicos y constructivos sobre lo que creas que se tiene que cambiar para que se acepte la revisión.

Revisar artículos

La mayoría de las revisiones están hechas por gente que ofrece su tiempo y su talento a ser voluntaria. Cuando trabajes con los artículos que la gente ha presentado, asume que todo el mundo tiene las mejores intenciones y asegúrate de agradecerles su colaboración. Recuerda: puede que seas el primer y único contacto que esta persona tenga con alguien de Mozilla. Por favor, haz que sea positivo.

Mejores artículos

Nuestros mejores artículos (más de 64000 visitas por mes, unos 20 artículos) forman el 50 o 55% de todas las visitas a la Base de conocimientos. Es muy importante que estos artículos tengan la información más reciente.

• Para actualizaciones de contenido ya existente, puedes aprobar todas las revisiones (incluyendo las tuyas) que creas que mejoran el artículo.

Se deberían discutir los grandes cambios en los artículos, ya que los mejores artículos han sido editados en numerosas ocasiones y afectan a un gran número de personas. No tengas miedo de enviar un mensaje privado a los otros colaboradores de la Base de conocimientos para que te ayuden. Es mejor que se llegue a un acuerdo, aunque a veces sea un poco difícil de conseguir. Como siempre, utiliza tu sentido común.

• Para cambios importantes, por favor, coméntalo en el foro del artículo antes de aprobarlos. No apruebes tus propias revisiones si hay cambios importantes.

Otros artículos

Los artículos con menos de 64000 visitas por mes forman la mayoría de nuestra Base de conocimientos (cerca de 200 artículos, del 45% al 50% de visitas). Cubren los problemas menos comunes y los productos más nuevos. Aquí, la política de revisión es más indulgente.

• Aprueba todos las actualizaciones y todos los grandes cambios (incluyendo los tuyos) que creas que mejoran el artículo.

Artículos nuevos

Cuando escribimos un artículo por primera vez, no tiene ninguna visita. Así que, ¿cómo debes tratarlo?

• Si se ha creado el artículo por un motivo especial, (lanzamiento de Firefox chemspill, para que se enlace desde un producto o desde mozilla.org), trátalo como si fuera uno de los mejores artículos.
• Si no hay razones para pensar que el artículo va a ser muy popular de inmediato, trátalo como si fuera uno de los artículos con menos de 64000 visitas por mes. Si la revisión es una mejora, apruébalo. No pasa nada si el artículo no está completo al 100%. Si no es uno de los mejores artículos, puede empezar a obtener respuestas mientras seguimos trabajando en él.

¿Qué es una actualización de un contenido existente?

La tarea más importante de la Base de conocimientos es mantener los artículos al día. Normalmente esto implica:

• Correcciones de ortografía y gramática.
• Simplificación de la lengua existente, quitando la jerga.
• Actualizar o añadir capturas de pantalla.
• Actualizar o añadir screencasts.
• Eliminar contenidos para versiones de Firefox que ya no sean válidas.
• Actualizar las instrucciones paso a paso para ayudar con las nuevas versiones de Firefox.
• Actualizar el texto ya existente para ayudar con los cambios en las nuevas versiones de Firefox.
• Arreglar los problemas con las etiquetas wiki.
• Arreglar enlaces.
• Actualizar las palabras clave.
• Añadir o actualizar el sumario de búsqueda.

¿Qué es un cambio importante?

Los cambios importantes son los que fundamentalmente cambian el artículo existente. Incluyen:

• Añadir una sección nueva.
• Eliminar una sección existente.
• Reescribir gran parte del artículo (más que el mero hecho de simplificar y eliminar jerga).
• Reescribir encabezados de secciones.
• Reordenar secciones.
• Cambiar el ámbito del artículo.

Niveles de revisión

Cuando apruebes un artículo, tienes tres niveles de revisión para escoger:

• Detalles menores que no afectan a las instrucciones: Estos son cambios que no cambian las instrucciones a los usuarios. A los localizadores no se les notificarán estos cambios, inclusive si han marcado "Listo para su localización".
• Cambios de contenido que no requieren traducción inmediata: Esta es la opcion por defecto. Estos son cambios significativos (como actualizaciones y grandes cambios) que no invalidan completamente la versión anterior del artículo.
• Cambios de contenido importantes que harán que las revisiones anteriores sean inexactas: Esto es para los pocos casos en los que un artículo está tan mal que sin estos cambios causaría grandes problemas a la gente. Esto añadirá un aviso en los artículos localizados en los que puede que el contenido esté anticuado y ofrecerá un enlace a la versión inglesa.
  
  

Respuesta para los editores

Cuando apruebes un artículo, es importante que agradezcas al editor su colaboración. También estaría bien que le hicieras algún comentario: ¿Ha mejorado su escritura? ¿Hizo un trabajo realmente bueno explicando algo difícil? ¡Díselo!

Si una revisión tiene más que algún error pequeño, cambia alguna cosa de un artículo importante sin haber sido discutido o no crees que pueda ayudar, deberías no aprobarla. Una revisión no aprobada no es un simple rechazo, sino tu oportunidad de trabajar con el editor para que pueda serlo. Así que, por favor, agradéceselo al editor y dale detalles específicos y constructivos sobre lo que creas que se tiene que cambiar para que se acepte la revisión. Asegúrate de darle enlaces a cualquier discusión o guía relevante para los artículos.

Listo para localizar

Marcar un artículo como Listo para localizar nos permite decirles a los localizadores que la versión en inglés está lista y que ya se puede traducir el artículo sin temor a que el artículo vaya a cambiar un par de veces más antes de que se haya terminado.

Si cuando apruebas una revisión todos los cambios necesarios (notas de cambios necesarios, foro de discusión del artículo) ya se han hecho y no hay ninguno planeado, marca el artículo como listo para localizar.

Congelar los mejores artículos

El proceso de localización da mucho trabajo y muchas veces lo lleva a cabo solo una persona. Solo los 20 artículos más importantes (más o menos) se localizan en algunas regiones. Normalmente, nuestros artículos más importantes solo necesitan cambios para adaptarlos a las nuevas versiones de Firefox. Como ya sabemos lo que vendrá, intentamos asegurarnos de que todos los cambios necesarios se completen cuatro semanas antes de un lanzamiento de Firefox. Así, los localizadores pueden aprovechar estas cuatro semanas para trabajar.

Por eso, solo podemos marcar los artículos importantes como listos para localizar cuatro semanas antes del lanzamiento. Todas las actualizaciones para las seis semanas siguientes NO deberían marcarse como listas para localizar. De todas formas, si hay un cambio crítico que tiene que traducirse, tendremos que hacer una excepción. También recuerda que si utilizas el nivel de revisión de primer o menor importancia, puedes marcar el artículo listo para su localización porque los localizadores no serán notificados de los cambios con este nivel de revisión.

Si no marcas una revisión como lista para localizar cuando la apruebes (como en el caso anterior), puedes marcarla haciendo clic en el estado de la entrada de la historia de la revisión y confirmando.

¿Cómo funciona “Listo para localizar”?

Para evitar que alguien traduzca un artículo que está siendo sometido a cambios, cuando haces clic en Traducir artículo, se te da la versión más reciente que ha sido marcada como lista para localizar. Una vez que una nueva revisión de un artículo ya ha sido aprobado, no se añade a los paneles de localización como que necesita una actualización, a no ser que la revisión se marque con las etiquetas de segunda o tercera revisión y la bandera de “listo para localizar” esté marcada. Esto también envía una notificación por correo electrónico a todos los que busquen artículos listos para localizar.

Temas de actualidad

Tenemos una sección especial que se llama "Temas de actualidad" y suele aparecer en las páginas de inicio de los distintos productos. Normalmente, se muestran entre 3 y 5 artículos en cada lista. Los artículos que aparecen se analizan uno por uno en función de la gravedad del problema, de lo extendido que esté y de cuánto tiempo lleve así. Todo esto se decide en nuestra reunión semanal. Como regla general, los artículos siguen apareciendo en la lista de temas de actualidad hasta una semana después de que el problema haya dejado de serlo, para que los usuarios tengan más oportunidades de verlo.

Necesita cambios

Cuando apruebes una revisión, tienes que decidir qué se necesita cambiar (si es que hay algo). Si ya se ha hecho todo lo que se especifica en los Comentarios de necesita cambios, puedes desmarcarlo (quitando el comentario) y aprobar el artículo. Si aún quedan cosas por hacer, asegúrate de que el recuadro esté marcado y actualiza el comentario. De esta manera podemos seguir la pista de lo que tenemos que hacer en los artículos.

Otorgar méritos

A veces, la gente que participa en una discusión sobre un artículo hace contribuciones significantes en una revisión incluso si no fueron ellos los que editaron la wiki. En estos casos, puedes editar la lista de contribuidores de un artículo (en la página del historial del artículo) para incluirles. ¡Puntos extra por hacérselo saber!

Spam y ediciones erróneas

En caso de spam, simplemente elimina la revisión (haz clic en la X en su entrada en el historial). En caso de entregas erróneas (sin cambios) y peticiones de ayuda fuera de lugar (la edición simplemente era una pregunta de ayuda), deberías rechazarlas e incluir un mensaje en tus comentarios:
Hola.
Parece que has intentado pedir ayuda para Firefox. Si este es el caso, por favor, pregunta otra vez aquí para que podamos ayudarte. Lamentamos las molestias.

Una vez hayas hecho esto, puedes eliminar la revisión.