Skip to content

docs(web): document dashboard RTL chat limits#29069

Closed
wesleysimplicio wants to merge 1 commit into
NousResearch:mainfrom
wesleysimplicio:codex/fix-web-rtl-chat
Closed

docs(web): document dashboard RTL chat limits#29069
wesleysimplicio wants to merge 1 commit into
NousResearch:mainfrom
wesleysimplicio:codex/fix-web-rtl-chat

Conversation

@wesleysimplicio

@wesleysimplicio wesleysimplicio commented May 20, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Addresses #29047.

Root cause

The detailed rationale from the original PR body is preserved below. This template update keeps the review structure consistent with #29640.

Fix

Why this shape

Issue #29047 reports that Arabic text in the dashboard chat pane appears left-to-right with disconnected letters. Replacing the chat surface is a larger product/design change, and the dashboard currently embeds the real TUI rather than a separate DOM chat implementation. This PR makes the limitation explicit and gives affected users a supported workaround through the documented HTTP API path.

Tests

The original PR body below contains the previous validation notes, commands, or test plan.
No code changes are introduced by this formatting update itself.

Related PRs / issues

Original body

## Related Issue

Addresses #29047.

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Refactor
  • Test update

What changed

The Web Dashboard guide now documents the current RTL and complex-script limitation of the /chat tab. The note explains that the tab renders the real Hermes TUI through xterm.js, which preserves terminal cell layout but does not provide normal browser paragraph direction or glyph shaping for Arabic, Persian, Urdu, Hebrew, and similar scripts.

It also points RTL-heavy workflows to the existing OpenAI-compatible API server path, where downstream clients can render messages in normal DOM controls such as textarea dir="auto" with unicode-bidi: plaintext.

Why

Issue #29047 reports that Arabic text in the dashboard chat pane appears left-to-right with disconnected letters. Replacing the chat surface is a larger product/design change, and the dashboard currently embeds the real TUI rather than a separate DOM chat implementation. This PR makes the limitation explicit and gives affected users a supported workaround through the documented HTTP API path.

Duplicate/overlap check

I searched the current open PR queue for direct overlap with Arabic, RTL, xterm, web dashboard, and #29047 before opening this.

Related but not duplicate:

How to Test

  • git diff --check -- website/docs/user-guide/features/web-dashboard.md
  • npm --prefix website ci
  • npm --prefix website run build

Build completed successfully. Docusaurus still reports pre-existing broken link/anchor warnings elsewhere in the docs site; this change does not introduce a new broken link.

Risk

Low. This is a docs-only clarification for an existing limitation and links to an already documented API-server workaround path.

Checklist

  • I have read the contributing guidelines
  • I searched existing issues and PRs for duplicates
  • The change is focused and minimal
  • I ran focused validation for the touched area
  • I documented pre-existing validation warnings separately from this change

Generated by Hermes Turbo

@alt-glitch alt-glitch added type/docs Documentation improvements comp/tui Terminal UI (ui-tui/ + tui_gateway/) P3 Low — cosmetic, nice to have labels May 20, 2026
@wesleysimplicio

Copy link
Copy Markdown
Contributor Author

Ready for maintainer review. This is docs-only and the current checks are green: docs-site-checks, history, nix ubuntu, and nix macos. Scope remains limited to documenting the existing RTL/complex-script limitation and the API-server workaround path.

@wesleysimplicio

Copy link
Copy Markdown
Contributor Author

Closing non-fix PR as requested — mantendo apenas PRs de fix.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/tui Terminal UI (ui-tui/ + tui_gateway/) P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants