Notas para traductores en CLI v0

Añade contexto sobre el significado de cada uso junto a los mensajes heredados de JSONC o Xcode y actualiza expresamente la traducción afectada.

Una etiqueta breve suele omitir información que necesita quien traduce. Una nota puede aclarar el tema, la acción o el registro sin añadir texto visible a la interfaz. En el flujo de trabajo heredado, utiliza comentarios de JSONC o los campos de comentarios nativos de los catálogos de Xcode, cuando sean compatibles.

Aclara el significado que falta #

jsonc
{
  // 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 compatible con comentarios en i18n.json:

json
{
  "buckets": {
    "jsonc": { "include": ["locales/[locale].jsonc"] }
  }
}

«Colección de historiales médicos guardados» aclara el tema; «Texto que se muestra al usuario», no. Una nota sobre la ubicación y el registro puede explicar por qué un aviso formal se diferencia de una etiqueta de acción. Utiliza un control de claves para proteger un valor exacto que no deba cambiar, en lugar de confiar en una nota lingüística.

Revisa el resultado afectado #

Modificar solo la nota puede no alterar la suma de comprobación del valor de origen. Solicita una retraducción selectiva si la versión instalada fuera a omitir el texto por no haber cambiado. Lee la etiqueta traducida en su contexto real dentro de la interfaz.

Para XCStrings, utiliza 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 las notas específicas de cada uso separadas 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 servidor, por lo que ninguno debe contener secretos ni contenido que no tengas autorización para divulgar.