Repository navigation
docs: permanent redirects and unique page titles - #189
Merged
Merged
Conversation
Send moved historical and big-data URLs to their current pages with 301s in every locale, and give colliding page titles task-specific names. Also repair the French S3 matrix table, stable heading anchors, duplicate meta descriptions, and the shared search/TOC/copy labels. Co-authored-by: hector <majinghe@users.noreply.github.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
rustfs-docs | 3b32444 | Commit Preview URL Branch Preview URL |
Oct 27 2026, 01:39 AM |
clangenb
added a commit
to Eldara-Tech/docs.rustfs.com
that referenced
this pull request
Nov 13, 2026
Follow rustfs#189: the page title names the task ("Install RustFS with the SwarmCLI chart") in every locale, as the Helm and Operator install pages do, while the sidebar keeps the short "SwarmCLI Chart" label through a link entry in meta.json.
clangenb
added a commit
to Eldara-Tech/docs.rustfs.com
that referenced
this pull request
Nov 13, 2026
Follow rustfs#189: the page title names the task ("Install RustFS with the SwarmCLI chart") in every locale, as the Helm and Operator install pages do, while the sidebar keeps the short "SwarmCLI Chart" label through a link entry in meta.json.
houseme
pushed a commit
that referenced
this pull request
Nov 18, 2026
* docs(installation): add Docker Swarm container guide Add installation/container/swarm.md: deploy a single-node RustFS service on Docker Swarm with the swarmcli rustfs chart, reading the root credentials from Docker secrets through RUSTFS_ACCESS_KEY_FILE and RUSTFS_SECRET_KEY_FILE. Covers the secrets, the data-node label, the install, verification, the S3 API / Console exposure modes, the key chart values, and uninstalling. Link it from the container sidebar and overview, and add Docker Swarm to the credentials warning on the installation overview. zh is translated; de, fr and ja carry the English text, as for docker.md. * docs(i18n): translate the Docker Swarm guide into de, fr and ja Replace the English fallback text of installation/container/swarm.md in content/de, content/fr and content/ja with translations that follow the locale glossaries in .agents/skills/localize-rustfs-docs/references. Code blocks, identifiers and values are unchanged from English. * docs(installation): use the rustfs chart's overlay alias in the Swarm guide The released rustfs chart (rustfs/v0.1.0) adds the network alias <release>-rustfs on rustfs-net. Point overlay clients at it instead of the stack's service name <release>_rustfs: AWS SDK for Java clients reject a host name that contains '_'. Updated in every locale. * docs(home): add a Docker Swarm card to the install grid Fills the empty eighth slot in every locale and links to the Swarm guide. The icon is the SwarmCLI terminal mark (LuTerminal, same geometry). * docs(home): title the Swarm card after the SwarmCLI chart Mirrors the Helm card, which names the tool and its chart; the description keeps Docker Swarm so Swarm users still find it. * docs(installation): move the Swarm guide to Cloud Native as SwarmCLI Chart It installs a chart with a package tool, like the Helm chart beside it, and Cloud Native is the overview's home for container orchestration. Container's index and menu go back to Docker and Podman only. * docs(installation): lead the SwarmCLI guide with what the chart adds Highlights secrets, versioned upgrades and rollbacks, Traefik HTTPS and health-checked rollouts; adds Upgrade and roll back and the traefik link. Fixes the minimum SwarmCLI version (list --set needs 1.13.0), probes /health/ready, and names the unlabelled-node symptom. * docs(installation): add distributed mode to the SwarmCLI chart guide rustfs chart v0.2.0 adds mode: distributed and needs SwarmCLI 2.2.0. Split the install into standalone and distributed steps like the Helm guide, cover the cluster's rolling upgrade and full-stop credential rotation, and scope the single-node text, key values and uninstall. * docs(i18n): translate the SwarmCLI chart's distributed mode into zh, de, fr and ja Code blocks are byte-identical to English; unchanged sentences keep their reviewed translations. * docs(i18n): align the SwarmCLI chart page with the updated fr, de and ja glossaries French takes identifiants, a narrow no-break space before : and ;, and the bucket and path-style glosses; German takes Zugangsdaten and the Path-Style gloss; Japanese takes パススタイルアクセス. * docs(installation): give the SwarmCLI chart page a task-specific title Follow #189: the page title names the task ("Install RustFS with the SwarmCLI chart") in every locale, as the Helm and Operator install pages do, while the sidebar keeps the short "SwarmCLI Chart" label through a link entry in meta.json. * docs(installation): qualify SwarmCLI cluster tolerance by storage class REDUCED_REDUNDANCY objects get one parity shard on four peers, so their reads survive only one peer down; the two-peer claim holds for STANDARD. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01J2mZovbZKmkuBQ8h5uU3kb --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Permanent redirects for historical docs URLs that 404 today, plus the confirmed title, table, anchor, and template fixes. Sidebar labels stay short via
meta.json; the document<title>is the longer frontmatter title./→/enis unchanged. Accept-Language handling inpublic/language-redirect.jsis unchanged. Rules that only point at the English homepage (for example/concepts/architecture→/en) are not copied onto other locales. Splat rules such as/management/*stay English-only so they cannot guess a wrong prefix.Redirects (301)
Base rules live in
public/_redirects.worker.mjsreuses each exact rule foren,zh,de,fr, andjaby swapping the/enprefix. Trailing slashes are stripped before matching, so/de/features/s3-compatibility/and/de/features/s3-compatibilityare the same hop.Historical paths
/installation/docker,/installation/docker/index(and.html)/installation/container/docker/upgrade-scale/upgrade/operations/upgrade(rule already existed; now applies in every locale)/features/s3-compatibility/reference/s3-compatibility/management/bucket,/management/bucket/index/administration/data/bucket/creation/developer/api/administration/protocols/s3There is no bucket index page. Creation is the first page in the Bucket section, so the old bucket index goes there instead of the homepage.
/developer/apigoes to the S3 API page linked from the Developer landing page.big-data moves (#168)
These pages moved out of
developer/integration/big-data/and the old URLs 404 in all five locales:database/storage/ai/Pages that are still under
big-data/(Kafka, Spark, and the rest) are not redirected.Pretty URLs that were 307
The worker now emits 301 for permanent canonicalization before Cloudflare’s asset handler can answer 307:
/ja/→/ja).html(/fr/installation/linux/quick-start.html→/fr/installation/linux/quick-start)/indexand/index.html(/ja/installation/linux/index→/ja/installation/linux)Root files such as
/baidu_verify_*.htmlare left alone./and/index.htmlstay 301 to/en.Other fixes
<title>s in each locale are now task-specific: installation chooser vs Helm install vs Operator install, Helm vs Operator overviews, Docker, rclone examples vs integration, Terraform examples vs integration, the two observability pages, the two pool-expansion pages, and the Japanese container install vs container upgrade titles. Short sidebar labels are preserved inmeta.json.U+202F) before:, so the table was dumped as a paragraph. The separator is ASCII---:again. The built page has 5<table>elements, including<th>Liste</th><th>Cas</th><th>Rôle</th>.[#…]in every locale (deployment comparison, storage/erasure, event/audit targets, CORS, Docker bind-mount, policy format, policy evaluation, KMS verification, known S3 differences, quick-start next steps). French and German links that still used translated fragments now point at those ids.<meta name="description">. The extra copy inpress.config.tsxis removed. Built homepages and the Docker page each have one description tag. Pages with no description still get the site-wide fallback.zhCNpreset.Verification
npm run buildsucceeded (267 Cloudflare rules).npm run docs:checkpassed.npm run test:worker: 20 passed, including the builtdist/public/_redirects.Local equivalent of
curl -sIagainst the worker and the built rules (status 301, one hop, query string kept):/de/installation/docker/index/de/installation/container/docker/de/installation/docker/index.html/de/installation/container/docker/zh/installation/docker/zh/installation/container/docker/de/upgrade-scale/upgrade//de/operations/upgrade/de/features/s3-compatibility//de/reference/s3-compatibility/de/management/bucket/index/de/administration/data/bucket/creation/ja/developer/api/ja/administration/protocols/s3/en/developer/integration/big-data/duckdb/en/developer/integration/database/duckdb/zh/developer/integration/big-data/trino//zh/developer/integration/database/trino/de/developer/integration/big-data/lakefs/de/developer/integration/storage/lakefs/en/developer/integration/big-data/mlflow/en/developer/integration/ai/mlflow/ja//ja/ja/installation/linux/index/ja/installation/linux/fr/installation/linux/quick-start.html/fr/installation/linux/quick-startEach target above exists as a built
index.html(HTTP 200 when the static file is served)./de/reference/s3-compatibilityand/de/developer/integration/database/duckdbare not redirected again./de/concepts/architectureis not sent to the German homepage./en/concepts/architecturestill 301s to/en.Built HTML checks: Docker
<title>isInstall and configure RustFS with Docker/RustFS mit Docker installieren und konfigurieren; Helm and Operator overviews no longer share概要;/de/installationhasid="deployment-mode-comparison"; the German Docker page renders “Suche”, “Auf dieser Seite”, and “Markdown kopieren”.