Skip to content

docs: translate the German locale - #181

Merged
majinghe merged 1 commit into
mainfrom
cursor/repair-german-locale-731a
Oct 19, 2026
Merged

majinghe merged 1 commit into
mainfrom
cursor/repair-german-locale-731a

Conversation

@majinghe

Copy link
Copy Markdown
Collaborator

Summary

The German locale under content/de was still mostly an English copy. This PR translates those pages into formal German (Sie) and aligns the pages that were already German with the locale glossary.

No content/de Markdown or MDX file is byte-identical to content/en anymore. Code fences, commands, API names, image paths, and URL slugs are unchanged. Other locales are untouched.

Terminology

English German used here
object storage / object-storage layer Objektspeicher / Objektspeicher-Backend
S3-compatible S3-kompatibel
Bucket / Object Bucket / Objekt
Console Console (Weboberfläche only as a gloss)
endpoint Endpunkt
access key / secret Zugriffsschlüssel / geheimer Zugriffsschlüssel
credentials Anmeldedaten or Zugangsdaten
path-style pfadbasierte Adressierung (Path-Style) on first mention
deployment Bereitstellung
HEAD / inspect Metadaten abrufen (Head)
compatibility gate Kompatibilitätsprüfung (Compatibility Gate)
verification heading Überprüfung / Prüfung
await mit await abwarten
infrastructure tooling Infrastruktur-Tools
table bucket Tabellen-Bucket
warehouse des Warehouses
rootless and daemonless ohne Root-Rechte und ohne Daemon
lifecycle operations Lebenszyklusoperationen

Internal documentation links on translated pages use the /de/... prefix. The Apache License 2.0 deed in developer/license.md stays in English; the introduction around it is German. Product names (Docker, Flink, Iceberg, MCP, OIDC, IAM, and similar) stay as titles.

Scope

181 files under content/de, including:

  • Homepage, installation (Linux, containers, Helm, Operator, macOS, Windows, requirements), operations, security and compliance, troubleshooting, reference, and administration entry points and their children
  • Developer SDK, examples, MCP, and the integration guides that were still English (AI, DevOps, observability, registries, backup, big data, databases, cloud-native, storage, reverse proxies, and the remaining “Sonstige” pages)
  • Sidebar meta.json labels where the English label was a translatable section name (Datenanalyse, Datenbank, Speicher, Reverse-Proxy, Cloud-nativ)

Audit spot-check

  • capo.md: „Warten Sie … mit await ab“; heading „Überprüfung“
  • openobserve.md: „entfernte“; heading „Überblick“; Console, not Web-Konsole
  • loki.md, tempo.md, duckdb.md: „In dieser Anleitung betreiben Sie“; Prüflauf; Single-Binary-Konfiguration; pfadbasierte Adressierung (Path-Style)
  • DevOps, AI, observability, and registry indexes: Objektspeicher-Backend and Infrastruktur-Tools
  • harbor.md: „die bei der CNCF graduierte, cloud-native Registry“
  • swift.md: „Bauen Sie RustFS“; Metadaten abrufen (Head)
  • s3-compatibility.md: Kompatibilitätsprüfung; Metadaten abrufen (Head)
  • s3-tables.md: „dieses Warehouses“; locale links under /de/
  • prerequisites-and-service.md: German throughout, including Kapazitätsplanung; the missing -L label sentence from the current English page is restored
  • iceberg.md and the administration, developer, installation, operations, reference, security, and troubleshooting indexes: German body copy
  • Homepage: „ohne Root-Rechte und ohne Daemon“; Lebenszyklusoperationen; headings „Selbst betreiben“ and „Cloud-Anbieter“

Remaining gaps

  • No untranslated English page stubs remain under content/de.
  • The locale audit still reports three SOURCE_LOCALE_LINK errors on ray.md, vllm.md, and elasticsearch.md. Those are official external documentation URLs whose paths contain /en/ (docs.ray.io, docs.vllm.ai, elastic.co). They match the English pages. Rewriting them would both break the citation and fail the external-URL check.
  • Navigation titles that are the same word in English and German (Installation, Administration, Backup, Container, Upgrade, SDK, OIDC, IAM, and product-name page titles) are unchanged on purpose.
  • npm run types:check fails on existing implicit-any errors in worker.mjs, scripts/add-language-redirects.mjs, and scripts/worker-redirects.test.mjs. This PR does not touch those files.

Verification

  • node .agents/skills/localize-rustfs-docs/scripts/audit-locales.mjs --locales de: 227 German files, 0 missing, 0 extra. 3 errors, all the external /en/ URLs above. No UNTRANSLATED_FILE or code-fence mismatches.
  • npm run docs:check: pass (orphans, relative links, fence languages, banned strings, image size, locale parity, technical code blocks).
  • npm run build: pass (3785 files generated).
  • Rendered pages at http://127.0.0.1:3456: /de/, /de/installation, /de/installation/linux/quick-start, /de/operations, and /de/operations/upgrade show German headings and body copy, and sidebar navigation stays under /de/. Mobile layout was not checked.
Open in Web Open in Cursor 

Replace English copies under content/de with formal German and align terminology for Objektspeicher, pfadbasierte Adressierung, and the Console.

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 8:22am UTC

@cloudflare-workers-and-pages

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 1776002 Commit Preview URL

Branch Preview URL
Oct 19 2026, 08:19 AM

@majinghe
majinghe marked this pull request as ready for review October 19, 2026 08:34
@majinghe
majinghe merged commit 5c1807f into main Oct 19, 2026
5 checks passed
@majinghe
majinghe deleted the cursor/repair-german-locale-731a branch October 19, 2026 08:34

This branch was successfully deployed

1 active deployment
Preview — 17760023 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