Skip to content

docs: translate the French locale - #183

Merged
majinghe merged 3 commits into
mainfrom
cursor/fr-locale-repair-8c86
Oct 19, 2026
Merged

majinghe merged 3 commits into
mainfrom
cursor/fr-locale-repair-8c86

Conversation

@majinghe

@majinghe majinghe commented Oct 19, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

  • Translates content/fr from the current English source so /fr/ is no longer a copy of the English pages. Voice is professional technical French with vouvoiement (vous).
  • Unifies the glossary on the AWS French style already used by S3 Tables, Restic, capo, and the backup index: compartiment (bucket) on first mention, then compartiment only; adressage de type chemin (path-style); point de terminaison; identifiants (clés d’accès / clé secrète in IAM detail); charger / télécharger; tirer / récupérer for docker pull (never retirer); registre in prose; matrice de prise en charge; binaire unique (single-binary); emplacement; metastore fichier; Étapes suivantes; N’ajoutez pas le fichier .env au dépôt; préversion (preview).
  • Fixes the catalogued language-audit items that were still open: Harbor and Docker Registry pull wording, Flink/Spark/Trino un table bucket, mixed integration / administration / Linux prerequisites pages, and admonition closers that had become :: + narrow no-break space + : and no longer closed.
  • Records those terms in .agents/skills/localize-rustfs-docs/references/fr.md.
  • URL slugs are unchanged. The French translation does not rewrite content/de or content/ja. A follow-up on this branch only replaces the shared vLLM and Elasticsearch documentation links in content/en, content/de, content/ja, and content/zh so every locale points at the same non-/en/ URL.

Vendor documentation links

The locale audit flagged three external URLs because they contain /en/.

Page New URL Why
vLLM https://docs.vllm.ai/serving/openai_compatible_server.html Locale-neutral path. It returns 302 to the same /en/latest/... page. vLLM does not publish fr/de/ja editions.
Elasticsearch snapshots https://www.elastic.co/docs/deploy-manage/tools/snapshot-and-restore Current canonical page. The old /guide/en/elasticsearch/reference/current/snapshot-restore.html URL redirects here and covers snapshot lifecycle management. /fr/, /de/, and /jp/ copies return 404.
Ray Data https://docs.ray.io/en/latest/data/data.html (unchanged) Canonical URL. https://docs.ray.io/latest/data/data.html and https://docs.ray.io/data/data.html return 404. Ray publishes only the Sphinx /en/ tree.

The audit now ignores /en/ inside absolute vendor URLs and still reports internal links such as /en/installation and https://docs.rustfs.com/en/....

Verification

  • npm run docs:check — pass (orphans, relative links, fence languages, banned strings, image size, locale parity, and translated code blocks match English).
  • npm run build — pass on the translation commit (3785 static files).
  • node .agents/skills/localize-rustfs-docs/scripts/audit-locales.mjs --locales de,fr,ja,zh — SOURCE_LOCALE_LINK is now 0. The previous Ray, vLLM, and Elasticsearch errors are gone. French has no UNTRANSLATED_FILE findings.

Rendered checks on the production build of the translation: /fr/installation and /fr/installation/linux/quick-start are French, /fr/developer/integration uses « Catégories d’intégration », and the Harbor / Docker Registry steps render as « Tirer l’image ».

Locale-audit leftovers

These are false positives, not unfinished French stubs.

  • Unchanged title values are product names or words that are the same in French (S3 Tables, Apache Flink, Apache Spark, Apache Iceberg, Docker, Console, Installation, Administration, AWS CLI, boto3, and the other integration product titles). Descriptions are French sentences.
  • developer/license.md keeps the Apache License 2.0 notice in English. That block is the text readers paste into source files.
  • index.mdx “untranslated prose” is shared JSX (className, BrandLogo), not English sentences.
  • Unchanged navigation labels are product names or identical words: Console, Linux, Windows, macOS, IAM, OIDC, SDK, DevOps, Installation, Administration. Folder titles that do differ are now Bases de données, Stockage, and Cloud natif.
  • content/zh/developer/integration/ai/ray.md still reports EXTERNAL_URL_MISMATCH because a Chinese full stop is attached to http://localhost:9000. That difference predates this change.

S3 Tables keeps « Les clients devraient utiliser l’emplacement renvoyé » because the English source says “should”, not “must”.

Open in Web Open in Cursor 

Replace the English stubs under content/fr with vouvoiement French, unify the compartiment glossary, and translate docker pull as tirer rather than retirer.

Co-authored-by: hector <majinghe@users.noreply.github.com>
@vercel

vercel Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs-rustfs-com Ready Ready Preview Oct 19, 2026 12:18pm UTC

cursoragent and others added 2 commits October 19, 2026 12:04
Point the vLLM and Elasticsearch links at URLs that do not contain /en/, in every locale, and stop treating external vendor /en/ paths as internal locale links. Ray's canonical docs URL has no working form without /en/.

Co-authored-by: hector <majinghe@users.noreply.github.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
rustfs-docs e059620 Commit Preview URL

Branch Preview URL
Oct 19 2026, 12:14 PM

@majinghe
majinghe merged commit 0cf6741 into main Oct 19, 2026
5 checks passed
@majinghe
majinghe deleted the cursor/fr-locale-repair-8c86 branch October 19, 2026 12:26

This branch was successfully deployed

1 active deployment
Preview — e0596201 Deployed Oct 19, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants