The whole mechanism, in three chapters.
This is the same guide the extension shows, word for word. Two of the three chapters are things you can try rather than read.
How context notes work
The card — the five parts of every note, and its three states
Examples — five real notes, and why each reads the way it does
What gets shown — a demo you can try of how a note becomes public
The card
The 41% figure at the top of this page comes from a 2019 survey of 300 people. The study at example.org ↗ reports 12% for the same question, in table 2.
Every note is made of the same five parts. Step through them.
Examples
A context note adds what a reader would need to judge the page for themselves, with a source they can check.
The 41% figure at the top of this page comes from a 2019 survey of 300 people. The study at example.org ↗ reports 12% for the same question, in table 2.
It is specific, it can be checked, and it addresses the page rather than the person who wrote it. A reader can open the study and settle the question themselves.
What gets shown
A note is not shown because enough people liked it. It is shown when readers who usually disagree with each other both rate it helpful. That is a harder bar than a simple majority, and many notes never clear it.
Nothing is decided until a note has at least 5 ratings. Until then it waits where only signed-in readers can see it.
Two fixed sides is this page’s simplification. The real system does not sort readers into camps. It estimates where each reader stands from everything they have rated, and a note’s score rises only when readers far apart on that estimate agree. Scores are recalculated about every ten minutes, and a note’s status becomes permanent two weeks after the note is written.
Most pages have no notes. That means no note met the bar, not that the page was checked and found fine.
Any signed-in reader can rate a waiting note, and ratings are what decide it. Nobody is shown how anyone rated, and no tally is ever displayed.
A note can argue the page is fine instead of flagging it. Raters see it while they weigh the other notes, but it is never shown publicly, even when readers rate it helpful.
Any signed-in reader can rate notes. Writing them unlocks once your ratings have helped decide other notes: a rating made early, while the note was still undecided, counts toward unlocking when it matches the eventual outcome, and against it when it does not. At 5, writing opens and stays open.
Checking a page for notes sends no address. The panel hashes the address on your machine and asks the server about the hash instead. Writing a note is the exception: a note has to name the page it is about, so proposing one sends the address.