Skip to content

Pin the docs to claude-sandbox 5.1.1, the first release whose pins work with --minimal - #113

Merged
gilesknap merged 1 commit into
mainfrom
docs/pin-5.1.x
Oct 10, 2026
Merged

gilesknap merged 1 commit into
mainfrom
docs/pin-5.1.x

Conversation

@gilesknap

Copy link
Copy Markdown
Contributor

The how-to pages pinned claude-sandbox 5.0.0 and, a few lines later, told readers to add --minimal. 5.0.0's install does not know that flag: its argument loop ends in unknown argument; exit 2, so a set -euo pipefail postCreate that follows both pieces of advice fails on rebuild.

This bumps every user-facing pin to 5.1.1, the release to be tagged right after this merges (it will carry this change and #106):

  • docs/how-to/sandbox-a-team-devcontainer.md: the uvx claude-sandbox== line in the postCreate example.
  • docs/how-to/install-without-uv.md: the pipx and venv pip install pins, and the git clone --branch tag.
  • docs/how-to/upgrade.md: the uv tool install claude-sandbox== example.
  • docs/reference/whats-installed.md: "The VS Code extension will install this way" becomes "installs this way"; the extension now installs with --minimal.

Left as they are: the 5.0.0 beta examples in upgrade.md (they show how to name a prerelease, and those betas exist), the "Upgrading from 4.x" history, and the ADRs.

The pins point at a tag that does not exist until 5.1.1 is cut, so the published docs will name an uninstallable version until the release is out. Nothing in CI checks pins against PyPI or tags. sphinx-build -b html -W --keep-going docs passes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AJKFfYT7qdSfhkZGj6syCo

🤖 Generated with Claude Code

https://claude.ai/code/session_01AJKFfYT7qdSfhkZGj6syCo

…rk with --minimal

5.0.0 rejects --minimal (exit 2), so docs that pinned 5.0.0 while
advising --minimal gave a failing postCreate. Pin 5.1.1, which will be
tagged right after this merges.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AJKFfYT7qdSfhkZGj6syCo
@gilesknap
gilesknap merged commit a113604 into main Oct 10, 2026
14 checks passed
@gilesknap
gilesknap deleted the docs/pin-5.1.x branch October 10, 2026 20:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant