Skip to content

fix(website): correct false claims and stale numbers in live docs#964

Merged
igorls merged 1 commit intodevelopfrom
fix/website-false-claims
Apr 17, 2026
Merged

fix(website): correct false claims and stale numbers in live docs#964
igorls merged 1 commit intodevelopfrom
fix/website-false-claims

Conversation

@igorls
Copy link
Copy Markdown
Member

@igorls igorls commented Apr 17, 2026

Summary

The live docs site had several false claims, stale numbers, and unverifiable marketing absolutes. This PR fixes them without changing any product behavior — it's docs/copy only.

Factual fixes

  • Landing page terminal demo showed a mempalace remember command that doesn't exist in cli.py. Replaced with real mempalace mine ./notes.
  • MCP tool count: 19 → 29 across mcp-integration.md, claude-code.md, openclaw.md, and modules.md. Verified by counting "mempalace_*" entries in the TOOLS dict of mcp_server.py.
  • Tool Overview in mcp-integration.md was missing entire categories. Added Drawers (get_drawer, list_drawers, update_drawer), Tunnels (create_tunnel, list_tunnels, delete_tunnel, follow_tunnels), and System (hook_settings, memories_filed_away, reconnect).
  • Wake-up token range ~170–900~600–900 in cli.md, api-reference.md, and python-api.md to match the CLI help text in cli.py and the concept doc in memory-stack.md.
  • Gemini CLI command in gemini-cli.md had ambiguous flag order — --scope user trailing after -m mempalace.mcp_server could be parsed as a module arg. Moved --scope user before the target name and added the standard -- separator.

Marketing softening (unverifiable absolutes)

  • "forever available. One hundred percent recall by design." → "permanent. Designed for total recall."
  • "retrieved <50 ms" → "retrieved instantly" (no published latency benchmark backed the 50 ms figure)
  • "Ninety-plus percent compression... One hundred percent fidelity" → "Dense compression... Full fidelity"
  • "A two-thousand-year-old memory technique" → "An ancient memory technique" (method of loci is ~2,500 years old, and CLAUDE.md already says "thousands of years")
  • "Tens of thousands of entries, one pass" → "Thousands of entries, one pass"
  • "in a single breath" → "in a single pass"

Test plan

  • cd website && bun run dev and spot-check the landing page — hero copy, terminal demo, dialect caption, and the "without/with mempalace" comparison pane
  • Build the VitePress site (bun run build) and confirm no broken links
  • Re-read mcp-integration.md top-to-bottom — tool count matches mcp-tools.md reference
  • Verify the Gemini CLI command from gemini-cli.md against current Gemini CLI docs if you have an install handy

- Landing: replace nonexistent `mempalace remember` CLI demo with real
  `mempalace mine ./notes`
- Landing: soften unverifiable absolutes ("forever available",
  "100% recall by design", "<50 ms", "90%+ compression",
  "two-thousand-year-old", "tens of thousands of entries")
- MCP tool count: 19 → 29 across mcp-integration, claude-code, openclaw,
  and modules; expand tool overview with Drawers, Tunnels, and System
  categories to match mcp_server.py
- Wake-up token range: ~170–900 → ~600–900 in cli/api-reference/python-api
  to match cli.py help text and concept docs
- Gemini CLI: move `--scope user` before target name and add `--`
  separator so `-m mempalace.mcp_server` isn't parsed as Gemini flags
@igorls igorls merged commit 596f3d3 into develop Apr 17, 2026
6 checks passed
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.

1 participant