Awesome humans
These are the vetted sources behind every opinion in this repository. An opinion can use content only if it traces to a source listed here, or cites a reserved house:<profile> ID described below.
To propose a source, suggest it for vetting. If you're a listed source and don't want your work cited, ask to opt out. For how both work, see Want in or out?
Admission criteria
Every awesome-humans ecosystem admits a source by the same rules, in awesome-humans/website: Admission criteria. Read it before you vet a source or cite one. It defines the track record a source needs, the reserved house: prefix, the **Discovery-only.** and **Corroborate.** markings, and the references an opinion can link without vetting. This roster applies them this way:
- Independence:
ferrous-systems,tokio-blog, andtweede-golfeach record a usage limit under Source notes.predragandsunshowerseach record a conflict, where an opinion might recommend their own crate. - Dormancy:
burntsushiis admitted on documentation written in a repository. - References: A RustSec advisory also qualifies as a reference for the vulnerability it describes, and an accepted RFC in the RFC Book for the design it specifies.
How the roster is organised
- IDs: Each source has a stable
id, whichsources:metadata uses. - Order: Rows in every roster table, and the sections under Source notes, are sorted by
id. Insert a new source in order. - Tables: A row holds only what identifies a source: its ID, its kind, where to read it, what it covers, and how far back it goes.
- Kind:
personorpublication. A newsletter or link blog that one person writes is still apublication. A person's Source link text starts with their name, as inRalf Jung: Ralf's Ramblings, because the site takes the name from it. - Notes: The evidence behind a row goes in its notes section, in the shape Source notes describes, one sentence per line. Rows stay short, and a reworded sentence shows in a diff as that one sentence.
- Decision log: Entries run newest first, so add each one at the top, under the header row. Each entry gives the decision and the fact behind it. The evidence is in the source's notes and the pull request. It's the only table Prettier doesn't align:
<!-- prettier-ignore -->stops one long Detail cell from realigning every row.
Named references
The admission criteria define a reference and the rules for citing one. They also define a reference fact, which a reference supports without a roster source. For a choice or a judgement, a reference only corroborates a roster source. A reference never appears in sources:. A crate's or tool's own material already qualifies when an opinion names it, such as its repository (rust-lang/cargo or rust-lang/rust-clippy), its docs.rs page, or its crates.io page, so it isn't listed here. This roster also names:
- rust-lang/rfcs: The RFC for a language, Cargo, or library feature an opinion names, for how the feature behaves, not whether to use it. Link its page in the RFC Book, such as
https://rust-lang.github.io/rfcs/2383-lint-reasons.html. - rust-lang/rust: The tracking issue or stabilization pull request for a feature or lint an opinion names, for when it shipped or what still blocks it.
- rust-lang/libs-team: The API change proposal for a
stdaddition an opinion names, for what it adds and the problem it solves. - rustsec/advisory-db: The RustSec advisory for a crate an opinion names, for what's affected and which version fixes it. Link its page on rustsec.org, such as
https://rustsec.org/advisories/RUSTSEC-2020-0071.html.
The repositories behind rust-docs, such as rust-lang/reference and rust-lang/book, aren't references. Cite the published page as rust-docs.
Opted out
A source moves here when its author asks to stop being cited. Its row keeps the same five columns, and its section under Source notes goes. The ID stays reserved, so a later suggestion of the source is turned away, and just validate-sources rejects it in any sources: list. An opt-out from any awesome-humans ecosystem covers this one too, so vet-source reads every other ecosystem's Opted out section before admitting anyone. Opting back in is a suggestion like any other, and the source leaves this section only on admission. For the policy, see Want in or out?
No source has opted out.
Source notes
Each section holds the evidence behind a row: the track record, what a citation can rest on, and any conflict to declare. Each source has at most one section, sorted by ID. A source with nothing to record has none.
Write each section in this shape:
- Verdict: Open with the verdict in a line or two. For a watch-listed source, say what blocks it. A short note stops here.
- Labelled bullets: A longer note continues with one
**Label:**bullet per criterion or rule that has something to record, in this order, leaving out empty labels:- Scope
- Longevity or Dormancy
- Depth
- Accuracy
- Authorship
- Independence
- Conflict of interest
- Cite for a citable source, or Use for a watch-listed one
- Re-evaluate
- One sentence per line: Put each sentence on its own line, indented under its bullet, so a reworded sentence shows in a diff as that one sentence.
The check reads markings from the whole section, heading included, so **Discovery-only.** or **Corroborate.** in either place marks the source.