Clarify wording of orphan rule to avoid ambiguity

Aberta
#1,998 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
1/5
Tempo estimado
Menos de uma hora
Facilidade para iniciantes
58/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Estagnada
Stack de tecnologia
rust
Domínio
documentation

Direção de pesquisa

Comece pela seção vinculada sobre orphan-rules da Rust Reference e revise a frase citada em seu contexto. Está concluído quando a redação tiver sido revisada para remover a ambiguidade, preservando o significado da regra.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

https://doc.rust-lang.org/reference/items/implementations.html#orphan-rules

"The orphan rule states that a trait implementation is only allowed if either the trait or at least one of the types in the implementation is defined in the current crate."

To me (non native English speaker, Rust learner) this sentence is ambiguous, in that "is defined" could be taken to mean both "is being defined" and "is already defined elsewhere than", which have opposite meanings.

I suggest this small change (in italics):
"The orphan rule states that a trait implementation is only allowed if either the trait or at least one of the types in the implementation is originally declared in the current crate."

Linguagem predominante
Rust
Estrelas
1.6k
Forks
618
Merge médio
5h 48min
PRs com merge (30d)
3

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de rust-lang/reference

Todas as issues de rust-lang/reference

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.