Skip to content

docs: fix documentation/code inconsistencies, audit round 3 (#36051 salvage) - #65539

Merged
teknium1 merged 4 commits into
mainfrom
salvage/36051-docs-audit-r3
Jul 16, 2026
Merged

docs: fix documentation/code inconsistencies, audit round 3 (#36051 salvage)#65539
teknium1 merged 4 commits into
mainfrom
salvage/36051-docs-audit-r3

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

Docs audit round 3: reconciles documentation with actual code across 17 files — stale constants, wrong defaults, nonexistent env vars, and command-surface drift.

Salvage of #36051 by @kocaemre (rounds 1 #22784 and 2 #22858 both merged) — original branch was CONFLICTING. Cherry-picked with authorship preserved; every conflicted hunk re-verified against current code (code is the source of truth), then refreshed values that drifted since the PR was opened.

Changes

  • Verified-correct fixes kept: TERMINAL_ENV (not TERMINAL_BACKEND), hermes auth subcommand list (incl. spotify, no login), hermes pairing approve (no gateway pair), DEFAULT_MINIMAX_MODEL speech-02-hd, SMS_WEBHOOK_HOST default 127.0.0.1, removal of nonexistent X-Hermes-Model header + HERMES_CORE_TOOLS env row, image-gen model list.
  • Refreshed against current main (moved since May 31): SCHEMA_VERSION 14→21 (+ v16/v18/v20 migration notes), dashboard themes 7→8 (Nous Blue row kept).
  • Dropped from the original PR: HERMES_MD_NAMES env-var row (no such env var — _HERMES_MD_NAMES is an internal constant), stale HERMES_WRITE_SAFE_ROOT "requires approval" wording (code hard-denies).
  • scripts/release.py: AUTHOR_MAP entry.

Validation

Docs-only + one AUTHOR_MAP line. Touched pages MDX-compile; environment-variables.md has a pre-existing compile quirk identical on unmodified main (not introduced here).

Infographic

infographic

@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have labels Jul 16, 2026
kocaemre and others added 4 commits July 16, 2026 04:40
Cross-checked website/docs against the source at main HEAD and corrected
documented commands, env vars, config keys, headers, and default values
that don't match the code. Docs-only; no behavioral changes.

Refs #36048

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
PR #36051's values went stale since May 31: session-store SCHEMA_VERSION
is now 21 (PR said 14), and the dashboard ships 8 built-in themes
(PR said 7). Also document the v16/v18/v20 data migrations added since.
@teknium1
teknium1 force-pushed the salvage/36051-docs-audit-r3 branch from d2738cc to 3ccefb7 Compare July 16, 2026 11:41
@teknium1
teknium1 merged commit a79b818 into main Jul 16, 2026
31 checks passed
@teknium1
teknium1 deleted the salvage/36051-docs-audit-r3 branch July 16, 2026 11:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants