Skip to content

docs: fix broken dashboard image on i18n pages#38031

Merged
altaywtf merged 1 commit intoopenclaw:mainfrom
angrybirddd:fix/docs-broken-dashboard-image
Mar 6, 2026
Merged

docs: fix broken dashboard image on i18n pages#38031
altaywtf merged 1 commit intoopenclaw:mainfrom
angrybirddd:fix/docs-broken-dashboard-image

Conversation

@angrybirddd
Copy link
Copy Markdown
Contributor

@angrybirddd angrybirddd commented Mar 6, 2026

Summary

  • Problem: Dashboard screenshot uses relative path src="whatsapp-openclaw.jpg" which 404s on zh-CN and ja-JP pages because Mintlify prepends the locale subdirectory to the CDN path.
  • Why it matters: i18n readers see a broken image on the landing page.
  • What changed: Relative image path → absolute /whatsapp-openclaw.jpg in all three locale index files.
  • What did NOT change (scope boundary): No content, layout, or config changes. English page rendered identically before and after.

Change Type (select all)

  • Docs

Scope (select all touched areas)

  • UI / DX

Linked Issue/PR

None — discovered during docs review.

User-visible / Behavior Changes

Dashboard screenshot now renders correctly on zh-CN and ja-JP landing pages.

Security Impact (required)

  • New permissions/capabilities? No
  • Secrets/tokens handling changed? No
  • New/changed network calls? No
  • Command/tool execution surface changed? No
  • Data access scope changed? No

Repro + Verification

Steps

  1. Open https://docs.openclaw.ai/zh-CN (or ja-JP)
  2. Scroll to "Dashboard" section
  3. Before: image 404. After: image renders.

Evidence

  • Screenshot/recording

Before (zh-CN): image broken (relative path resolves to /zh-CN/whatsapp-openclaw.jpg → 404)
After (zh-CN): image loads (/whatsapp-openclaw.jpg → 200)

Human Verification (required)

  • Verified scenarios: Confirmed other images on the same page already use absolute paths (/assets/openclaw-logo-text-dark.png), confirming this is the intended pattern.
  • Edge cases checked: All three locales (en, zh-CN, ja-JP) updated.
  • What you did not verify: Did not run full docs site build locally.

Compatibility / Migration

  • Backward compatible? Yes
  • Config/env changes? No
  • Migration needed? No

Failure Recovery (if this breaks)

  • How to disable/revert this change quickly: Revert this single commit.
  • Files/config to restore: docs/index.md, docs/zh-CN/index.md, docs/ja-JP/index.md
  • Known bad symptoms reviewers should watch for: Image not loading on English root page (unlikely — absolute paths work everywhere).

Risks and Mitigations

None.

@angrybirddd
docs: fix broken dashboard image on i18n pages
7decfb2 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
@openclaw-barnacle openclaw-barnacle bot added docs Improvements or additions to documentation size: XS labels Mar 6, 2026
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Mar 6, 2026

Greptile Summary

This PR fixes broken dashboard images on the i18n (zh-CN and ja-JP) documentation landing pages by changing a relative image path (whatsapp-openclaw.jpg) to an absolute path (/whatsapp-openclaw.jpg) in all three locale index files.

  • The fix is correct: Mintlify and similar static site generators prepend the locale subdirectory to relative paths, causing the image to resolve to /zh-CN/whatsapp-openclaw.jpg and /ja-JP/whatsapp-openclaw.jpg (both 404). The absolute path /whatsapp-openclaw.jpg resolves correctly from any locale.
  • The English docs/index.md was also updated for consistency.
  • The change is in line with the existing pattern used by other images on the same pages (e.g., /assets/openclaw-logo-text-dark.png), and all internal links on these pages already use absolute paths.
  • No logic, content, or configuration changes are included.

Confidence Score: 5/5

  • This PR is safe to merge — it is a minimal, targeted docs fix with no risk of regression.
  • The change is a single-character addition (/) repeated identically across three files. It correctly addresses a well-understood i18n path resolution issue, is consistent with the existing absolute-path pattern on the same pages, and carries no risk to functionality, security, or content.
  • No files require special attention.

Last reviewed commit: 7decfb2

@altaywtf altaywtf self-assigned this Mar 6, 2026
@altaywtf altaywtf merged commit 7ce79c8 into openclaw:main Mar 6, 2026
24 checks passed
@altaywtf
Copy link
Copy Markdown
Member

altaywtf commented Mar 6, 2026

Thank you @angrybirddd,

Confirmed it was broken, and will be fixed with your changes:
CleanShot 2026-03-07 at 00 22 42@2x

Please attach screenshots to these type of PRs if you can in the future.

Cheers!

mrosmarin added a commit to mrosmarin/openclaw that referenced this pull request Mar 6, 2026
@mrosmarin
Merge branch 'main' into feat/add-extraargs-to-zod-schema-tests
dd3e37e 
* main:
  fix: add no-ci-pr auto-response label
  docs: add changelog entry for Feishu timeouts (openclaw#38356)
  fix(feishu): remove invalid timeout properties from SDK method calls (openclaw#38267)
  docs: fix broken dashboard image on i18n pages (openclaw#38031)
@alexyyyander alexyyyander mentioned this pull request Mar 7, 2026
Closed
vincentkoc pushed a commit to BryanTegomoh/openclaw-fork that referenced this pull request Mar 8, 2026
@angrybirddd @vincentkoc
docs: fix broken dashboard image on i18n pages (openclaw#38031)
3a78f2b 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
Saitop pushed a commit to NomiciAI/openclaw that referenced this pull request Mar 8, 2026
@angrybirddd
docs: fix broken dashboard image on i18n pages (openclaw#38031)
c0735e7 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
jenawant pushed a commit to jenawant/openclaw that referenced this pull request Mar 10, 2026
@angrybirddd @jenawant
docs: fix broken dashboard image on i18n pages (openclaw#38031)
06fe6d3 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
@angrybirddd angrybirddd deleted the fix/docs-broken-dashboard-image branch March 10, 2026 15:59
@angrybirddd
Copy link
Copy Markdown
Contributor Author

angrybirddd commented Mar 10, 2026

Hi @altaywtf ,
Thanks for your reminding. The screenshots will be helpful for UI.
I re-read the https://github.com/openclaw/openclaw/blob/main/CONTRIBUTING.md, This rule is already included in it 👍

Include screenshots — one showing the problem/before, one showing the fix/after (for UI or visual changes)

BTW: I created a new PR. A very small change: #42297

@alexey-pelykh alexey-pelykh mentioned this pull request Mar 10, 2026
Closed
dhoman pushed a commit to dhoman/chrono-claw that referenced this pull request Mar 11, 2026
@angrybirddd @dhoman
docs: fix broken dashboard image on i18n pages (openclaw#38031)
59d10a6 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
senw-developers pushed a commit to senw-developers/va-openclaw that referenced this pull request Mar 17, 2026
@angrybirddd @Shlemon
docs: fix broken dashboard image on i18n pages (openclaw#38031)
10452c6 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
V-Gutierrez pushed a commit to V-Gutierrez/openclaw-vendor that referenced this pull request Mar 17, 2026
@angrybirddd @V-Gutierrez
docs: fix broken dashboard image on i18n pages (openclaw#38031)
bc23b0e 
The dashboard screenshot uses a relative path `src="whatsapp-openclaw.jpg"`
which resolves correctly on the English root page but produces 404 on
zh-CN and ja-JP pages because Mintlify prepends the language subdirectory
to the CDN path.

Change to absolute path `/whatsapp-openclaw.jpg` in all three index files,
consistent with other images on the same page that already use absolute
paths (e.g. `/assets/openclaw-logo-text-dark.png`).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@altaywtf altaywtf

Labels

docs Improvements or additions to documentation size: XS

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@angrybirddd @altaywtf