Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
  • ¿Algo no está bien?
#26,241 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

  • #26245 de @nielskaspers — cerrado sin fusionar

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
92/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
docker, markdown
Área
documentation

Línea de trabajo

Comienza con content/manuals/desktop/enterprise/enterprise-deployment/msi-install-and-configure.md alrededor de la línea 22 y, después, compara los detalles de versión en faq.md, líneas 70-82. Actualiza la redacción ambigua sobre la versión para que la capacidad de MSI y el cambio en el manejo de errores de la versión 4.92 sean coherentes, y verifica que el texto resultante ya no implique que antes existía compatibilidad por usuario.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
Markdown
Estrellas
4.7k
Forks
8.5k
Merge medio
1 d 22 h
PR fusionados (30 d)
128

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de docker/docs

Todos los issues de docker/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.