Leave a review¶
This is a working document. The most useful thing you can do is mark the exact sentences and diagrams you disagree with.
How to comment¶
You were given a link with ?review= in it. That link turns on the review tools. Nothing else is needed — no account, no email, no install.
On the exact sentence¶
Select any passage of text with your mouse. A small Comment button appears above it. Click it, write your note, click Save.
The sentence is marked in yellow and your comment is pinned to that exact phrase. If a page is edited later, the comment follows the words rather than a line number.
On a diagram, table or image¶
Click Pin on diagram / table at the bottom of the review panel. The diagrams get an outline. Click the exact spot on the diagram you want to talk about, write your note, save.
A numbered pin appears where you clicked.
Seeing your comments¶
The round button in the bottom-right corner shows how many comments you've made. Click it to see the list, jump to any comment with Show, or delete one.
Your comments are saved in this browser as you go. You can close the tab and come back later.
Sending them back¶
When you're done, click Send review at the bottom of the panel.
You get two options:
- Copy link — a single link containing every comment. Paste it into WhatsApp or an email.
- Download file — a small JSON file, for when the review is long.
Either works. The link is easier.
What kind of feedback is most useful¶
| Worth the effort | Not worth the effort |
|---|---|
| "This number is wrong" — with the correct one | "Looks good" |
| "This competitor exists and you missed it" | Rewording for style |
| "This assumption is unsafe because…" | Suggesting extra features |
| "I'd never use this, because…" | Agreement with everything |
| "The ranking is wrong — this should be higher" | |
| "This diagram doesn't match the text" |
Specific beats polite. If a whole section is wrong, say so — that is more valuable than four small notes about commas.
Where the comments go¶
Each comment carries the page it belongs to and the exact phrase it refers to. When a revision is made, the document it concerns is updated and the changelog notes what changed. Nothing is silently dropped.
If the tools don't load¶
Some corporate networks and older browsers block the scripts. In that case, all the source documents are plain Markdown — write your comments in a message, quoting the sentence you mean, and send them the same way.