Notas para traductores en CLI v0
Añade contexto específico para cada aparición junto a los mensajes heredados de JSONC o Xcode y actualiza expresamente la traducción afectada.
Una etiqueta breve suele omitir información necesaria para traducirla. Una nota puede aclarar el tema, la acción o el registro sin agregar palabras visibles a la interfaz. En el flujo de trabajo heredado, usa comentarios de JSONC o los campos de comentarios nativos del catálogo de Xcode cuando se admitan.
Aclara el significado que falta #
{
// Patient medical records, not music recordings
"records": "Records",
// Button that submits the form; use a short action label
"submit": "Submit",
// Visual theme, not weight
"theme.light": "Light"
}Selecciona el analizador que admite comentarios en i18n.json:
{
"buckets": {
"jsonc": { "include": ["locales/[locale].jsonc"] }
}
}“Colección de registros médicos guardados” aclara el tema; “Texto que se muestra a un usuario” no. Una nota sobre la ubicación y el registro puede explicar por qué un aviso formal es distinto de una etiqueta de acción. Usa un control de claves para un valor exacto que no deba cambiar, en vez de depender de una nota lingüística para protegerlo.
Revisa el resultado afectado #
Modificar solo una nota puede no cambiar la suma de verificación del valor de origen. Solicita una retraducción selectiva si, de otro modo, la versión instalada omitiría el texto sin cambios. Lee la etiqueta traducida en su contexto real dentro de la interfaz.
Para XCStrings, usa el campo de comentarios nativo y conserva la estructura de idiomas del catálogo compartido. Consulta los formatos heredados antes de dar por hecho que otro contenedor lee las notas de la misma manera. Estos comentarios heredados no forman parte del contrato de hash y contexto del catálogo actual de React.
Mantén cada nota específica de una aparición separada del glosario, las reglas y la voz que se aplican a todo el motor de localización. Ambos tipos de información pueden enviarse al backend, así que ninguno debe contener secretos ni contenido que no tengas autorización para divulgar.