MessageWeave/docs
anonsaber 5f182f97b0 docs: fix facts that the code contradicts, in both languages
SAFE_ROUTES has 19 entries (backends.js), not 18. reference.md and
reference.zh-CN.md both said '18 entries'; both now say 19.

reference §4 said the /api/enabled and /api/admin/session calls are
'admin-session Bearer-auth'd'. The code says otherwise: config_authorized
(notify.rs:423) accepts the shared worker token OR a valid admin session,
and create_admin_session (notify.rs:1187) is gated by worker_authorized
against the admin credential CONFIG_ENCRYPTION_KEY — it is what mints the
session, so it cannot be session-auth'd. Both languages now state the two
distinct credentials and why adding /api/enabled opens no new credential
path.

deployment §10.8 said every request-bearing entry point, listing /healthz
and /api/*, calls refresh_business_config. The actual 10 call sites cover
8 distinct paths (/ready, /worker, /reconcile, /push/jmap, /webhook/tg,
/api/config, /api/business-config, /api/telegram/register-webhook). GET
/healthz is a static 200 "ok" and never refreshes; /api/status,
/api/enabled, /api/push/register, /api/push/disable and the
/api/admin/session pair do not either. Both languages now list the real
set and name the exclusions.

design.md §5.7 listed the search trigger prefixes as English
'search'/'find'/'retrieval'; worker.rs:689 accepts the Chinese prefixes
搜索/查找/检索 and the help text states English aliases are not supported.
The two user-facing strings were also mistranslated: the empty-query
guidance prompt is 请提供搜索关键词,例如:/search 发票 (worker.rs:623)
and the no-match reply is 没有找到匹配「<query>」的邮件。
(worker.rs:792). The degraded-rendering marker is likewise a Chinese
string. SEARCH_SUBJECT_MAX=120 / SEARCH_PREVIEW_MAX=160 /
SEARCH_LIMIT=10 verified unchanged.

design.md §5.6/§5.7 were machine-translated from Chinese back into
English and were broken: 'the first 300 if it fails. characters', a
stray closing ** mid-sentence, '(none) deny_unknown_fields)' with a
mismatched paren, and 5 zero-width-space artefacts. charter.md:168 had a
broken '**Tables, lists, or values may not be copied across documents. **'
and opengaps.md had 4. All ZWSPs removed from docs/.

deployment.zh-CN.md §10.5/§10.6 were thin mistranslations: 'Worker 域'
for 'Worker URL', the debug-token requirement dropped entirely, and a
mangled '两者都使用用于验证部署的可用和版本'. Rewritten against the EN.

Also replaced a worker.rs:227 line anchor with the MetadataWorker doc
comment; that drops the repo's line-refs from 72 to 71, so new text no
longer adds to the drift surface.

No code changes; GATE-DOCS 6/6 (71 anchors, 455 section refs, 727 path
refs).
2026-10-01 18:47:05 +08:00
..
charter.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
charter.zh-CN.md docs: state the gateway's actual design intent — a free-tier load balancer, not a security layer 2026-10-01 17:47:49 +08:00
deployment.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
deployment.zh-CN.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
design.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
design.zh-CN.md docs: drop the SPA-footer deploy proof and reanchor notify.rs refs 2026-10-01 11:18:07 +08:00
opengaps.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
opengaps.zh-CN.md docs: reanchor the notify.rs and state.rs line refs the backend moved 2026-10-01 11:35:06 +08:00
reference.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
reference.zh-CN.md docs: fix facts that the code contradicts, in both languages 2026-10-01 18:47:05 +08:00
retired.md docs: reanchor the notify.rs and state.rs line refs the backend moved 2026-10-01 11:35:06 +08:00
retired.zh-CN.md docs: reanchor the notify.rs and state.rs line refs the backend moved 2026-10-01 11:35:06 +08:00