docs: mark Podman support as experimental#73
Conversation
Docker is the primary tested runtime; Podman works but has rough edges worth flagging to users before they pick it. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Updates the project README to clarify that Podman support is experimental, positioning Docker as the primary tested container runtime.
Changes:
- Marks the Podman prerequisite as experimental in the Prerequisites list.
- Adds a README callout describing current Podman rough edges (volumes, SSH agent forwarding, rebuild flows) and requesting issue reports.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ------------- | ||
|
|
||
| - [Docker](https://docs.docker.com/get-docker/) or [Podman](https://podman.io/getting-started/installation) (see one-line install below if you don't have either) | ||
| - [Docker](https://docs.docker.com/get-docker/) or [Podman](https://podman.io/getting-started/installation) (experimental — see one-line install below if you don't have either) |
There was a problem hiding this comment.
The README intro still states the project is packaged into a container “(Docker or Podman)”, but this section now marks Podman as experimental. Consider updating the earlier mention to also reflect the experimental status so the README is internally consistent.
| > **Podman (Experimental):** Podman support is experimental. Docker is the | ||
| > primary tested runtime; Podman works but may have rough edges around volume | ||
| > mounts, SSH agent forwarding, or rebuild flows — please file an issue if you | ||
| > hit one. |
There was a problem hiding this comment.
Within this callout, the title uses “Podman (Experimental)” while the prerequisite bullet uses lowercase “(experimental …)”, and the sentence repeats “experimental” immediately after the title. It would be clearer to standardize the casing and avoid repeating the same word in the first sentence.
| > **Podman (Experimental):** Podman support is experimental. Docker is the | |
| > primary tested runtime; Podman works but may have rough edges around volume | |
| > mounts, SSH agent forwarding, or rebuild flows — please file an issue if you | |
| > hit one. | |
| > **Podman (Experimental):** Docker is the primary tested runtime; Podman may | |
| > have rough edges around volume mounts, SSH agent forwarding, or rebuild | |
| > flows — please file an issue if you hit one. |
- Reflect Podman's experimental status in the intro paragraph for consistency - Rewrite the callout to avoid repeating "experimental" after the title Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Summary
Test plan
🤖 Generated with Claude Code