Skip to content

docs: add describe annotation to snapshot config field#17861

Merged
rekram1-node merged 4 commits intoanomalyco:devfrom
altendky:docs-snapshot-config-describe
Mar 17, 2026
Merged

docs: add describe annotation to snapshot config field#17861
rekram1-node merged 4 commits intoanomalyco:devfrom
altendky:docs-snapshot-config-describe

Conversation

@altendky
Copy link
Contributor

@altendky altendky commented Mar 17, 2026

Issue for this PR

Closes #17863

Related: #4753 (prior attempt), #10626, #6845, #3182, #17753, #16336 (users struggling with snapshot disk usage)

Type of change

  • Documentation

What does this PR do?

The snapshot config field was added in 28a4517 but was never documented. This PR:

  1. Adds a .describe() annotation to the snapshot schema field in config.ts, matching the pattern used by other config fields.
  2. Adds a "Snapshot" section to config.mdx explaining what snapshots do, how to disable them, and the tradeoff (no undo/revert when disabled). Placed between Keybinds and Autoupdate sections.

How did you verify your code works?

Read the schema definition and confirmed the .describe() follows the same chaining pattern as adjacent fields. Verified the config.mdx section renders consistently with surrounding sections.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@github-actions github-actions bot added needs:compliance This means the issue will auto-close after 2 hours. contributor labels Mar 17, 2026
@altendky altendky marked this pull request as draft March 17, 2026 00:26
@github-actions github-actions bot removed the needs:compliance This means the issue will auto-close after 2 hours. label Mar 17, 2026
@github-actions
Copy link
Contributor

Thanks for updating your PR! It now meets our contributing guidelines. 👍

@altendky altendky marked this pull request as ready for review March 17, 2026 00:36
@rekram1-node rekram1-node merged commit 544315d into anomalyco:dev Mar 17, 2026
4 checks passed
ConanXu-math pushed a commit to ConanXu-math/opencode that referenced this pull request Mar 17, 2026
Co-authored-by: Aiden Cline <63023139+rekram1-node@users.noreply.github.com>
AvatarGanymede pushed a commit to AvatarGanymede/opencode-dev that referenced this pull request Mar 19, 2026
Co-authored-by: Aiden Cline <63023139+rekram1-node@users.noreply.github.com>
demostanis pushed a commit to demostanis/opencode that referenced this pull request Mar 19, 2026
Co-authored-by: Aiden Cline <63023139+rekram1-node@users.noreply.github.com>
demostanis pushed a commit to demostanis/opencode that referenced this pull request Mar 20, 2026
Co-authored-by: Aiden Cline <63023139+rekram1-node@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[FEATURE]: Document snapshot config option

2 participants