Начинайте создавать межъязыковые интерфейсные документы с определениями полей: именами, типами, единицами измерения, диапазонами и значениями нулевых и отсутствующих значений. Отличайте идентификаторы протоколов от пояснений читателя. Если определение интерфейса не допускает этого, не меняйте идентификаторы полей, значения перечисления или коды ошибок при переводе естественного языка.

Сохраняйте версии и сопоставления для внесения изменений.

При изменении смысла параметра, значений по умолчанию, обработки ошибок или структуры запишите версию интерфейса и правила миграции. Свяжите локализованные документы с одной и той же версией и отметьте разделы, которые еще не обновлены. Сохраните предыдущие определения, версии и примеры, чтобы не смешивать старые и новые инструкции.

Сравните примеры с реальным интерфейсом

Разбирать запросы и ответы в согласованной среде. Проверьте поля, значения и ветки ошибок. Используйте стабильные идентификаторы для связи с локализованными объяснениями ошибок. Проверьте отсутствующие параметры, недопустимые значения и неподдерживаемые версии. Сообщайте о переведенных примерах как проверенных только после выполнения соответствующих проверок.

Проверьте язык и направление текста вместе

В руководстве W3C по интернационализации обсуждается информация о языке и направлении текста для сообщений на естественном языке. Отличайте читаемые пояснения от идентификаторов программ. Проверьте двунаправленный текст, фрагменты кода и представление чисел. Сохранять результаты рендеринга и анализа. Читабельный макет не заменяет проверку функций протокола.

Видеть Руководство W3C по интернационализации.