Démarrez des documents d'interface multilingue avec des définitions de champs : noms, types, unités, plages et significations des valeurs nulles et manquantes. Distinguer les identifiants de protocole des explications du lecteur. Sauf si la définition de l'interface le permet, ne modifiez pas les identifiants de champs, les valeurs d'énumération ou les codes d'erreur lors de la traduction en langage naturel.

Conserver les versions et les mappages pour les modifications

Lorsque la signification des paramètres, les valeurs par défaut, la gestion des erreurs ou la structure changent, enregistrez la version de l'interface et les règles de migration. Liez les documents localisés à la même version et marquez les sections qui ne sont pas encore mises à jour. Enregistrez les définitions, révisions et exemples antérieurs pour éviter de mélanger les anciennes et les nouvelles instructions.

Vérifiez les exemples par rapport à l'interface réelle

Analyser les demandes et les réponses dans l’environnement convenu. Vérifiez les champs, les valeurs et les branches d'erreur. Utilisez des identifiants stables pour lier les explications d’erreurs localisées. Vérifiez les paramètres manquants, les valeurs invalides et les versions non prises en charge. Signaler les exemples traduits comme vérifiés uniquement après avoir effectué les vérifications correspondantes.

Vérifier ensemble la langue et le sens d’écriture

Les conseils d’internationalisation du W3C traitent des informations sur la langue et la direction du texte pour les messages en langage naturel. Distinguer les explications lisibles des identifiants de programme. Vérifiez le texte bidirectionnel, les extraits de code et la présentation des numéros. Conservez les résultats de rendu et d’analyse. La présentation lisible ne remplace pas la vérification des fonctions du protocole.

Voir Conseils d'internationalisation du W3C.