Reviews: Comments and Approval

A review is a link you send a customer so they can look at a drawing in 3D (and life-size in augmented reality on a phone), leave comments pinned to points on the model, and approve the drawing or ask for changes. Everything they say is kept on the server with the version it is about, with who said it and when. You see it on the same page.

Sign in to the web site, open the Viewer and set the drawing up: its template, its values and its look.
Choose Share for review, give it a title (what the customer sees) and, if you like, a note.
Choose Share. The link is shown: Copy link and send it by email or chat, or choose QR code to open it on a phone (below).

Whoever has the link can open the review: it needs no account, unless you give it a password. Keep it to the people who should see the drawing.

Your reviews are listed under Account › Share, with the latest version, where each stands and how many comments are still open. Under each review's title, Copy link copies its link and QR code shows it as a code to scan.

Opening a review on a phone

QR code (under Account › Share, or in the viewer's Share for review box once the drawing is shared) shows the review's link as a QR code in a small window. Point a phone's or tablet's camera at it to open the review there, then choose View in AR to see the model life-size in the room.

The code holds only the link: never the password or a reviewer's key. If the review has a password, the phone asks for it, as any reviewer's browser does.

Copy link puts the link on the clipboard. Where the browser doesn't allow that (on a page that isn't secure, for example), the page says so and shows the link for you to select and copy.

Password and expiry

When you share a drawing you can also give the review:

A password: reviewers must type it before they see anything (the drawing, its comments, its model in AR). Send it separately from the link, by phone or in another message. Only a salted hash of it is kept, never the password itself. Once typed, the review stays open on that device for seven days. After five wrong passwords from one place within a quarter of an hour, no more are tried for a while.
An expiry: a date and time, in your local time. After it the link shows This review link has expired: nobody can see the drawing, comment or give a verdict. The comments and verdicts are kept.

You never need the password, and you can still open an expired review, signed in. Under Account › Share each review shows whether it has a password and when it expires; choose Change to set a new password or remove it, and to extend the expiry, end it sooner or clear it (leave the date empty: it never expires). A new password works at once: whoever typed the old one is asked again.

Emails when reviewers act

When a reviewer comments on one of your reviews, approves it or asks for changes, you get an email at your account's address. It names the review, says who did what on which version and what they wrote, and links to the review. The link is the review's own: it never carries the password or a reviewer's key, and signed in you need neither.

What reviewers do within a few minutes comes in one email: the first comment or verdict starts it, and anything more in the next five minutes is added before it goes.
Your own comments, answers and verdicts (signed in) never send one.
Nothing comes from an expired link: its reviewers can no longer comment or give a verdict.

To stop them for one review, choose Change beside it under Account › Share and untick Email me when reviewers comment, approve or ask for changes. To stop them for all your reviews, untick Email me about my reviews under Review emails on the same page. An email already waiting to go still goes.

What the customer sees

The model, made from the version's drawing on the server, to turn and zoom. View in AR puts it life-size in the room on phones and tablets (AR Quick Look on iPhone and iPad, WebXR on Android; see Augmented reality).
Version: the versions shared, latest first; earlier ones can still be looked at and commented on.
Comments: choose Pin a comment, click the model where the comment is about, write it and choose Post comment. Its number shows as a pin on the model; click a pin to find its comment, or a comment to pick out its pin. A comment can also be about the whole model (not pinned), or answer another (Reply).
Your verdict: Approve or Request changes, with a note. Only the latest version can be approved; a later verdict on the same version takes the place of an earlier one, and all of them are kept.

People give their name with each comment and verdict (the page remembers it on their device).

Changing the drawing

Opened by you (signed in), the review page also has:

Button	What it does
Resolve / Reopen	Marks a comment dealt with (its pin turns grey), or open again.
Reply	Answers a comment; your answers are marked Designer.
Change in the viewer	Opens the latest version in the Viewer. Change it, choose Share for review, then Publish as a new version: the same link shows the new version, waiting for approval again.
Copy link	Copies the review's link.
Delete review	Removes it: the link stops working for everyone.

Each version keeps the drawing as it was shared (its template, values and look), so what was approved can always be seen again.

Comments in your own 3D

A pinned comment's point is kept in the version's glTF model's terms: metres, Y up, as the model from POST /export/glb has them. In the drawing's own 3D terms (Z up, the drawing's units) the point (x, y, z) is (1000 x, −1000 z, 1000 y) millimetres.