[docs-scanner] Unclear pronoun reference in cloud delivery note
Les mainteneurs répondent en général sous 1 jour
Évaluation
- Difficulté
- 1/5
- Temps estimé
- Moins d'une heure
- Accessibilité débutants
- 94/100
- Type d'issue
- Documentation
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- docker, markdown
- Domaine
- documentation
Piste de recherche
Ouvrez content/manuals/ai/governance/organization/audit/_index.md et lisez la note sur la livraison cloud. Remplacez le « It » ambigu par une référence explicite à la livraison cloud, en utilisant l’une des formulations suggérées. Le travail est terminé lorsque la phrase indique clairement que la livraison cloud n’ajoute pas de couverture par des environnements sandbox cloud.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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
- Langage dominant
- Markdown
- Étoiles
- 4.7k
- Forks
- 8.5k
- Merge moyen
- 2 j 19 h
- PR mergées (30 j)
- 156
Préparer son environnement
- Fournit un Dockerfile ou un fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de docker/docs
-
Difficulté 1/5 1-3 heures Accessibilité débutants 89/100
Les mainteneurs répondent en général sous 1 jour
-
Debian installation pitfallPeut-être pris @Duo-ee l’a pris il y a 6 jours. Ouvertestatus/triage
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour
-
Confusing and contradictory information about paths resolving in extendPeut-être pris @Duo-ee l’a pris il y a 5 jours. Ouvertestatus/triage
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
Les mainteneurs répondent en général sous 1 jour
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'Peut-être pris @dave123981 l’a pris il y a 7 jours. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
Les mainteneurs répondent en général sous 1 jour
-
Outdated Java language-specific guide: deprecated code in Dockerfile, compose.yaml mistyped name, Spring Boot localization variables.Peut-être pris Une pull request liée à cette issue est ouverte ou déjà fusionnée. Ouvertestatus/triage
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
docker/docs#26484 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de docker/docs
Issues similaires
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
fsprojects/FSharp.Formatting#1370 ·
Les mainteneurs répondent en général sous 1 jour
-
hermes-queue
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
chrisalunlloyd2-sudo/mindpalace#337 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
-
sync-en
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour
-
sync-en
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour