Skip to content

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 the rules for independence this way:

  • avalonia-blog, james-montemagno, and shay-rojansky each record a usage limit under Source notes.
  • Vendor work with critical distance needs no limit, as from stephen-toub or khalid.
  • duende-blog and telerik-blog are on the Watch list because their bylines vary and a usage limit can't address independence that changes with the author.

How the roster is organised

  • IDs: Each source has a stable id, which sources: 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: person or publication. A newsletter or link blog that one person writes is still a publication. A person's Source link text starts with their name, as in Andrew Lock: .NET Escapades, 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, such as pinning a line anchor to a commit. 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 package's or tool's own repository already qualifies when an opinion names it, official or not, so it isn't listed here. That covers dotnet/sdk for the dotnet CLI, and dotnet/dotnet-docker for the official container images and their tags. This roster also names:

  • dotnet/csharplang: The proposal or design notes for a C# feature an opinion names, for how the feature behaves, not whether to use it.
  • fsharp/fslang-design: The RFC for an F# language or FSharp.Core feature an opinion names, for how the feature behaves, not whether to use it.
  • dotnet/designs: The design document for a .NET platform feature an opinion names.
  • dotnet/core: Release notes and known issues for a .NET release an opinion targets.

A guidance repository, such as dotnet/skills, is a source, not a reference, so propose it with vet-source. An archived repository's content has moved, such as dotnet/aspire to microsoft/aspire, so cite where it went.

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 scripts/validate-sources.cs 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:

  1. Verdict: Open with the verdict in a line or two. For a watch-listed source, say what blocks it. A short note stops here.
  2. 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:
    1. Scope
    2. Longevity or Dormancy
    3. Depth
    4. Accuracy
    5. Authorship
    6. Independence
    7. Conflict of interest
    8. Cite for a citable source, or Use for a watch-listed one
    9. Re-evaluate
  3. 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.