Expand `derive` documentation.

Aperta
#540 4 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
38/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
rust
Ambito
documentation

Direzione di ricerca

Start with the Reference documentation for the derive attribute and compare its current coverage with the Rust Book's derivable traits appendix. Confirm the built-in derivable traits and decide whether to summarize their default-implementation semantics or link to existing core/std documentation. Done means the documentation clearly presents the supported list and the chosen semantics reference.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

A-attributes

The derive attribute documentation should probably list the built-in traits that are derivable. To my knowledge, the list is:

  • Clone
  • Hash
  • PartialEq
  • Eq
  • PartialOrd
  • Ord
  • Debug
  • Default
  • Send
  • Sync
  • Copy

Should the documentation also specify the semantics of how the default implementations behave? It seems like important information, but I think it is mostly covered in the core/std docs. Another option is to link to https://doc.rust-lang.org/book/appendix-03-derivable-traits.html.

Lingua principale
Rust
Stelle
1.6k
Fork
607
Merge medio
1g 1h
PR unite (30g)
12

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di rust-lang/reference

Tutte le issue di rust-lang/reference

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.