フィールド定義 (名前、型、単位、範囲、NULL 値と欠損値の意味) を含む言語間インターフェイス ドキュメントを開始します。プロトコル識別子とリーダーの説明を区別します。インターフェイス定義で許可されていない限り、自然言語を翻訳するときにフィールド識別子、列挙値、またはエラー コードを変更しないでください。

変更に備えてバージョンとマッピングを保持する

パラメータの意味、デフォルト、エラー処理、または構造が変更された場合は、インターフェイスのバージョンと移行ルールを記録します。ローカライズされたドキュメントを同じバージョンにリンクし、未更新のセクションをマークします。新しい命令と古い命令が混在しないように、以前の定義、リビジョン、例を保存してください。

実際のインターフェイスとサンプルを比較して確認する

合意された環境でリクエストとレスポンスを解析します。フィールド、値、エラー分岐を確認してください。安定した識別子を使用して、ローカライズされたエラーの説明をリンクします。パラメータの欠落、無効な値、サポートされていないバージョンを確認してください。対応するチェックを実行した後でのみ、翻訳された例を検証済みとして報告します。

言語とテキストの方向を一緒に確認する

W3C 国際化ガイダンスでは、自然言語メッセージの言語とテキストの方向情報について説明しています。読みやすい説明とプログラム識別子を区別します。双方向テキスト、コード スニペット、および数値の表示を確認します。レンダリングと解析の結果を保持します。読みやすいレイアウトはプロトコル機能の検証に代わるものではありません。

見る W3C 国際化ガイダンス.