Skip to content

docs(i18n): fix broken internal links in translated docs#5161

Open
kostasuser01gr wants to merge 1 commit intoaden-hive:mainfrom
kostasuser01gr:docs/5156-fix-i18n-links
Open

docs(i18n): fix broken internal links in translated docs#5161
kostasuser01gr wants to merge 1 commit intoaden-hive:mainfrom
kostasuser01gr:docs/5156-fix-i18n-links

Conversation

@kostasuser01gr
Copy link
Contributor

Summary:

  • fix broken internal relative links in docs/i18n/*.md (es, hi, ja, ko, pt, ru, zh-CN)
  • normalize translated-doc links to correct paths for root docs and sibling docs
  • keep external links unchanged

Why:

  • translated docs were linking to non-existent relative paths from docs/i18n, causing dead links for onboarding and project policy docs

Validation:

  • Repro check before fix: broken links present in docs/i18n/*.md (e.g. docs/getting-started.md, CONTRIBUTING.md, SECURITY.md, LICENSE, README.md from i18n depth)
  • Post-fix link check: broken_internal_links=0 using a local relative-path existence scan over all markdown links in docs/i18n/*.md
  • make check (pass)
  • make test (pass: 711 passed, 55 skipped)
  • cd tools && uv sync --extra dev && uv run pytest tests/ -v (pass: 1572 passed, 91 skipped)
  • CI export validation script (pass/skip: no exports/ directory)

Fixes #5156

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.

[Bug]: Fix broken internal links in translated docs under docs/i18n

1 participant