

Blog
Diseñar documentación para personas
Por qué el diseño sigue siendo importante en la era de la IA y nuestros principios de diseño de documentación para despejar el ruido mental.

Kevin is an infra and product engineer at General Translation, where he works on all design, brand, and product surfaces. He enjoys building with care, with attention to detail and craft.
Check out his work at kevinliu.studio.


Por qué el diseño sigue siendo importante en la era de la IA y nuestros principios de diseño de documentación para despejar el ruido mental.
Mostrando 6 de 16
Locadex es el agente de IA de General Translation que internacionaliza tu código y traduce tu contenido en tu repositorio de GitHub. Sus automatizaciones se ejecutan cuando se abre un pull request, cuando se hace push de un commit o cuando tú las inicias, y cada cambio llega como un pull request.
Marca el texto en tus componentes, genera un archivo de traducciones para cada idioma, agrega polyfills de Intl y carga el archivo correspondiente al idioma del dispositivo. Con gt-react-native, la biblioteca experimental de General Translation, envuelves el texto en <T>, un plugin de Babel agrega los polyfills y npx gt translate genera los archivos.
Traducir una aplicación Vue implica que cada cadena de las plantillas se obtenga mediante una búsqueda según el idioma activo y se traduzca a cada idioma de destino. El plugin gt-vue de General Translation traduce el contenido envuelto en el componente <T>, y npx gt translate genera un catálogo por cada idioma de destino.
Traducir una aplicación de React significa internacionalizar sus componentes para que se rendericen en el idioma del usuario y, después, traducir cada cadena a todos los idiomas que admitas. gt-react de General Translation traduce JSX en el mismo documento con el componente <T>, y npx gt translate genera un archivo por idioma.
Detecta el idioma de cada solicitud, normalmente a partir de su cabecera Accept-Language, y devuelve todas las cadenas en ese idioma. gt-node de General Translation vincula la configuración regional a cada solicitud con withGT y traduce las cadenas con getGT, a partir de las traducciones que npx gt translate --publish genera antes de desplegar.
Crea una copia traducida de cada página en una carpeta por idioma y añade cada idioma a la navegación de docs.json. El agente de IA de General Translation, Locadex, abre un pull request que añade las páginas traducidas y la navegación por idioma, y después traduce los cambios posteriores.