Bug: docs mismatch #27

New issue

Open

opened 2026-06-08 14:10:21 +00:00 by fatmaebrahim · 0 comments

fatmaebrahim commented

2026-06-08 14:10:21 +00:00

Member

Description:

The documentation was written for an older single-crate version of the app and never updated after the refactor to a multi-crate workspace. Also, Rhai scripting was removed during the MCP refactor but docs still referenced it.
For example:

Port 4829 referenced in 20+ places across 7 docs files — actual is 8884
hero_browser_rhai referenced in CLAUDE.md, README.md, PURPOSE.md — crate was deleted
Rhai scripting guide, examples, and references throughout docs — Rhai is no longer used
make run/test referenced in 18+ places across 5 files — no Makefile exists
system.ping in README.md — actual method is rpc.health
Rust 1.82+ in README.md — actual is 1.96
--mcp/--show/--port flags referenced in 30+ places across 8 docs files — CLI doesn't have these flags
hero_browser_core and hero_browser_app crates not mentioned in docs
hero_browser_sdk described as "browser pool, activity log" — actually an auto-generated OpenRPC client
architecture.md and components.md describe old single-crate src/ layout instead of multi-crate workspace
running_with_visible_browser.md uses removed --show flag and Rhai scripts instead of MCP API

### Description: The documentation was written for an older single-crate version of the app and never updated after the refactor to a multi-crate workspace. Also, Rhai scripting was removed during the MCP refactor but docs still referenced it. For example: - Port 4829 referenced in 20+ places across 7 docs files — actual is 8884 - hero_browser_rhai referenced in CLAUDE.md, README.md, PURPOSE.md — crate was deleted - Rhai scripting guide, examples, and references throughout docs — Rhai is no longer used - make run/test referenced in 18+ places across 5 files — no Makefile exists - system.ping in README.md — actual method is rpc.health - Rust 1.82+ in README.md — actual is 1.96 - --mcp/--show/--port flags referenced in 30+ places across 8 docs files — CLI doesn't have these flags - hero_browser_core and hero_browser_app crates not mentioned in docs - hero_browser_sdk described as "browser pool, activity log" — actually an auto-generated OpenRPC client - architecture.md and components.md describe old single-crate src/ layout instead of multi-crate workspace - running_with_visible_browser.md uses removed --show flag and Rhai scripts instead of MCP API