-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
File: content/manuals/desktop/features/wasm.md
Issue
The page prominently states that Wasm workloads are deprecated:
Wasm workloads are deprecated and will be removed in a future Docker Desktop release. This feature is no longer actively maintained.
However, the page then provides extensive setup instructions, usage examples, and troubleshooting guidance. This creates confusion about whether users should be using this feature at all.
For a deprecated feature that will be removed, the page should either:
- Be much shorter, with a clear migration path to alternatives
- Have a more prominent warning at the top discouraging new usage
- Focus on how to migrate away from Wasm workloads rather than how to set them up
Suggested fix
Restructure the page to prioritize the deprecation notice and migration guidance:
- Move the deprecation notice to the very top (before "Turn on Wasm workloads")
- Add information about alternatives or migration paths
- Consider collapsing the detailed setup/usage sections or moving them to an archive
- If there's a timeline for removal, include it
The current structure encourages users to adopt a deprecated feature, which wastes their time and creates future migration work.
Found by nightly documentation freshness scanner