Skip to content

Engdocs-3360 - #25726

Open
aevesdocker wants to merge 6 commits into
docker:mainfrom
aevesdocker:engdocs-3360
Open

Engdocs-3360#25726
aevesdocker wants to merge 6 commits into
docker:mainfrom
aevesdocker:engdocs-3360

Conversation

@aevesdocker

@aevesdocker aevesdocker commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

Description

Preview available here https://deploy-preview-25726--docsdocker.netlify.app/desktop/features/vmm/

Related issues or tickets

Reviews

  • Technical review
  • Editorial review
  • Product review

Signed-off-by: aevesdocker <allie.sadler@docker.com>
@netlify

netlify Bot commented Aug 5, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 3212391
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a73224288dbab000888095b
😎 Deploy Preview https://deploy-preview-25726--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@github-actions github-actions Bot added the area/desktop Issue affects a desktop edition of Docker. E.g docker for mac label Aug 5, 2026

@docker-agent docker-agent left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟡 NEEDS ATTENTION

This PR successfully expands the VMM page from Mac-only to cover Windows backends (WSL 2, Hyper-V, Docker VMM) and updates the settings, install, and permission docs consistently. Three issues were found in the new content.

Comment thread content/manuals/desktop/features/vmm.md Outdated
Comment thread content/manuals/desktop/features/vmm.md Outdated
Comment thread data/summary.yaml
@aevesdocker

Copy link
Copy Markdown
Contributor Author

@mark-dr @chelnak can I trouble you for a review please? 🙏

- Docker VMM does not support bind mount auto-shares. If you see a `file is not shared from the host` error, go to **Settings** > **Resources** > **File sharing** and add the directory you want to share.

Docker recommends transitioning to newer alternatives, such as Docker VMM or the Apple Virtualization framework, as they offer superior performance and ongoing support. Docker VMM, in particular, offers substantial speed improvements and a more efficient development environment, making it a compelling choice for developers working with Apple Silicon.
#### Mac only

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@chelnak are these issues still accurate or have they been resolved with the switch to the new Docker VMM?

@docker-agent docker-agent left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟡 NEEDS ATTENTION

2 medium-severity documentation issues found in the new VMM page content.

Comment thread content/manuals/desktop/features/vmm.md Outdated
Comment thread content/manuals/desktop/features/vmm.md

@docker-agent docker-agent left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟡 NEEDS ATTENTION

Comment thread content/manuals/desktop/features/vmm.md Outdated
Comment thread content/manuals/desktop/features/vmm.md Outdated
Comment thread data/summary.yaml
Comment thread content/manuals/desktop/settings-and-maintenance/settings.md Outdated
Comment thread content/manuals/desktop/features/vmm.md Outdated

@docker-agent docker-agent left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟡 NEEDS ATTENTION

This PR expands the VMM documentation from a Mac-only page to a cross-platform page covering both Mac and Windows. The structural improvements (tabs, cleaner prose, removal of marketing language, better organization) are good. Two issues need attention before merge.

Findings summary:

  • 1 HIGH: Version number contradiction (4.83 vs 4.86) that will confuse users about which Docker Desktop version introduced the new hypervisor
  • 2 MEDIUM: Page-level Beta badge misleads navigation users; alternative VMM sections lack switching instructions

Comment thread content/manuals/desktop/features/vmm.md Outdated
Comment thread content/manuals/desktop/features/vmm.md
Comment thread content/manuals/desktop/features/vmm.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/desktop Issue affects a desktop edition of Docker. E.g docker for mac

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants