Skip to content

docs(wiki): update Docker runbooks for the fish -> zsh volume rename #147

Description

@gatezh

The host-level Docker runbooks moved to the wiki in 2e1a3e7 ("docs: move host-level runbooks to the wiki and record the split rule"). Those pages reference the devcontainer history volumes by name:

  • *-fish-data — listed under volumes that must not be pruned (they hold credentials and history)
  • *-fish-history — listed under "worth backing up"

#146 renames those volumes. fish is removed from every image and replaced with zsh + oh-my-zsh, and the history volume is now *-zsh-history-* mounted at /commandhistory (matching the convention claude-bun already used).

So the wiki pages now name volumes that no longer exist. That is actively misleading in a runbook whose whole purpose is telling you what is unsafe to delete — someone following it would see no *-fish-data volume, assume nothing needs protecting, and prune the real one.

What needs changing

On the wiki pages that came from docs/disk-usage.md and docs/docker-maintenance-cheatsheet.md:

  • *-fish-data → *-zsh-history
  • Drop the separate *-fish-history entry (there was never a volume by that name; history now lives inside *-zsh-history)
  • Both the "do not prune" list and the "worth backing up" list are affected

Note on the old volumes

The rename orphans the existing *-fish-data-* volumes rather than deleting them. They keep whatever fish history they hold until pruned manually, so the wiki may want a one-line note that they are safe to remove once the new images are in use.

Per CLAUDE.md, every wiki page ends with a ## Sources section and a *Last verified:* date — both should cite #146.

Filed from #146, which could not make this change: the wiki is a separate git repository.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions