Clarify sandbox usage and workflow docs#25561
Conversation
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
The refactoring cleanly separates Usage (command primer) from Workflow patterns (scenario guidance). All internal link updates point to valid anchors in the target files, no pages were deleted without redirects, and the new content follows Docker's style guide without AI-isms or style violations.
docker-agent
left a comment
docker-agent
left a comment
There was a problem hiding this comment.
Assessment: 🟢 APPROVE
This PR reorganizes the Docker Sandboxes documentation by splitting content between usage.md (command-oriented primer) and workflows.md (scenario-oriented guide). The restructuring is clean and well-executed.
Checked areas:
- ✅ No vendored/generated content touched
- ✅ No pages removed or moved (no missing redirects needed)
- ✅ No AI-isms or hedge words in added lines
- ✅ No improper bold formatting
- ✅ Cross-references updated correctly (all new anchors verified to exist in destination files)
- ✅ Front matter updated appropriately
- ✅ Scope preservation:
usage.mdappropriately narrowed to a command reference,workflows.mdexpanded with scenario guidance - ✅ Content accuracy: moved content matches originals; commands and flags are correct
- ✅ Markdown formatting: no broken syntax or unclosed code blocks
No issues found in the changed code. The PR achieves its stated goal of separating command-reference content from scenario guidance.
dvdksn
force-pushed
the
codex/refactor-sbx-usage-workflows
branch
from
e0d0279 to
61a2c74
Compare
The usage and workflow pages overlapped across Git, CI, ports, and team setup guidance. Refactor Usage into a command primer, move scenario guidance to Workflow patterns, and update cross-references.
Usage still had a Git workflow section after the workflow refactor. Rename it to Git workspace modes and keep only the basic direct versus clone-mode command behavior.
dvdksn
force-pushed
the
codex/refactor-sbx-usage-workflows
branch
from
61a2c74 to
0392cff
Compare
3 participants
Summary
Refactor the Docker Sandboxes usage and workflow pages so Usage acts as a command primer and Workflow patterns carries scenario guidance for Git, local services, CI, credentials, and team setup.
Generated by Codex