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:
- The inline code appears in explanatory text that users might copy
- The Windows code block has the wrong character, so users copying the entire command will fail
- 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
File:
content/manuals/desktop/troubleshoot-and-support/faqs/general.mdIssue
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):
Line 118 (inline code):
Line 121 (code block):
Why this matters
Users copying these commands will get syntax errors because the installer expects
--userand--always-run-servicewith 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:
--user), creating an inconsistency that suggests the em dashes are typosSuggested 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-serviceto--always-run-serviceLine 121: Change
—always-run-serviceto--always-run-serviceFound by nightly documentation quality scanner