docs: correctness sweep — 15 verified fixes (Bucket 1) - #34781
Merged
Conversation
- ACL LaTeX template comment: seperate -> separate - CONTRIBUTING and docs site: builtin trust -> built-in trust (prose/table cells) Made-with: Cursor
hermes-ai/hermes-agent → NousResearch/hermes-agent (2 occurrences). The old org name leads to 404 pages.
The Google Workspace skill doc linked to https://github.com/nicholasgasior/gws which returns 404. The actual upstream CLI lives at https://github.com/googleworkspace/cli (the official Google Workspace CLI in Rust, dynamically built from the Google Discovery Service). Closes #28922
Fix download link for Linux/macOS binary in documentation.
- Replace outdated linear ordering in prompt-assembly guide with current stable/context/volatile tier contract from system_prompt.py - Clarify where memory/profile snapshots live versus skills guidance - Document that pre_llm_call context is user-message injection, not cached system-prompt mutation - Update architecture guide wording to reference system_prompt.py + prompt_builder.py tiered assembly Closes #34118
Use the current top-level fallback_providers list in fallback docs and keep fallback_model documented only as the legacy compatibility shape. Also align cron and delegation fallback coverage with current runtime behavior. Closes #19691 Co-authored-by: Codex <codex@openai.com>
…pages Fixes #24809 The docs site uses baseUrl='/docs/' but the <img> tags in sessions.md and cli.md referenced images at /img/docs/... which resolves to a 404. The static files are served at /docs/img/docs/... instead. Before: <img src="/img/docs/session-recap.svg"> → 404 After: <img src="/docs/img/docs/session-recap.svg"> → 200 Also fixes cli-layout.svg which had the same issue.
…how'
'hermes config get <key>' is referenced in three guides but is not a
valid subcommand. The valid subcommands under 'hermes config' are
{show,edit,set,path,env-path,check,migrate}. 'hermes config show' is
already used elsewhere in the docs (including 'hermes config show |
grep <pattern>' in the FAQ), so it's the idiomatic replacement.
- work-with-skills.md: 'View all skill config' now uses
'hermes config show | grep ^skills\.config'
- migrate-from-openclaw.md: session-policy check now reads the value
from 'hermes config show'
- configuring-models.md: 'inspect what the CLI will actually use'
now uses 'hermes config show | grep ^model\.'
Refs #30195
…e semantics The curator docs stated that any skill not bundled/hub-installed was 'agent-created' and subject to curation — including foreground-created skills and hand-written ones. Since PR #19621 (May 2026), the curator requires an explicit marker in .usage.json, which only the background self-improvement review fork sets. Changes: - Rewrite 'What agent-created means' to document the 3-step eligibility check (not bundled + not hub + created_by=agent marker) - Explain that foreground skill_manage(create) does NOT mark skills as agent-created (user-directed by design) - Warn that hand-written skills are NOT curated - Add note in Per-run reports explaining the '(not resolved)' display when no candidates exist (LLM pass skipped, not a config error) - Link to skill_provenance.py for the write-origin ContextVar Ref: PR #19621, tools/skill_provenance.py, tools/skill_manager_tool.py
Contributor
🔎 Lint report:
|
alt-glitch
added
type/docs
This was referenced May 29, 2026
19 tasks
This was referenced Jul 12, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
15 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Fixes 15 docs-correctness defects on the Docusaurus site — invalid commands, wrong defaults, broken images/links, and stale config shapes — each verified against current
mainbefore inclusion.This is the "Bucket 1" correctness sweep: 39 candidate PRs were checked claim-by-claim against the codebase; 15 were confirmed real and salvaged here, the rest dropped (false/stale claims) or held (bundled feature-code).
Changes
hermes config get→hermes config show(thegetsubcommand doesn't exist);hermes updateflags aligned to the real argparse (removed nonexistent--restart-gateway). (docs: replace invalid 'hermes config get <key>' with 'hermes config s… #30390 @Aman113114-IITD, docs(cli): align hermes update flags #21053 @TonyPepeBear)redact_secretsdocumented "off by default" but code default isTrue; flipped wording + syncedagent/redact.pydocstring (security-relevant).BROWSERBASE_SESSION_TIMEOUTdocumented in ms → corrected to seconds (max 21600), with provider/tool comments synced. (docs(security): fix secret redaction default docs #21621 @helix4u, docs: fix BROWSERBASE_SESSION_TIMEOUT unit (ms → seconds) #29928 @kurobaryo)useBaseUrl/ correct prefix; stale simplex download URL; dead google-workspace CLI link; quickstart channel link relabeled to the real playlist. (docs: fix session recap image path #27394 @nielskaspers, fix(docs): add baseUrl prefix to SVG image paths #24824 @hayka-pacha, Correct URL format for simplex-chat download #31723 @octavioturra, docs(google-workspace): fix dead gws CLI link to googleworkspace/cli #29012 @haran2001, fix(docs): replace YouTube channel link with actual playlist in Quickstart #30328 @alelpoan)fallback_model:to the currentfallback_providers:list;MESSAGING_CWDmarked deprecated across config/skill/example/nix. (fix(docs): align fallback provider config examples #26017 @aqilaziz, docs(config): deprecate MESSAGING_CWD guidance #22050 @helix4u)agent-createddefinition rewritten to match provenance code; stalehermes-aiorg links →NousResearch; "separate" typo + built-in hyphenation. (docs(prompt): align precedence docs with system prompt runtime #34137 @WadydX, docs(curator): align 'agent-created' definition with actual provenance semantics #29018 @Twanislas, fix(docs): correct stale GitHub org links in memory-providers.md #21283 @hllqkb, docs: fix ACL template typo; hyphenate built-in trust wording #13738 @HashClawAI)Validation
main(commands, config keys, env-var units, link targets, runtime ordering)npm run build)Dropped during verification (false/stale):
hermes loginrefs (command exists), "hallucinated backends" (all real), matrix!-prefix (dispatch is/), already-fixed TTS table + broken-link batch. Held for separate review: honcho cloud-disclosure (plugin code) and a Matrix device-verification script (362 LOC + tests).Infographic