docs: follow-up review findings

[skevetter]

Scope

Fix all 22 unhandled CodeRabbit inline findings from merged #1435. All were valid; none declined.

Per-finding triage

• 4226374837: valid, fixed. SSH host requires running environment.
• 4226374841: valid, fixed. Desktop launch respects selected IDE.
• 4226374843: valid, fixed. workspace volume seeder preserves unmanaged volumes and bind mounts.
• 4226374850: valid, fixed. context options separately control Git injection and SSH forwarding.
• 4226374858: valid, fixed. known-script loop continues after failure.
• 4226374862: valid, fixed. fallback excludes directories.
• 4226374864: valid, fixed. shutdown command can delete underlying storage.
• 4226374867: valid, fixed. quoted optional flags collapse arguments.
• 4226374871: valid, fixed. product name is VirtualBox.
• 4226374877: valid, fixed. shared machine deletion waits for last workspace.
• 4226374882: valid, fixed. source updater distinguishes releases and file sources.
• 4226374898: valid, fixed. Windows drive mount translation is implemented.
• 4226374904: valid, fixed. Windows executable and API must be reachable from Windows.
• 4226374907: valid, fixed. named machine start must name the new machine.
• 4226374910: valid, fixed. Windows machine API exposes PodmanPipe.
• 4226374913: valid, fixed. Docker output identifies containerd snapshotter.
• 4226374920: valid, fixed. metadata import carries state only with SnapshotRef.
• 4226444847: valid, fixed. installer skips missing checksum entry/tool.
• 4226444856: valid, fixed. host Compose tools do not install into containers.
• 4226444867: valid, fixed. login interactive shell loads startup PATH.
• 4226444882: valid, fixed. second add of existing provider fails.
• 4226444887: valid, fixed. Kaniko root requirements depend on build.

Validation

• 15 GitHub web-editor commits, all Verified.
• Remote file readback matches locally tested content exactly.
• Local changed-files pre-commit passed.
• Documentation link check: 0 errors. Production docs build passed.
• SSH example argument test passed with empty and multiple optional flags.
• Self-review checked the complete diff against implementation paths and upstream documentation.
• Windows/macOS tutorials were source-checked, not executed on those platforms.

Remote CI and final-head Greptile/CodeRabbit reviews are pending. No merge is authorized.

[netlify]

✅ Deploy Preview for devsydev ready!

Name	Link
🔨 Latest commit	9d08f54
🔍 Latest deploy log	https://app.netlify.com/projects/devsydev/deploys/6ac871103807ac0007050c27
😎 Deploy Preview	https://deploy-preview-1439--devsydev.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 52 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: 5c107cd1-903f-4fee-acc7-8cb9ec86fb7c

📥 Commits

Reviewing files that changed from the base of the PR and between 3ba1a43 and 9d08f54.

📒 Files selected for processing (15)

• sites/docs-devsy-sh/content/docs/developing-in-workspaces/create-a-workspace.mdx
• sites/docs-devsy-sh/content/docs/developing-in-workspaces/credentials.mdx
• sites/docs-devsy-sh/content/docs/developing-in-workspaces/dotfiles-in-a-workspace.mdx
• sites/docs-devsy-sh/content/docs/developing-providers/agent.mdx
• sites/docs-devsy-sh/content/docs/developing-providers/quickstart.mdx
• sites/docs-devsy-sh/content/docs/fragments/virtualbox-ubuntu-22.04.mdx
• sites/docs-devsy-sh/content/docs/getting-started/install.mdx
• sites/docs-devsy-sh/content/docs/managing-machines/what-are-machines.mdx
• sites/docs-devsy-sh/content/docs/managing-providers/manage-providers.mdx
• sites/docs-devsy-sh/content/docs/troubleshooting/linux-troubleshooting.mdx
• sites/docs-devsy-sh/content/docs/troubleshooting/troubleshooting.mdx
• sites/docs-devsy-sh/content/docs/tutorials/docker-provider-via-wsl.mdx
• sites/docs-devsy-sh/content/docs/tutorials/podman-provider-setup.mdx
• sites/docs-devsy-sh/content/docs/tutorials/reduce-build-times-with-cache.mdx
• sites/docs-devsy-sh/content/docs/what-is-devsy.mdx

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[netlify]

✅ Deploy Preview for images-devsy-sh canceled.

Name	Link
🔨 Latest commit	9d08f54
🔍 Latest deploy log	https://app.netlify.com/projects/images-devsy-sh/deploys/6ac87110f222af000884ba4c

[skevetter]

@greptileai review

[greptile-apps]

Confidence Score: 5/5

[Low impact] The documentation changes appear safe to merge.

Summary

This PR corrects documentation about workspace resets, credentials, dotfiles, provider setup, and platform-specific commands.

• Clarifies when workspace data survives and when an IDE opens.
• Separates Git credential injection from SSH agent forwarding.
• Updates Windows Podman setup and the SSH example’s optional flags.
• No actionable issues were found in the changed lines.

_{Reviews (1) · Last reviewed commit: "docs: correct podman provider setup guid..." · Reviewed by Greptile}