Langue

La frontière est simple : le code est en anglais, ce que l'utilisateur lit est en français.

Anglais

Tout ce qui relève du code, sans exception :

• Noms de fichiers, sauf les dossiers de routes Next.js : voir plus bas.
• Variables, fonctions, classes, composants.
• Commentaires dans le code.
• Props, évènements, constantes, types.
• Messages de commit.

Français

Tout ce qui est visible par l'utilisateur :

• Textes, titres, descriptions, labels de l'interface.
• Slugs et noms de dossiers qui correspondent à des routes d'URL.
• Documentation, y compris les noms de fichiers de docs/.

Où passe la frontière

Un nom de dossier de route est visible dans l'URL, donc en français : app/(public)/parametres/page.js. Le composant qu'il contient reste nommé en anglais.

Un message d'erreur destiné à l'utilisateur est en français. Le message journalisé côté serveur pour le développeur est en anglais.

// message serveur, anglais
fail(`Cron ${name}: ${error.message}`);

// message utilisateur, français
return apiError('Bad Request', 'Cette adresse est déjà utilisée.');

Une clé de permission est du code, donc en anglais (users.manage). Son label et sa description sont affichés dans l'admin, donc en français.

{ key: 'blog.manage', name: 'Gérer les billets', description: 'Créer, modifier et supprimer', group_name: 'Blog' }

Rédaction

Le fait d'écrire en français ne dit pas comment écrire. Voir Rédaction avant de rédiger tout contenu textuel : la voix de l'interface et celle de la documentation ne sont pas la même.