Setting up a site

About five minutes. The site's page in Settings walks the same steps and ticks them off.

  1. Add the site. Settings → Add a site, named as your reviewers would call it.
  2. Add the address it runs at. Mender takes notes only from the addresses you list, such as https://example.com.
  3. Paste the tag. Put it just before </body> on every page, and publish. Nobody you have not invited sees anything.
  4. Say whether notes carry a picture. With pictures, each note shows what the reviewer saw. You can change it later.
  5. Try it yourself. Press Try it yourself on the site's page, click anything and write a sentence; the note arrives in the Inbox. Opening the site the ordinary way shows nothing, even to you.
  6. Invite reviewers. Type their address on the site's page. They get one email with a link, and install nothing.

If your pages are behind a login

Send reviewers your site's login first, then turn on Sign-in on the site's page.

If your site has a Content-Security-Policy

Add these, or the browser will block the tag without saying so:

script-src   https://mend.page
connect-src  https://mend.page wss://mend.page
img-src      blob: data: https://mend.page
style-src    'unsafe-inline'   (or put your nonce on the tag as data-csp-nonce)
frame-src    https://mend.page   (the bot check, where visitors join or ask)

Letting visitors in without an invite

Turn on Guests on the site's page: visitors leave notes with a first name, for 24 hours, and see only their own. Show pins to visitors shows people who have not joined where notes are, never what they say.

Labels for what notes are about

Add the site's own labels under Labels, such as Tree work. Anybody who can read a note can label it, and readers filter the pins by label.

Who to invite as what

Content ReviewerLeaves notes that wait for the client’s approval before anything changes. Closes only their own.
ReviewerLeaves notes. Never sees the console.
TriagerFixes and sorts notes. The role for a developer.
Site ownerRuns the sites you give them: settings, reviewers and notes. Doesn’t see what agents do unless you switch it on.
MaintainerEvery site, plus addresses, people, repositories and runner tokens.
OwnerAll of that, and can permanently remove a person's words.

Worth adding later

Also: Leaving notes, for reviewers · Setting up a site · Fixing notes