[docs-scanner] Unclear pronoun reference in cloud delivery note
Mantenedores costumam responder em até 1 dia
Avaliação
- Dificuldade
- 1/5
- Tempo estimado
- Menos de uma hora
- Facilidade para iniciantes
- 94/100
- Tipo de issue
- Documentação
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- docker, markdown
- Domínio
- documentation
Direção de pesquisa
Abra content/manuals/ai/governance/organization/audit/_index.md e leia a nota sobre a entrega na nuvem. Substitua o ambíguo “It” por uma referência explícita à entrega na nuvem, usando uma das formulações sugeridas. A tarefa estará concluída quando a frase disser claramente que a entrega na nuvem não adiciona cobertura de sandbox na nuvem.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- Markdown
- Estrelas
- 4.7k
- Forks
- 8.5k
- Merge médio
- 2d 13h
- PRs com merge (30d)
- 139
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de docker/docs
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 88/100
Mantenedores costumam responder em até 1 dia
-
status/triage
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 68/100
Mantenedores costumam responder em até 1 dia
-
[docs-scanner] Unclear policy change timing in organization policies overviewTalvez já em andamento @Mhdomer assumiu hoje. Aberta
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 89/100
Mantenedores costumam responder em até 1 dia
-
Debian installation pitfallTalvez já em andamento @Duo-ee assumiu há 7 dias. Abertastatus/triage
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 85/100
Mantenedores costumam responder em até 1 dia
Todas as issues de docker/docs
Issues semelhantes
-
Blog update untriaged
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
-
sync-en
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 84/100
Mantenedores costumam responder em até 1 dia
-
sync-en
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 82/100
Mantenedores costumam responder em até 1 dia
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 83/100
GSA/digital-gov-drupal#569 ·
Mantenedores costumam responder em até 2 dias