Documentación del producto en japonés

Qué

El producto de GitLab está localizado. La documentación no lo estaba, así que en los mayores mercados de GitLab fuera del inglés, un cliente podía usar el producto en su idioma y toparse con un muro de texto en inglés en cuanto necesitaba consultar algo. Los estudios son claros: los clientes potenciales tienen más probabilidades de comprar cuando pueden hacerlo en su lengua materna. Y la competencia ya había subido el listón: GitHub empezó a localizar su documentación en 2022 y hoy la ofrece en ocho idiomas.

Localización y Redacción Técnica se unieron en un programa para localizar el sitio de documentación en los mercados prioritarios de GitLab (japonés, alemán y francés), empezando por el japonés, después de que la migración del sitio a Hugo hiciera posible, por fin, una compilación multilingüe.

Yo me encargué de la parte de ingeniería: la infraestructura que hace que un segundo idioma funcione correctamente en el sitio, el traspaso entre dominios desde gitlab.com/help y el lanzamiento en sí.

Cómo

Activar el idioma fue una sola línea. Ganarse el derecho a hacerlo llevó catorce meses. La solicitud de fusión que lanzó el japonés estableció disabled: false para el idioma ja-jp en config/_default/hugo.yaml. Lo interesante era todo lo que tenía que cumplirse antes.

Corregir el selector de idioma antes de que nadie lo usara. Al principio, el selector te llevaba al inicio de la página en el idioma elegido. En documentación, donde quien lee suele estar en una sección concreta de una página muy larga, es un error discreto pero exasperante. Modifiqué onLanguageSelect para conservar el hash de la página actual, de modo que #global-keywords en la página en inglés te lleva a /ja-jp/ci/yaml/#global-keywords. Las páginas traducidas conservan los ID de anclaje en inglés, así que hoy funciona; si una página no tiene el anclaje correspondiente, simplemente carga desde el inicio en lugar de fallar. Salió a producción en septiembre, tres meses antes del lanzamiento, así que nunca formó parte de los riesgos del día del lanzamiento.

Rastrear el traspaso de /help a docs.gitlab.com. El riesgo sutil no estaba en el sitio de documentación, que no guarda ninguna preferencia de idioma, sino en gitlab.com, que sí la guarda. Cuando alguien con preferencia de japonés en gitlab.com hace clic para ir al sitio de documentación, cruza un límite entre dominios donde los navegadores pueden comportarse de forma inesperada. Al investigarlo apareció una limitación real: el sitio de documentación no tiene un entorno de staging más allá de las review apps, y /help normalmente solo se prueba en GDK. Así que tuve que armar la verificación con review apps y ejecuciones locales de GDK en lugar de un entorno de staging que no existía.

Lanzar a una hora fija, en la zona horaria correcta. El despliegue se programó para el mediodía PST del miércoles 10 de diciembre de 2025, las 05:00 JST del día 11, para que los lectores japoneses se encontraran con él al despertar en lugar de verlo aparecer a media tarde. El lanzamiento se dividió en tres partes con seguimiento y responsables distintos: el despliegue del sitio, el monitoreo y QA durante y después del lanzamiento, y la entrada de blog del anuncio. El epic de lanzamiento de GTM reunió en un solo lugar las rondas de QA, las correcciones de errores y las comunicaciones internas y externas, para que los comentarios posteriores al lanzamiento tuvieran dónde llegar.

Resultados

• docs.gitlab.com/ja-jp está disponible, y el japonés es el primer idioma localizado del sitio de documentación de GitLab. La solicitud de fusión se integró según lo previsto el 10 de diciembre de 2025.
• El selector de idioma conserva la posición en la página, así que cambiar de idioma es un paso de navegación y no volver a empezar: una corrección pequeña con un efecto desproporcionado en que la documentación localizada se sienta útil y no solo presente.
• Un camino repetible para el alemán y el francés. La configuración multilingüe de Hugo, el comportamiento del selector, el traspaso desde /help y la rutina de QA ya no dependen del idioma. El próximo idioma es un problema de contenido, no de infraestructura, y ese era precisamente el objetivo de hacer el primero con cuidado.
• Un modelo de lanzamiento documentado: despliegue, monitoreo y anuncio como tres líneas de trabajo con responsables distintos y una hora de cambio fija en la zona horaria de los lectores.