Skip to main content
← Back to list
01Issue
FeatureShippedSwamp Club
Assigneesstack72

Relationships

#1290 Docs: update manual to document --yes/-y as the standard confirmation-skip flag

Opened by stack72 · 7/20/2026· Shipped 7/20/2026

After swamp-club/swamp#1251 standardized --yes/-y as the universal confirmation-skip flag (with --force and --confirm as backward-compatible aliases), the user-facing manual needs updating.

Pages that reference --force for confirmation skipping (should mention --yes as primary):

  • reference/data.md — data delete, data gc, data prune flag tables and prose
  • reference/operational-commands.md — run gc flag table
  • reference/doctor.md — doctor extensions --repair --force examples and prose
  • reference/vaults.md — vault put, vault read-secret, vault delete flag tables and prose
  • reference/workflows.md — workflow run gc flag table

Pages that reference --confirm (should mention --yes as the primary alias):

  • reference/datastore-configuration.md — namespace migrate and unset flag tables
  • how-to/giga-swamp/add-namespace.md, set-up-giga-swamp.md, merge-repos.md, remove-namespace.md — --confirm examples

Pages where --force is correct as-is (no changes needed):

  • reference/repository-configuration.md — repo init --force (reinitialize semantics)
  • reference/datastore-configuration.md — datastore lock release --force (breakglass)
  • how-to/swamp-serve/reload-extensions-without-restart.md — extension pull --force (overwrite)

How-to pages that use --force in examples (could be updated to use --yes):

  • how-to/core-operations/query-and-manage-data.md — data prune --force
  • how-to/troubleshoot-your-swamp-repo.md — mentions --force for CI non-interactive
  • how-to/vaults/migrate-vault.md, auto-refresh-credentials.md — vault commands with --force

All existing flag references still work (backward-compatible), so this is not urgent — just a consistency update.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 3 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

7/20/2026, 9:35:10 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack727/20/2026, 9:05:31 PM

Sign in to post a ripple.