[docs-scanner] Unclear pronoun reference in cloud delivery note
I maintainer di solito rispondono entro 1 giorno
Valutazione
- Difficoltà
- 1/5
- Tempo stimato
- Meno di un'ora
- Idoneità per principianti
- 94/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Stack tecnologico
- docker, markdown
- Ambito
- documentation
Direzione di ricerca
Apri content/manuals/ai/governance/organization/audit/_index.md e leggi la nota sulla distribuzione cloud. Sostituisci l’ambiguo «It» con un riferimento esplicito alla distribuzione cloud, usando una delle formulazioni suggerite. Il lavoro è terminato quando la frase dice chiaramente che la distribuzione cloud non aggiunge copertura per sandbox cloud.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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
- Lingua principale
- Markdown
- Stelle
- 4.7k
- Fork
- 8.5k
- Merge medio
- 2g 19h
- PR unite (30g)
- 156
Preparare l'ambiente
- Include un Dockerfile o un file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di docker/docs
-
Difficoltà 1/5 1-3 ore Idoneità per principianti 89/100
I maintainer di solito rispondono entro 1 giorno
-
Debian installation pitfallForse già presa @Duo-ee l’ha presa 6 giorni fa. Apertastatus/triage
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100
I maintainer di solito rispondono entro 1 giorno
-
Confusing and contradictory information about paths resolving in extendForse già presa @Duo-ee l’ha presa 6 giorni fa. Apertastatus/triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
I maintainer di solito rispondono entro 1 giorno
-
[docs-scanner] Inconsistent terminology: 'nested organization' vs 'organization in the company'Forse già presa @dave123981 l’ha presa 7 giorni fa. Aperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
I maintainer di solito rispondono entro 1 giorno
-
Outdated Java language-specific guide: deprecated code in Dockerfile, compose.yaml mistyped name, Spring Boot localization variables.Forse già presa Una pull request collegata a questa issue è aperta o già unita. Apertastatus/triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
docker/docs#26484 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
Textualize/textual#6753 · 1 commento ·
-
area: core area: docs good first issue help wanted lane: free-agent priority: P3 roadmap size: XS type: task
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 86/100
arminazimi/seaworthy#701 ·
I maintainer di solito rispondono entro 1 giorno
-
Use registered media types for HDF5 and NetCDF, and stop claiming media_type must be IANA-registeredApertadocumentation metadata
Difficoltà 2/5 1-3 ore Idoneità per principianti 87/100
I maintainer di solito rispondono entro 1 giorno
-
doc-qa/index.html: data: favicon is blocked by img-src 'none' (one CSP console error per load)Apertabug good first issue
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
elhajahmadj/offline-emergency-library#156 ·
I maintainer di solito rispondono entro 1 giorno
-
7.2 user documentation (HelpHub)
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
WordPress/Documentation-Issue-Tracker#2559 · 1 commento ·