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

[docs-scanner] Confusing guidance about shell workload version compatibility

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

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

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

Línea de trabajo

Abre content/manuals/ai/sandboxes/customize/author/tool-mixins.md y lee las indicaciones sobre la versión de la workload junto con el ejemplo de sbx run. Aclara la diferencia entre los atajos integrados de v2 y la workload de shell publicada de v3, y verifica que la redacción explique de forma coherente qué combinación es compatible.

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

Descripción

File: content/manuals/ai/sandboxes/customize/author/tool-mixins.md

Issue

The tutorial states that built-in shortcuts including shell use v2:

"Use a v3 workload with this mixin. Built-in shortcuts such as shell and claude use v2."

However, the tutorial then immediately uses docker.io/docker/sbx-kit-shell:1.0.0 with the v3 mixin successfully:

$ sbx run docker.io/docker/sbx-kit-shell:1.0.0 --name claude-mixin-test \
    --kit ./claude-mixin
Why this matters

A reader following this tutorial might be confused about whether they can actually use the shell workload with v3 mixins. The statement warns against using shell because it's v2, but then the example uses what appears to be a shell workload. The distinction between the shortcut shell and the full image reference docker.io/docker/sbx-kit-shell:1.0.0 is not explained, leaving readers uncertain whether this combination is actually supported.

Suggested fix

Clarify the distinction between built-in shortcuts (like shell without a registry reference) and published v3 workloads. For example:

"Use a v3 workload with this mixin. Built-in shortcuts such as shell and claude (used without a full image reference) use v2 and can't be combined with v3 mixins. However, Docker provides published v3 workloads like docker.io/docker/sbx-kit-shell:1.0.0 that work with v3 mixins."

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

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.