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

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#26,241 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

  • #26245 par @nielskaspers — fermée sans fusion

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
92/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
docker, markdown
Domaine
documentation

Piste de recherche

Commencez par content/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md autour de la ligne 22, puis comparez les détails de version dans faq.md, lignes 70-82. Mettez à jour la formulation ambiguë de la version afin que la capacité MSI et la modification de la gestion des erreurs de la version 4.92 soient cohérentes, et vérifiez que le texte qui en résulte n'implique plus qu'une prise en charge par utilisateur existait auparavant.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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

Langage dominant
Markdown
Étoiles
4.7k
Forks
8.5k
Merge moyen
2 j 22 h
PR mergées (30 j)
159

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de docker/docs

Toutes les issues de docker/docs

Issues similaires

Plus d'issues Documentation

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.