Skip to content

[docs-scanner] Ambiguous version qualifier for MSI all-users installation requirement #26241

Description

@docker-agent

File: content/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md

Issue

Line 22 contains an ambiguous version qualifier that contradicts information in the FAQ:

The MSI installer only supports all-users installations (version 4.92 and later).

This parenthetical "(version 4.92 and later)" suggests that the all-users-only restriction was introduced in version 4.92, implying the MSI may have supported per-user installations in earlier versions.

However, the FAQ (faq.md lines 70-82) makes it clear that:

  • The MSI has never supported per-user installations
  • Version 4.92 only introduced an explicit error message when MSIINSTALLPERUSER is passed
  • Versions 4.91 and earlier accepted the flag but produced broken installations

Why this matters

Readers comparing these two pages will be confused about whether:

  1. The MSI ever supported per-user installations (it didn't)
  2. What changed in version 4.92 (only the error handling, not the capability)

An administrator reading the main installation page might incorrectly conclude that per-user MSI installations were possible before 4.92.

Suggested fix

Remove the version qualifier or clarify what changed in 4.92:

Option 1 (simplest):

The MSI installer only supports all-users installations. If you need a per-user installation, use the EXE installer.

Option 2 (if version context is important):

The MSI installer only supports all-users installations. (Version 4.92 and later explicitly reject per-user installation attempts; earlier versions accepted the flag but produced installations that couldn't be upgraded.)


Found by nightly documentation quality scanner

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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