Skip to content

[docs-scanner] Deprecated feature still has detailed setup instructions #24183

@docker-agent

Description

@docker-agent

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:

  1. Be much shorter, with a clear migration path to alternatives
  2. Have a more prominent warning at the top discouraging new usage
  3. 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:

  1. Move the deprecation notice to the very top (before "Turn on Wasm workloads")
  2. Add information about alternatives or migration paths
  3. Consider collapsing the detailed setup/usage sections or moving them to an archive
  4. 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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions