Skip to content

docs: align the site and repository docs with the product - #340

Merged
vishr merged 1 commit into
mainfrom
docs/refresh
Oct 18, 2026
Merged

vishr merged 1 commit into
mainfrom
docs/refresh

Conversation

@vishr

@vishr vishr commented Oct 18, 2026 •

Copy link
Copy Markdown
Member

Summary

A review of every site page (34) and repository document against the code on main. Pages state current behaviour in the present tense, each fact lives in its owning page with links elsewhere, and terms match the product.

  • MCP: client protocol requirement (2026-07-28), Origin validation on /mcp and /api/mcp, identity-based tool limits, cancellation, complete insufficient_scope challenges; sign-in rate limits stay IP-based.
  • Dashboards and chat: the Slow operations table, combined-filter diagnoses, empty chat views staying collapsed.
  • Operations and security: the public URL's security role, keeping /metrics private, insecure-cookie warnings, leaked setup URL recovery, self-signup granting paid AI access, OIDC eligibility without allowlists.
  • Status: the published benchmark cites v2026.10.8 and its evidence (the v2026.10.7 link was a 404).
  • Testing: service-map query reads, accessible-name checks, and the landing recording, encoding and upload steps.
  • Generated references (settings, MCP tools, routes, roles, .env.example) come from their updated sources.

An independent review checked the refresh for removed facts and unsupported claims; its nine findings are restored or corrected.

Verification

  • just docs-generate-check (13 pages), npm --prefix site run build with its checks, node site/scripts/check-benchmark-numbers.mjs, git diff --check.
  • Link check of the built site: 2,760 links, 0 broken internal links.
  • just check in the pre-push hook.

A review of every site page and repository document against the code on
main. Pages state current behaviour in the present tense, each fact
lives in its owning page with links elsewhere, and terms match the
product.

- MCP: client protocol requirement, Origin validation on both mounts,
  identity-based tool limits, cancellation, and complete scope
  challenges; sign-in rate limits stay IP-based.
- Dashboards and chat: the Slow operations table, combined-filter
  diagnoses, and empty views staying collapsed.
- Operations: public URL security role, metrics privacy, insecure cookie
  warnings, leaked setup URL recovery, self-signup granting paid AI
  access, and OIDC eligibility without allowlists.
- Status: the published benchmark now cites v2026.10.8 and its evidence.
- Testing: service-map query reads, accessible-name checks, and the
  landing recording, encoding and upload steps.

Generated references come from their updated sources.

Claude-Session: https://claude.ai/code/session_018HfyEXHyGD1utmKF4CQtyQ
@vishr
vishr merged commit 2af57d1 into main Oct 18, 2026
16 checks passed
@vishr
vishr deleted the docs/refresh branch October 18, 2026 00:56
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