Skip to content

docs(i18n): traductions allemande et italienne du site + diagrammes mermaid#18

Open
cluster2600 wants to merge 1 commit into
ai-swiss:mainfrom
cluster2600:contrib/i18n
Open

docs(i18n): traductions allemande et italienne du site + diagrammes mermaid#18
cluster2600 wants to merge 1 commit into
ai-swiss:mainfrom
cluster2600:contrib/i18n

Conversation

@cluster2600

Copy link
Copy Markdown

Traductions allemande (docs/de/) et italienne (docs/it/) des pages de reference de la documentation, plus l'enregistrement des locales de (Deutsch) et it (Italiano) dans la configuration du site (repli sur le francais pour toute page non traduite, donc sans rupture).

  • Chaque page traduite est un miroir (corps seul) commencant par un marqueur fr-synced dont le hachage correspond a sa source francaise, la porte qui empeche les traductions de deriver.
  • Des diagrammes mermaid sont ajoutes aux pages francaises qui decrivent vraiment un flux, un arbre de decision ou un cycle de vie (voies de routage, choix de fournisseur d'embeddings, adoption en organisation, cycle de vie de l'expertise, etc.), repercutes en en/de/it.
  • Toutes les portes docs passent (em-dash, present, ponctuation, lexique, traductions, arborescence <= 400 lignes).

Astuce de relecture: l'allemand est entierement sous docs/de/, l'italien sous docs/it/, donc une langue peut etre relue a la fois. L'allemand vise le public germanophone suisse (utilise ss, pas ß); l'italien est de l'italien standard naturel.

Honnetete: traduction assistee par machine. Le resultat est coherent et passe toutes les portes, mais une relecture native (surtout l'allemand, le public le plus large) est recommandee avant publication.

…diagrammes mermaid

- Enregistre les locales de (Deutsch) et it (Italiano) dans la configuration
  du site (repli sur le francais pour les pages non traduites).
- Traduit les pages de reference francaises en allemand (docs/de/) et en
  italien (docs/it/). Chaque page est un miroir (corps seul) commencant par un
  marqueur fr-synced dont le hachage correspond a sa source francaise.
- Ajoute des diagrammes mermaid aux pages francaises qui decrivent un flux, un
  arbre de decision ou un cycle de vie, repercutes en en/de/it.

Toutes les portes docs passent (em-dash, present, ponctuation, lexique,
traductions, arborescence). L'allemand vise le public germanophone suisse;
l'italien est standard. Traduction assistee par machine: une relecture native
est recommandee avant publication.
@cluster2600
cluster2600 requested a review from cbardyn as a code owner June 28, 2026 18:58
@cbardyn

cbardyn commented Jul 2, 2026

Copy link
Copy Markdown

Merci pour cette contribution d'ampleur: les deux arborescences docs/de/ et docs/it/ sont bien séparées, chaque page porte son marqueur fr-synced adossé au hachage de sa source, et les diagrammes mermaid n'apparaissent que là où ils décrivent réellement un flux ou un cycle de vie. La distinction garantie/consigne et le cadrage «routage 100 % local» sont fidèlement rendus en allemand, et l'emploi de «ss» plutôt que «ß» est cohérent avec le public alémanique visé. Nous apprécions aussi la franchise sur la traduction assistée et la relecture native restant à faire. Signe que l'accueil est prêt: la configuration du dépôt déclare déjà docs/de et docs/it comme miroirs de traduction, au même titre que docs/en.

Avant de pouvoir fusionner, trois points sont à régler.

D'abord, le DCO: le commit ne comporte pas de ligne Signed-off-by, que notre porte exige. Un git commit --amend --signoff (ou git rebase --signoff) suivi d'un push réglera la question.

Ensuite, la branche est en conflit avec main, qui a publié la 1.1.0 depuis votre envoi (la passe sur le README et la documentation touche des pages sources françaises). Un rebase est nécessaire; si une page source a bougé, son miroir devra rafraîchir son marqueur fr-synced.

Enfin, l'intégration continue n'a pas encore tourné sur cette branche de fork: nous l'approuverons pour que les quatorze contrôles requis s'exécutent. Vous indiquez que toutes les portes passent en local, ce dont nous ne doutons pas, mais «vert en local» n'est pas tout à fait «vert partout»: la CI ajoute notamment la vérification de cohérence des marqueurs sur l'ensemble du corpus.

Une fois ces trois éléments levés, nous procéderons à la relecture des contenus; pour deux arborescences de cette taille, elle prendra un peu de temps, et nous vous tiendrons au courant. Merci encore: une documentation qui se lit en allemand et en italien, c'est exactement ce qu'un projet suisse devrait offrir.

@cbardyn cbardyn added the en attente du contributeur Réponse postée; la prochaine action est côté contributeur (rebase, DCO, discussion) label Jul 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

en attente du contributeur Réponse postée; la prochaine action est côté contributeur (rebase, DCO, discussion)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants