Nuestros Revisores de la Base de conocimientos son colaboradores y empleados de Mozilla con experiencia y habilidad para escribir documentos de ayuda. Aquí tienes algunas pautas para revisar artículos.

Propósito

Como revisor de la Base de conocimientos, tu rol es esencial para mantener la precisión, claridad y consistencia del contenido de ayuda en nuestra Base de conocimientos. Tu trabajo de revisión asegura que los usuarios puedan confiar en nuestros artículos y encontrar ayuda fácilmente.

Responsabilidades clave

Como revisor de la BC, cuando revisas una revisión, asegúrate siempre de que la revisión:

• Sea precisa y esté actualizada
• Utilice un lenguaje y un tono claros y consistentes
• Esté alineada con las pautas editoriales de Mozilla
• Incluya formato, enlaces y marcado correctos y funcionales
• Siga las mejores prácticas de accesibilidad y localización
• Cumpla con el alcance del artículo y la versión del producto

Pautas de revisión

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.

Política de revisión de la Base de conocimientos

Para las actualizaciones importantes, es importante distinguir entre la aprobación del contenido y la revisión del contenido, ya que son dos procesos separados.

• La aprobación del contenido la realizan los responsables del producto, principalmente para validar la exactitud técnica del contenido.
• La revisión del contenido la realizan los revisores de la BC para garantizar la calidad editorial y el formato del artículo.

Consulta Asignaciones de colaboradores para solicitudes de contenido para obtener más detalles sobre esta distinción.

¿Cuándo se requiere la revisión del personal?

La revisión del personal es necesaria para:

• Artículos nuevos
• Actualizaciones importantes marcadas explícitamente con "Se requiere revisión del personal" en las notas de la revisión

¿Cuándo pueden los colaboradores con permisos de revisión de la BC revisar las revisiones?

Los colaboradores con permisos de revisión de la BC pueden revisar:

• Revisiones clasificadas como cambios menores
• Cambios importantes que no requieren la revisión del personal

Consulta Cambios menores frente a cambios mayores para obtener más información sobre cómo se clasifican las actualizaciones de contenido en función de su alcance e impacto.

Dónde encontrar artículos sin revisar

Hay varias formas de encontrar artículos sin revisar:

• Resumen de la Base de conocimientos: Esta página te proporciona una lista de artículos en orden de número de visitas en los últimos 30 días. La columna de Estado mostrará qué artículos necesitan revisión. También puedes filtrar por producto y tipo de artículo.
• Cambios sin revisar: Esta página proporciona una forma alternativa de ver qué artículos necesitan revisión, así como cuánto tiempo ha estado esperando cada revisión para ser revisada. Puedes elegir ordenar por número de visitas/cambios más recientes, y también puedes filtrar por producto.
• Más visitados: Esta página te proporciona una lista de artículos de la Base de conocimientos basada en el número de visitas. En la columna de Estado, podrás ver qué artículos necesitan revisión.

Priorización

Al revisar varios artículos, es importante priorizar tus esfuerzos estratégicamente. Considera lo siguiente:

• Artículo con alto número de visitas: Los artículos con un alto número de visitas deben ser priorizados para asegurar que los usuarios accedan a la información más precisa y actualizada. Puedes identificarlos fácilmente ordenando la lista de Cambios sin revisar por número de visitas.
• Artículo enlazado dentro del producto: Si formas parte de uno de los grupos de contribución (Foro, BC, L10n) o del grupo "Personal", puedes ver un indicador que muestra que un artículo está enlazado dentro del producto. Estos artículos generalmente deben tener prioridad, ya que tienen un impacto directo en la experiencia del usuario.

  

Artículos especiales

• Las plantillas incluyen contenido que se reutiliza en múltiples artículos y deben considerarse de alta prioridad debido a su impacto más amplio. Todas las plantillas, incluidas las que necesitan revisión, se enumeran en este tablero. Para obtener pautas sobre cómo usar plantillas dentro de los artículos, consulta Uso de plantillas.
• Las respuestas prediseñadas son respuestas estandarizadas utilizadas en los foros de la comunidad. Debido a que se reutilizan con frecuencia, cualquier actualización debe coordinarse con el equipo de la comunidad. Una lista de todas las respuestas del foro, incluidas las que necesitan revisión, está disponible en este otro tablero. Para obtener pautas adicionales sobre cómo crear o mejorar respuestas comunes, consulta Crear o mejorar respuestas comunes del foro.

Requisitos especiales para productos de suscripción o premium

Envío de contenido

Si deseas sugerir nuevo contenido o proponer cambios, por favor, presenta un ticket de Bugzilla o contacta a un miembro del personal. Puedes contactarnos en Matrix o en el canal #sumo-team en Slack (para colaboradores con acceso a Slack).

Revisión y aprobación de revisiones de la BC

Se requiere la aprobación del personal para todas las revisiones relacionadas con productos de suscripción o premium. Esto incluye las respuestas prediseñadas y las plantillas asociadas con estos productos.

Como referencia, los productos actuales de suscripción o premium incluyen:

• Mozilla VPN
• Firefox Relay
• Mozilla Monitor
• MDN Plus

Revisar artículos

Elegir los niveles de revisión

Cuando apruebas un artículo, tienes tres niveles de revisión diferentes para elegir. Estos niveles determinarán la necesidad y la priorización para la localización.

• Detalles menores que no afectan a las instrucciones: Son cambios que no alterarán las instrucciones para los usuarios. Los localizadores no serán notificados de estos cambios.
• Cambios de contenido que no requieren traducción inmediata: Esta es la opción por defecto. Son cambios importantes (actualizaciones y grandes cambios) que no invalidan completamente la versión anterior del artículo. Los localizadores no serán notificados inmediatamente sobre los cambios, pero la revisión puede marcarse como Lista para localización más tarde y activará la notificación para los localizadores.
• Cambios de contenido importantes que harán que las traducciones anteriores sean inexactas: Se puede usar cuando la actualización hará que el contenido anterior quede obsoleto. Marcar un artículo con esto activará una advertencia en los artículos localizados de que el contenido puede estar desactualizado y proporcionará un enlace a la versión en inglés para obtener la información más actualizada.

  

Dejar comentarios para los editores

Cuando apruebes un artículo, es importante que agradezcas a los editores su colaboración. También estaría bien que les hicieras algún comentario. ¿Ha mejorado su escritura? ¿Hicieron un trabajo especialmente bueno explicando algo complejo? ¡Házselo saber!

Aplazar una revisión

Si una revisión no es particularmente útil, puedes aplazar la revisión propuesta. Sin embargo, en lugar de ser un simple rechazo, un aplazamiento es tu oportunidad de trabajar con el autor de la revisión para mejorarla. Puedes hacerlo dejando un mensaje en el campo de comentarios para agradecer al autor y luego dar una retroalimentación específica y constructiva sobre lo que crees que necesita cambiar para que la revisión sea aceptable. Asegúrate de incluir también enlaces a cualquier documentación o pauta relevante.

Revisar múltiples revisiones

Cuando hay múltiples revisiones pendientes de aprobación, asegúrate de revisar todas las revisiones comenzando por la más antigua antes de tomar una decisión. Es importante tener en cuenta que no puedes revisar revisiones más antiguas cuando una revisión más nueva ha sido aprobada. Verás que todavía están pendientes de aprobación, pero no será posible revisarlas.

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 el comentario "Necesita cambios", puedes desmarcarlo (borrando el comentario) y aprobar el artículo. Si aún quedan cosas por hacer, asegúrate de que la casilla esté marcada 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 significativas 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!

Cómo otorgar méritos a un colaborador en la BC

• Para añadir un colaborador, ve a la página Mostrar historial de un artículo
• Desplázate hacia abajo bajo las revisiones y haz clic en el enlace Editar colaboradores
• Escribe el nombre del colaborador y luego haz clic en Add Contributor

Manejo de spam y ediciones erróneas

En caso de spam, simplemente elimina la revisión haciendo clic en el icono de la papelera en el historial de revisiones del artículo y confirmando. En caso de envíos erróneos (sin cambios) y solicitudes de ayuda fuera de lugar (la edición es básicamente una pregunta de ayuda), deberías aplazarla e incluir este mensaje en tus comentarios:
Hola.
Parece que has intentado pedir ayuda para Firefox. Si este es el caso, por favor, vuelve a hacer tu pregunta aquí, https://support.mozilla.org/questions/new, para que podamos ayudarte mejor.
Lamentamos las molestias.

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

Listo para su localización

¿Cómo funciona “Listo para su localización” (RFL)?

Para evitar que los colaboradores traduzcan un artículo que todavía se está actualizando, el sistema solo permite la traducción de las versiones que han sido marcadas explícitamente como Listas para localización (RFL). Cuando el localizador hace clic en Translate article, se le proporciona la revisión más reciente que ha sido marcada como RFL.

Después de que se aprueba una nueva revisión, el artículo no aparecerá en los paneles de localización como que necesita una actualización a menos que la bandera Listo para localización (RFL) esté marcada. Cuando se establece la bandera RFL, el sistema también envía una notificación por correo electrónico a todos los que siguen el artículo, informándoles que el artículo está listo para ser localizado.

Marcar un artículo como RFL

Marcar una revisión de artículo como "Listo para su localización" significa que estamos diciendo a los localizadores que la versión en inglés está terminada y puede ser traducida sin temor a que el artículo cambie un par de veces más antes de que terminen.

La localización es mucho trabajo y a menudo la realiza una sola persona. No siempre es fácil, pero intenta asegurarte de que todos los cambios necesarios se realicen antes de un lanzamiento de Firefox para que los localizadores puedan usar ese tiempo extra para hacer su trabajo.

Marcar un artículo como RFL después de la revisión

Si no marcas una revisión como lista para su localización al aprobarla (como en el caso anterior), puedes marcarla como lista en cualquier momento haciendo clic en la entrada de estado "No listo para localización" (un símbolo ✕) bajo la columna R del historial de revisiones del artículo y confirmando.

Las revisiones que han sido marcadas como RFL tienen un símbolo de marca de verificación ✓.

Protocolos RFL

Todos los revisores colaboradores deben adherirse a los siguientes protocolos de localización:

• Todo el personal de Mozilla y los revisores colaboradores pueden marcar un artículo completamente nuevo o una actualización de artículo como listo para su localización.
• Todos los artículos completamente nuevos y las revisiones que introducen información nueva o modificada deben marcarse para su localización, a menos que los equipos de producto especifiquen lo contrario en función de la disponibilidad regional.
• Si una revisión no altera las instrucciones, la precisión o la experiencia del usuario, la prioridad de localización debe disminuirse en consecuencia.
• En algunos casos, el personal de Mozilla puede dejar una sintaxis de comentario o un comentario de revisión en un artículo para indicar que una traducción ya se está enviando para localización interna en ciertas regiones. Si la sintaxis del comentario indica que un artículo o revisión ya se está enviando para localización interna, los colaboradores no deben localizarlo de forma independiente.

Preparación para el lanzamiento

Para asegurarnos de que estamos listos para dar soporte a los próximos lanzamientos de Firefox, aquí hay algunas pautas sobre los plazos para la preparación del lanzamiento. Los artículos que están asociados con el próximo lanzamiento son o bien artículos nuevos o actualizaciones de contenido que cubren la funcionalidad introducida en el próximo lanzamiento. Las siguientes pautas se aplican a los artículos con contenido relacionado con el lanzamiento.

Calendario de lanzamientos de Firefox

4 semanas antes del próximo lanzamiento

• Comenzar a planificar y redactar contenido para el próximo lanzamiento; aún no hay trabajo para los localizadores.
• Todos los artículos existentes permanecen abiertos para edición y localización como de costumbre.

1-2 semanas antes del próximo lanzamiento

• El borrador del contenido para el próximo lanzamiento puede estar listo internamente; sin embargo, la publicación generalmente espera hasta la fecha de lanzamiento oficial para tener en cuenta cualquier cambio de última hora.
• Si el contenido requiere localización antes del lanzamiento, el equipo de producto debe notificar al personal de CX para que podamos coordinar con la comunidad de localización y asegurar que se cumplan los plazos.

Día del lanzamiento

• Los cambios de contenido deben publicarse en la Base de conocimientos de en-US. Los localizadores deben priorizar la traducción de los artículos relacionados con el nuevo lanzamiento.

Canal de discusión y escalada

No todos los revisores de la BC monitorean activamente las Discusiones de la BC. Si necesitas contactar a todo el grupo de revisores de la BC, por favor envía un correo electrónico a kb-reviewers@mozilla.com.

Evaluación del rol

Crear contenido que sea preciso, consistente y relevante es importante, y mantener esa calidad a lo largo del tiempo requiere un estándar compartido y una alineación continua.

Como revisor de la Base de conocimientos, juegas un papel importante en el mantenimiento de esos estándares. Para asegurar que nuestro grupo de revisores se mantenga activo y alineado con las prácticas actuales, el equipo de la Comunidad realiza una ligera revisión anual basada en la participación y el cumplimiento de las pautas.

Para conservar tu permiso de revisor de la BC, te pedimos que:

• Mantente alineado: Adhiérete a las Pautas de participación de la comunidad y a las pautas para revisores de la BC descritas en este artículo.
• Mantente activo: Revisa al menos tres (3) revisiones en un período de seis meses.

Si no has estado activo o si surgen preguntas sobre el cumplimiento de las pautas, el equipo de la Comunidad puede contactarte para verificar antes de tomar cualquier medida. Nuestro objetivo no es quitar permisos, sino asegurar que los revisores se sientan comprometidos, apoyados y alineados con los procesos actuales.

Si las circunstancias cambian y necesitas dar un paso atrás, lo entendemos completamente. Dado que este es un rol voluntario, tu tiempo y disponibilidad pueden cambiar naturalmente. No dudes en informar al equipo de la Comunidad cuando eso suceda. Siempre estaremos felices de reconectar cuando estés listo para volver a participar.

—

Trabajando juntos e involucrando a otros en el proceso de revisión y aprobación, podemos mantener los más altos estándares de calidad y asegurar que nuestro contenido sea de primera. ¡Gracias por tu cooperación y sigamos creando revisiones increíbles para nuestros usuarios!