[docs-scanner] Unclear pronoun reference in cloud delivery note

Abierto Apto para principiantes
#26,547 0 comentarios 0 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@craig-osterhout ya está trabajando en esto.

Desde el 5/11/2026.

  • #26553 de @craig-osterhout — abierto

Evaluación

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

Línea de trabajo

Abre content/manuals/ai/governance/organization/audit/_index.md y lee la nota sobre la entrega en la nube. Sustituye el ambiguo «It» por una referencia explícita a la entrega en la nube, usando una de las formulaciones sugeridas. El trabajo estará terminado cuando la frase diga claramente que la entrega en la nube no añade cobertura de sandbox en la nube.

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

Descripción

File: content/manuals/ai/governance/organization/audit/_index.md

Issue

The note about cloud delivery contains an unclear pronoun reference:

Audit logs cover local sandboxes, the sandboxes that run on developers'
machines. Cloud delivery stores their audit records in the cloud. It
doesn't add cloud sandbox coverage.

The pronoun "It" in "It doesn't add cloud sandbox coverage" is ambiguous. Does "It" refer to "Cloud delivery" or to the entire audit logs feature?

Why this matters

A reader trying to understand what audit logs cover for cloud sandboxes will be confused about whether cloud delivery adds coverage for cloud sandboxes or whether audit logs as a whole don't cover cloud sandboxes.

Suggested fix

Clarify by using the explicit noun instead of the pronoun:

Audit logs cover local sandboxes, the sandboxes that run on developers'
machines. Cloud delivery stores their audit records in the cloud but
doesn't add cloud sandbox coverage.

Or restructure to make the relationship clearer:

Audit logs cover local sandboxes, the sandboxes that run on developers'
machines. Cloud delivery stores these local audit records in the cloud;
it doesn't extend coverage to cloud sandboxes.


Found by nightly documentation quality scanner

Lenguaje dominante
Markdown
Estrellas
4.7k
Forks
8.5k
Merge medio
2 d 19 h
PR fusionados (30 d)
156

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.