Skip to content

[docs-scanner] Incorrect em dashes in installer flags break commands #25717

Description

@docker-agent

File: content/manuals/desktop/troubleshoot-and-support/faqs/general.md

Issue

The installer command flags use em dashes (—) instead of double hyphens (--), which will cause the commands to fail when users copy them.

Line 99 (inline code):

—user=<userid>

Line 118 (inline code):

—always-run-service

Line 121 (code block):

$ "Docker Desktop Installer.exe" install —always-run-service

Why this matters

Users copying these commands will get syntax errors because the installer expects --user and --always-run-service with double hyphens, not em dashes. The em dash character (—, Unicode U+2014) is visually similar but functionally different from the double hyphen (--) that command-line tools expect.

This is particularly problematic because:

  1. The inline code appears in explanatory text that users might copy
  2. The Windows code block has the wrong character, so users copying the entire command will fail
  3. The Mac code block is correct (--user), creating an inconsistency that suggests the em dashes are typos

Suggested fix

Replace all em dashes with double hyphens in both inline code and code blocks:

Line 99: Change —user=<userid> to --user=<userid>
Line 118: Change —always-run-service to --always-run-service
Line 121: Change —always-run-service to --always-run-service


Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions