Traduire la documentation en anglais #13

New issue

Open

opened 2026-08-30 14:07:05 +01:00 by claudeagent · 0 comments

claudeagent commented

2026-08-30 14:07:05 +01:00

Collaborator

Description

AGENTS.md fixe la règle : anglais pour tout ce qu'un contributeur lit, français pour tout ce qu'un utilisateur lit. docs/ est du côté contributeur et reste en français — c'est reconnu explicitement comme une dette, pas comme un choix.

L'état actuel
scope.md, architecture.md (D1 à D36), ux.md, dev-environment.md et code-guidelines.md sont en français. workflow.md et les décisions les plus récentes d'architecture.md (D26, D27, D33 et suivantes) sont déjà écrites en anglais, en application de la règle « ne pas ajouter au retard ». Le résultat est un architecture.md bilingue par sections.

Pourquoi ça compte
Le projet vise le Nextcloud App Store. Un dépôt dont toute la conception est en français ferme la porte à la plupart des contributeurs possibles — c'est le raisonnement qui a mis le code, les commits et les tests en anglais dès le départ.

Pourquoi ça n'a pas été fait
architecture.md fait près de 2000 lignes et sert de référence de travail à son auteur. Une traduction mécanique coûterait plus qu'elle ne rapporterait : ces documents pèsent leur précision, et une décision mal traduite est pire qu'une décision en français.

Ce qu'il faut trancher

L'ordre. scope.md et code-guidelines.md sont courts et se lisent en premier par un nouveau venu ; architecture.md est le gros morceau et le plus utile.
Fichier par fichier, ou décision par décision. architecture.md peut se traduire par blocs D… sans jamais rester à moitié cassé.
Ce qui ne se traduit pas : les libellés d'interface cités dans ux.md sont ce que l'utilisateur voit.

Plan d'action

TODO

Recette

Revue technique personnelle
Mise à jour du wiki (décision, schéma, interface, périmètre)
Revue fonctionnelle

Plan de MEP

TODO Planification de la livraison

## Description `AGENTS.md` fixe la règle : anglais pour tout ce qu'un contributeur lit, français pour tout ce qu'un utilisateur lit. `docs/` est du côté contributeur et reste en français — c'est reconnu explicitement comme une dette, pas comme un choix. **L'état actuel** `scope.md`, `architecture.md` (D1 à D36), `ux.md`, `dev-environment.md` et `code-guidelines.md` sont en français. `workflow.md` et les décisions les plus récentes d'`architecture.md` (D26, D27, D33 et suivantes) sont déjà écrites en anglais, en application de la règle « ne pas ajouter au retard ». Le résultat est un `architecture.md` bilingue par sections. **Pourquoi ça compte** Le projet vise le Nextcloud App Store. Un dépôt dont toute la conception est en français ferme la porte à la plupart des contributeurs possibles — c'est le raisonnement qui a mis le code, les commits et les tests en anglais dès le départ. **Pourquoi ça n'a pas été fait** `architecture.md` fait près de 2000 lignes et sert de référence de travail à son auteur. Une traduction mécanique coûterait plus qu'elle ne rapporterait : ces documents pèsent leur précision, et une décision mal traduite est pire qu'une décision en français. **Ce qu'il faut trancher** - L'ordre. `scope.md` et `code-guidelines.md` sont courts et se lisent en premier par un nouveau venu ; `architecture.md` est le gros morceau et le plus utile. - Fichier par fichier, ou décision par décision. `architecture.md` peut se traduire par blocs `D…` sans jamais rester à moitié cassé. - Ce qui ne se traduit pas : les libellés d'interface cités dans `ux.md` sont ce que l'utilisateur voit. ## Plan d'action - [ ] TODO ## Recette - [ ] Revue technique personnelle - [ ] Mise à jour du wiki (décision, schéma, interface, périmètre) - [ ] Revue fonctionnelle ## Plan de MEP - [ ] TODO Planification de la livraison