Skip to content

docs: batch 6 — leftover audit items (FAQ link, gateway-config ref, Matrix E2EE, phone examples) - #82182

Open
ewardGPT wants to merge 1 commit into
NousResearch:mainfrom
ewardGPT:docs/audit-fixes-batch6
Open

docs: batch 6 — leftover audit items (FAQ link, gateway-config ref, Matrix E2EE, phone examples)#82182
ewardGPT wants to merge 1 commit into
NousResearch:mainfrom
ewardGPT:docs/audit-fixes-batch6

Conversation

@ewardGPT

@ewardGPT ewardGPT commented Aug 9, 2026

Copy link
Copy Markdown

Summary

Sixth batch from the full docs audit (all 200 pages, 142 findings). Independent of PR #82150 (batches 1-4) and #82174 (batch 5) — this branch was cut from upstream/main.

Changes (8 files, +49/-9)

  • faq.md: Python Library guide link pointed at features/code-execution.md (documents the execute_code tool, not the AIAgent library API) → now guides/python-library.md (verified the file exists at that path).
  • slash-commands.md: ~/.hermes/gateway-config.yamlconfig.yaml. That filename appears nowhere else in the docs; every platform page uses config.yaml for the extra: block.
  • matrix.md: E2EE troubleshooting told users to set legacy MATRIX_ENCRYPTION=true as the primary fix — now MATRIX_E2EE_MODE=required (the current knob) with the legacy var noted as back-compat.
  • signal.md: replaced invalid example +0987654321 with valid fictional E.164 numbers.
  • Masked phone sweep re-applied (4 files) — this branch predates the batch-5 sweep (upstream/main never received it); added fix-masked-phones.py here too.

Verification

  • python-library.md exists at the new path; rate_limit default 30/min verified in gateway/platforms/webhook.py (docs already correct — no change needed there).
  • Masked-phone scan clean (0 remaining); llms.txt generator rebuilds clean.

…atrix E2EE, phones)

Sixth batch from the docs audit — remaining low-priority items, all verified.

- faq.md: Python Library guide link pointed at features/code-execution.md
  (documents the execute_code tool, not the AIAgent library API) -> now
  guides/python-library.md (verified file exists).
- slash-commands.md: "~/.hermes/gateway-config.yaml" -> config.yaml — that
  file exists nowhere else in the docs; every platform page uses config.yaml.
- matrix.md: E2EE troubleshooting still told users to set legacy
  MATRIX_ENCRYPTION=true as the primary fix; now points at MATRIX_E2EE_MODE
  (required) with the legacy var noted as back-compat.
- signal.md: replaced invalid +0987654321 example number with valid fictional
  E.164 (+15550123456,+15550987654).
- Masked phone sweep re-applied to this upstream-based branch (4 files) —
  this branch predates the batch-5 sweep; added fix-masked-phones.py here too.

Verified: python-library.md exists at the new path; rate_limit default 30/min
in code matches the docs; webhook env-var table complete (rate_limit /
max_body_bytes are config keys, correctly documented in the Security section).
@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have area/config Config system, migrations, profiles platform/matrix Matrix adapter (E2EE) platform/signal Signal CLI adapter platform/sms SMS (Twilio) adapter needs-decision Awaiting maintainer decision before any implementation labels Aug 9, 2026
@alt-glitch

Copy link
Copy Markdown
Collaborator

This was generated by AI during triage.

Related: #82150 and #82174 are adjacent docs-audit batches. #82182 and #82174 both include the masked-phone sweep, so maintainers should sequence or consolidate that overlap.

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

Labels

area/config Config system, migrations, profiles needs-decision Awaiting maintainer decision before any implementation P3 Low — cosmetic, nice to have platform/matrix Matrix adapter (E2EE) platform/signal Signal CLI adapter platform/sms SMS (Twilio) adapter type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants