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

[docs-scanner] Swarm tutorial: Confusing version framing in rolling-update.md

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

Los mantenedores suelen responder en 1 día

@dave123981 ya está trabajando en esto.

Desde el 27/10/2026.

  • #26455 de @dave123981 — abierto

Evaluación

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

Línea de trabajo

Lee content/manuals/engine/swarm/swarm-tutorial/rolling-update.md y localiza el párrafo sobre el despliegue de Redis. Elimina o revisa la nota sobre la etiqueta de Redis para que las instrucciones ya no dejen poco clara la elección de la versión. Se considerará terminado cuando el párrafo dé instrucciones claras para el despliegue sin insinuar que se debe usar una versión anterior sin explicación.

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

Descripción

File: content/manuals/engine/swarm/swarm-tutorial/rolling-update.md

Issue

The tutorial includes a confusing note about Redis versions:

Deploy your Redis tag to the swarm and configure the swarm with a 10 second update delay. Note that the following example shows an older Redis tag:

$ docker service create \
  --replicas 3 \
  --name redis \
  --update-delay 10s \
  redis:7.4.0

The phrase "Note that the following example shows an older Redis tag" is unclear and potentially confusing:

  • It doesn't explain what the version is "older" than
  • Redis 7.4.0 was released in 2024, so calling it "older" without context is ambiguous
  • The note doesn't provide actionable information for the reader
Why this matters

Readers may wonder:

  • Should they use a different, newer version instead?
  • Is the tutorial outdated?
  • What version should they actually use?

The note creates uncertainty without adding value. The tutorial's purpose is to demonstrate rolling updates, not to recommend specific Redis versions.

Suggested fix

Remove the confusing note. The tutorial works with any two sequential Redis versions. If a note is needed, it should clarify the purpose:

Deploy Redis to the swarm and configure the swarm with a 10 second update delay:

Or, if you want to acknowledge version choice:

Deploy Redis to the swarm and configure the swarm with a 10 second update delay. This example uses Redis 7.4.0, but you can use any Redis version:

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)
148

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.