Skip to content

Want in or out?

Citation is opt-out. Anyone can suggest a source, and any listed source can ask to stop being cited. Every request is a GitHub issue in awesome-humans/website, except an opt-out sent by email.

The site shows no portraits or logos. Each source appears by name, with a link to their work.

The goal is a montage of portraits for each ecosystem, and one for the site itself. Unlike citation, a portrait is opt-in: a face appears only with the person's recorded permission. Asking means the owner writes to every source on every roster and follows up each reply. That's more correspondence than one maintainer can take on yet, so portraits are on hold.

Suggest a source

Suggest a source for vetting with the issue form. It asks for the ecosystem, the source's main URL, three sample posts, and why the source qualifies. You can suggest yourself.

  1. Intake checks the suggestion. A source already on a roster gets a reply with its current standing, and the issue closes as a duplicate.
  2. The issue moves to the ecosystem's repository, where the vet-source skill checks the source against the admission criteria.
  3. The decision log records the outcome, whether yes or no, in a pull request that closes the issue. The issue gets a comment with the decision.

Only published writing counts: blog posts, documentation, books, and newsletters. Videos, conference talks, and podcasts are out of scope, as material to cite and as evidence of a track record.

Opt out

Ask to opt out with the issue form, or by email. An opt-out covers every ecosystem that lists you, because you opt out as a person, not per language.

Show that you control the source

Use one of these:

  • Your GitHub account: Comment on the issue from the GitHub account that your site links to.
  • Your domain: Publish a page or post on the source's domain that names the issue.
  • Email: Send the request from an address on the source's domain.

The owner checks the proof and decides. If the proof doesn't check out, you get one reply that explains these options, and the issue stays open for 30 days.

Opt out by email

Email contact@awesome-humans.net from an address on the source's domain, and name the sources to remove. The owner opens the opt-out issue for you, with "email" and the date as the proof. The issue names only the source's roster ID, which the roster already shows, and never your address.

What happens next

  1. Each ecosystem that lists you gets an issue, linked to yours.
  2. Within 30 days, your work leaves every opinion and roster. Each opinion that cited you is re-sourced from another vetted source, or cut back to what other sources support. Your roster ID moves to an Opted out section, so nobody suggests you again.
  3. Your issue closes with links to every pull request, and is locked.

The pages are versioned in git, like any public repository. An opt-out removes citations of your work, but it can't remove the fact that a published opinion once linked it.

Opt back in

Opting back in is a suggestion like any other. It goes through vetting, and your ID leaves the Opted out section when you're admitted.