← Back to PRs

#10466: docs(compaction): clarify valid modes and fix self-referential link

by chelixbot open 2026-02-06 14:53 View on GitHub →
docs stale
## Summary Clarifies the `compaction.mode` configuration by: 1. **Adding a "Compaction modes" section** documenting the valid values (`default`, `safeguard`) with descriptions 2. **Fixing a self-referential link** in the Configuration section that pointed to `/concepts/compaction` (itself) instead of the gateway configuration page ## Changes - New table documenting valid modes and their behavior - Updated link to point to `/gateway/configuration` with anchor to the compaction section ## Addresses Closes #10395 (compaction.mode documentation unclear) ## Testing - [x] Verified link target exists in docs/gateway/configuration.md - [x] Confirmed valid modes match zod schema (`z.literal("default"), z.literal("safeguard")`) --- 🤖 AI-assisted (Claude via OpenClaw). Lightly tested — docs change only. <!-- greptile_comment --> <h2>Greptile Overview</h2> <h3>Greptile Summary</h3> - Updates `docs/concepts/compaction.md` to clarify what compaction is and that it persists in JSONL history. - Adds a new “Compaction modes” section documenting valid `agents.defaults.compaction.mode` values (`default`, `safeguard`). - Replaces a self-referential link with a link intended to jump to the relevant section in the Gateway configuration docs. <h3>Confidence Score: 4/5</h3> - Mostly safe to merge, but contains a broken intra-doc anchor link that should be fixed to avoid confusing users. - Docs-only change with straightforward content updates; the only concrete issue found is the configuration link fragment not matching any anchor in the target page, which will break navigation. - docs/concepts/compaction.md (link fragment) <!-- greptile_other_comments_section --> <sub>(2/5) Greptile learns from your feedback when you react with thumbs up/down!</sub> <!-- /greptile_comment -->

Most Similar PRs