diversemediaRedlineHow to comment

How to comment with DM Redline

Redline lets you point at anything on the website we are building for you and say what should change. Your note is pinned to that exact spot, and it reaches us the moment you post it. No screenshots to take, no list of page numbers to write, no email chains.

What Redline is

The site you are reviewing is a real website, not a picture of one. Redline sits on top of it as a thin layer: a small bar at the bottom of the screen, and numbered pins where comments have been left. Everything you do in Redline happens in your browser. You cannot break the site, delete anything on it, or change what anyone else sees.

When you post a comment, three things happen. It appears as a pin on the page for you and for anyone else reviewing. It reaches the Diverse Media team with a screenshot of what you were looking at, and is tracked there until it is done. And the people at Diverse Media who follow this project get an email. You will see a reply from us on the comment itself, and the label on it changes as the work moves along.

In one sentenceClick the thing you want changed, type what you want, press Post. Everything else in this guide is detail you can come back to.

What you need

Nothing to install, and nothing to set up. If you can open the link and sign in, you are ready.

Opening the site

  1. Open the link. If the preview is private, a Diverse Media sign-in page appears first. It shows the project name, a Private preview line and a red Confidential badge.
  2. Sign in with your email address and the password we gave you. Tick nothing else; there is nothing else to fill in.
  3. Choose how to enter, if the page asks. Some sites remember your last visit, so that an opening animation or a tour does not play again:
    • As a first-time visitor — you see the site the way someone arriving for the first time sees it, including the intro.
    • As a returning visitor — you carry on with what this device already remembers. This is the usual choice.
    You can start fresh later from the comment list, without signing in again.
  4. Wait for the page to settle. A concept site often has an opening sequence. Let it finish before you start commenting, so your screenshots show the finished state.
  5. Find the round Redline button at the bottom right of the screen. Press it and the bar opens along the bottom of the page. If the button sits over something you want to see, drag it out of the way.

If Redline itself asks you to sign in when you open the bar, use the same email and password.

The Redline bar

The bar opens at the bottom centre of the screen. Drag it anywhere you like; double-click the dotted grip at its left end to put it back.

ButtonWhat it doesWhen you want it
CommentTurns on commenting. The next thing you click becomes the subject of your note.Every time you have something to say.
FreezeStops animation on the frame you can see, and starts it again when you press it a second time.A slideshow or animation moves before you can click it.
MomentsReplays an animation and stops at the exact second a comment was left on.Someone commented on something that only appears mid-animation.
The list (with a number)Opens the panel with every comment. The number is how many are still open.Reading replies, checking what you already said, printing a report.
?Opens this guide in a new tab.Any time.
×Tucks the bar away and leaves the round button.You want to look at the site without the bar in the way.

Your first comment

  1. Press Comment on the bar, or press the C key.
  2. Move the pointer across the page. A thin outline follows you and shows what you are about to pick: a heading, a photograph, a button, a whole block.
  3. Click the thing you want changed. A note box opens next to it.
  4. Type your note. Write it the way you would say it to us in a meeting.
  5. Press Post, or hold Ctrl (⌘ on a Mac) and press Enter.

A numbered pin stays on that spot. Click a pin at any time to read the comment, reply to it, or see what we have said back.

A picture of what you were looking at is saved with the comment automatically, with a marker where you clicked. You do not need to take a screenshot yourself. If the picture is not helpful, or shows something you would rather not send, press Leave out before you post.

Pointing at the right thing

Pages are built in layers: a word sits inside a heading, the heading sits inside a panel, the panel sits inside a section. A white box outlines whatever you are about to pick, and the Redline bar spells it out in words — for example section#hero › div.card › h1.title · 640×120. Both change as you move, and flash when you step to another layer:

↑the arrow key on your keyboard: pick the larger thing around it (the whole panel instead of the heading)
↓pick the smaller thing inside it (the heading instead of the panel)
Tabpick the layer underneath, when something transparent sits on top
hold Spaceuse the site normally for a moment — scroll, open a menu, hover a card — without leaving comment mode
Escstop commenting, or close the note box

It does not have to be perfect. The pin holds its place even if the page is rebuilt, and we can see the screenshot, so aim at roughly the right thing and describe the rest in words. The words on the bar are there for when the outline is hard to judge — a thin strip, a box inside another box of the same size — and they are what our developers work from.

After ↑, ↓ or Tab the choice is heldThe outline turns gold and reads held. Move the mouse anywhere inside it — the choice does not change — and click on the exact spot you mean. That is how you comment on the top right corner of a full-screen block. Move the pointer outside it and picking starts again.
A menu or pop-up closes when you clickHold Space, open the menu with the mouse, let go of Space while it is open, then click the item you want to comment on. You can also press Freeze first.

Writing a comment we can act on

Short and specific beats long and careful. The two things that help us most are what is wrong and what you want instead. If you only know the first half, say so and we will suggest the second.

Instead ofThis gets it done
“This doesn’t work for me.”“This headline is too long. Use ‘Fifty years of partnership’ and drop the second line.”
“Colour is off.”“This gold is too orange against the navy. Closer to our brand gold, the one on the annual report cover.”
“Fix the photo.”“Replace this photo — the person on the left has left the organisation. I will send a new group shot on Friday.”
“Too slow.”“The intro takes too long before the logo appears. Can it be about half the length?”
“Wrong.”“The date should be 1977, not 1979. Source: the Jubilee booklet, page 4.”

Wording, pictures and recordings

Under the note box there are four extras. Use them when words alone will take longer than showing us.

Edit text

Press Edit text and the wording you clicked on appears in a box. Change it to what it should say and post. We see the old and the new version side by side, word by word, and can copy your version straight into the site. This is the fastest way to handle typos, names, titles, dates and any sentence you want rewritten.

Attach

Add up to five images or PDFs to a comment: the logo file you want used, a scan with the correct spelling of a name, a page from a brochure to match, a photo of the venue. Up to 20 MB each.

Record

Records your screen while you talk, up to one minute. Your browser asks which tab or window to share, and whether it may use your microphone. Use it when something only makes sense in motion: a wobble while scrolling, a menu that closes too fast, a sequence that happens in the wrong order.

Voice

A voice note, up to one minute, with no screen recording. Useful on a phone, or when a paragraph of typing would take five minutes and ten seconds of talking would do.

Nothing is sent until you postThe screenshot, the recording and the attachments all travel with the comment when you press Post. If you close the note box instead, nothing is kept.

Pages that move

Concept sites often have animation: an opening sequence, a scrolling story, a 3D scene you can look around. Two buttons make those easy to comment on.

In a 3D view, Redline also remembers where the camera was pointing, so pressing Go to on that comment puts you back in the same position.

Pictures, PDFs and video

For designs and films we send you a private review page instead of a website, at an address like redline.diversemedia.sg/v/your-project/. Sign in with the same email and password. The files are listed on the left; the newest version of each opens first, and Version at the top shows the earlier ones.

Every picture, page and frame carries a label with the version and its stage (DRAFT, FOR REVIEW or APPROVED), and your name and email faintly across it. That is there because these are confidential drafts; please don’t share or record them. When a version is approved, a Download button may appear for a clean copy.

Your comment list

Press the list button on the bar (it shows how many comments are open). The panel lists every comment on the project, newest first, with its screenshot, its page, and any replies.

Each comment carries two buttons — Go to and Reply — and a ⋯ button beside them. The two you reach for most are always in the open; everything else is one tap away in the ⋯ menu, so the card stays readable instead of being a row of small links.

On each commentWhere it isWhat it does
Go toButtonTakes you to that spot on the page, on the right page, at the right moment in an animation.
ReplyButtonAdds to the conversation on that comment. We are notified.
Mark as done / Reopen⋯ menuMarks it as done, or brings it back if it is not right yet.
Drop this comment⋯ menuWithdraws the comment, with a short reason. It stays readable, so nobody wonders later what happened to it.
Edit the wording⋯ menuChanges your wording. The earlier version is kept, so the history is honest.
History⋯ menuShows the earlier versions of a comment that has been edited.
Delete⋯ menuRemoves your own comment and its files. It is shown in red, and it asks first.

You only ever see the actions you are allowed to use. On someone else's comment you get Go to and Reply, and the ⋯ menu holds only what that project lets you do.

Doing several at once

Press Select at the top of the list and a tick box appears on each comment. Tick the ones you mean, or use All to take everything the current filter shows, then choose what happens to them: Resolve, Reopen, Drop with one reason for the lot, Export just the picked ones, or Delete. Deleting asks you to confirm first and cannot be undone. You can pick your own comments; Diverse Media can pick any. Press Done to leave select mode.

At the top of the panel you can filter by Open / Resolved / Dropped / All, limit it to This page only, or pick a device to see only the comments left on a desktop, a tablet or a phone. Export at the bottom opens a short menu: Spreadsheet (CSV) for the whole list as you can open it in Excel or Numbers, or Developer notes (text) for a plain text version written for whoever does the building. Every Export button in Redline works the same way, so there is one place to look wherever you are.

Every export carries the whole conversation, not just the first note: each reply with who wrote it and when, any earlier wording of a comment that was edited, and the reason given when something was dropped. Nothing said on a comment is left out of the spreadsheet, the text file or the printed report.

The ⋯ button at the top of the panel holds the rest: Change your password, How to comment, a switch for whether pins stay on the page when Redline is closed, Restart as a new visitor on sites that remember a visit, and Sign out. With the pins switch on, the numbers stay where they are after you tuck the bar away, and clicking one opens Redline again at that comment. With it off, the page is left completely clean. Restarting clears what this device remembers about the site so the intro plays again; your comments are not affected.

What the labels mean

LabelWhat it means for you
OpenWith us. Nobody has started on it yet.
In progressSomeone at Diverse Media is working on it now. Their name is on the comment.
For reviewWe think it is done. Please look and either resolve it or reopen it.
ResolvedClosed. It stays in the list and in the report.
DroppedWithdrawn, with the reason attached — usually because it was decided another way, or it turned out to be a duplicate.
Urgent / HighPriority we have set internally so the important ones are done first.

Summary and reports

Summary (or the S key) gathers every comment in one page, grouped by the page of the site it belongs to, with counts at the top: how many comments, how many open, how many resolved, how many pages, how many reviewers.

The strip along the top of the summary is in two halves. On the left is what you are looking at — the round, and the filters for status and device. On the right is what you can do with it:

Close the summary with the × in its top right corner.

Emails

You get an email when someone replies to your comment, when we mark one of yours as done, and when a comment of yours is dropped. Each email has a link that opens the site at that exact comment. You can switch these off at any time on your account page.

On a phone or tablet

Deadlines and rounds

Most projects have a feedback due date, shown at the top of the comment panel. It is there so that everyone reviewing works to the same date.

After the date, a project may be closed to new comments. You can still open the site, read every comment and print the report; the Comment button is greyed out. If you need it reopened, ask us.

When a round of changes is finished, we start a new round. Everything from the round before is archived and stays readable under its own name, and the site begins with a clean page. This keeps “what we said in round one” separate from “what we are saying now”.

Your password and account

Keeping the preview private

A preview is unpublished work. The wording, the photographs and the design are all provisional, and some of the content on the page is sample material that stands in for the real thing until it arrives.

Your visits

For security, Diverse Media keeps a record of each visit you make to a preview while you are signed in: when you arrived, roughly how long the site was open on your screen, the kind of device and browser, and the network address it came from. It helps us spot an account being used by someone it wasn’t given to, and shows us when a preview has been seen.

Keyboard shortcuts

Cstart or stop commenting
↑ ↓while commenting: pick the larger or smaller thing around what you point at
Tabwhile commenting: pick the layer underneath
hold Spacewhile commenting: use the site normally
Ctrl/⌘ + Enterpost the note you are writing
Escstop commenting, or close the note or the panel
Ffreeze or play the page
Sopen the summary

If something doesn’t work

“That email and password don’t match”Check the email address first; it is the one we sent the invitation to. Press the eye at the end of the password box to see what you typed. After eight wrong tries the account pauses for fifteen minutes. Use Forgot password? rather than guessing again.
“This account doesn’t have access”Your account exists but is not on this project yet. Tell us and we will add it, usually within minutes.
The sign-in page keeps coming backYour browser is blocking the cookie the preview uses. Turn off private or strict tracking mode for this site, or try another browser.
The Comment button is greyEither the project is closed to new comments, or your account is set to view only. Both are easily changed; ask us.
Nothing outlines when I move the mouseCommenting is not on. Press Comment on the bar, or C.
The pin is on the wrong spotThe page had not finished loading when the comment was posted. Post a short reply saying what it should point at; the screenshot usually makes it obvious.
Recording won’t startAllow screen sharing and the microphone when the browser asks. On a Mac, System Settings → Privacy & Security → Screen Recording must allow your browser. Recording is not available on iPhone or iPad.
A recording won’t uploadIt may be too long. Keep recordings under a minute, and check you are not on a weak connection.
The page looks brokenReload it once. If it still looks wrong, comment on it — that is useful information for us, and the screenshot goes with it.

If none of that helps, call or email us. The details are at the bottom of this page.

Questions we are asked

Can I break the website by commenting on it?
No. Redline cannot change the site. It draws its own layer on top and sends your notes to us.
Can other people see my comments?
Everyone we have given access to this project sees them, and so do we. That is usually what you want: it stops two people asking for opposite things without noticing. If your project is set up so that each reviewer sees only their own, we will have told you.
How many comments is too many?
There is no such thing. Small, specific comments are exactly what the tool is for.
Can I comment on a picture or a PDF instead of a web page?
Yes. If we have sent you an images-and-PDFs link, it works the same way: click the spot, write the note. Each page of a PDF takes its own pins.
Somebody else already said what I wanted to say.
Reply to their comment rather than adding a new one. It keeps the thread in one place.
I am reviewing two of your sites. Do I need two passwords?
No. One email and password opens every site we have given you. Your account page lists them, with a link into each one, and the comment panel names the site you are on.
Can I use this on the live site after launch?
Yes, if you would like to. Tell us and we will leave a project open for it.
Do I need to tell you when I have finished reviewing?
A short message helps. We take the feedback due date as the end of the round unless you tell us otherwise.
Who sees the screenshots and recordings?
Only Diverse Media and the people on your project. They are kept with the project and deleted when the comment is deleted.

Diverse Media Pte Ltd · +65 6671 1466 · info@diversemedia.sg
This preview and everything in it is confidential.