15 min read

Building for viewers

Eliminate confusion and lack of clarity in your doc to allow your team to get work done.

When you’re building for your team, empathy is key. Often your teammates will be interacting with your doc, but not editing. So you want to make it clear to your team how to use the doc. Eliminate confusion and lack of clarity in your doc to allow your team to get work done. For this guide, we will break out into two high-level sections.
Icon of a question mark in a brain
What you’ll learn…
  • How to build for viewers
  • Creating quality experience for your team
buttons
What you’ll use…
  • Buttons
  • Page options
  • Filter bar
  • Callouts

1. Empathize with your audience.

The first step to any good doc build is put yourself in your doc collaborator’s shoes. Design for them, not for yourself. Start out your build by thinking how you want your collaborators to use your doc. Here are some questions to get the juices 🧃 flowing:
  • What elements do you appreciate when you’re a collaborator instead of a maker? What do you not like?
  • Why are your collaborators coming to the doc? Is it to update statuses? Add a request for a new project? If you can’t clearly articulate this, how will they know what to do?
  • When they get there, what will they see? Is it welcoming? Instructive?
  • Is it obvious to them what they should do first? What about step number 2?
Eventually you will want instructions in your doc, so take some notes as you build on what you want to include there.
Coda Tip
See below on how to use callouts to make instructions stand out.
A good best practice here is to make a journey map to think through how a collaborator might use your doc. Is it easy to get from one place to another and back? You can make it with pencil and paper or your favorite diagramming tool.
Coda Tip
Free website flowchart templates like this one from Figma or this one from Miro can also be useful.

2. Keep your team's experience consistent.

As you are building out your frontend pages (those that your collaborators will interact with), make sure you keep them consistent.
  • If you use buttons to add rows to tables, make that consistent for every table.
  • Turned on subpages in your page options menu? Do it on every page.
  • Serif font on one page, serif font on all pages.
  • Like filter bars for filtering? Use them on all your tables (that need a filter).
  • Use your headers appropriately. H1, H2, then H3. It will also make your doc more accessible to people who use alternative navigation.
Remember that while you might know this doc is one space, it can be disorienting to your team if it doesn’t look like one space.

3. Clarity keeps your doc clean.

Now that you have your doc built, make sure you set it up for scale by keeping it fresh.

Keep your doc free from digital clutter.

Set up automations to archive completed or outdated tasks. Schedule reminders for yourself to review your doc for stale data or pages. Because you built the doc, it’s easy to look past the digital clutter—your team will thank you for keeping it clean!
Coda Tip
You can turn on last edited and authors for pages to see usage and assign ownership. You can also see row activity by expanding the row.

Make it clear what your doc is for.

Be clear about instructions--in context and accessibility. Put instructions at the top of the doc. Put it at the top of each "frontend" page. Put them in a callout so it's eye-catching. Put instructions in your instructions. Basically, give it away Oprah style ("You get instructions! And you get instructions! Everybody gets instructions!).
Your collaborators will be coming to Coda with differing levels of familiarity. Highlight stuff that you might think obvious (like the page list on the left). Then, provide some general best practices for you doc. Here are a few to get you started:
  • [WIP] - Page title: When a page is titled like this, it is not yet ready for collaboration. Please do not edit.
  • Don’t delete tables: If you think a table needs to be removed, please reach out [insert your @ reference here].
  • Use the filter bar only to filter a table.
Coda Tip
By providing these best practices, you keep your collaborators informed and your doc functioning.

Make your way-finding clear.

We talked earlier about creating a journey map for your collaborators. But a map is only as good as it’s way points. When your team jumps into your doc it should be clear for them where to go and how to get there. Use Coda’s @ references when you need a link to pages, tables, and rows. You can also use clearly labeled buttons to link to pages or sections of docs.
Keep instructions on buttons super clear. A collaborator should be able to read a button and know exactly what it is doing. Think “Add discussion topic” instead of “Add row” for a Dory. Or “Send project reminder” over “Send message.” Also, be sure your buttons’ colors match their uses. We all love a pink button, but red means delete. Like everywhere. Approval reaction when those who are needed to approve have seen it. Or a button that makes a time stamp in a table. How? They are developing their own solutions to problems around whether something is “official / up to date,” such as:
  1. Creating a sign-off column.
  2. Updating the “instructions” at the top of a doc to describe it as “living.”
  3. Changing the title of a table to reflect “archive.”
  4. Titling a section “this is a scratch space.”
  5. Keeping docs to a small group until “approved”;
  6. Labeling pages with “draft” or “WIP” before the title.
  7. Looking to other tools like Google or Slide for a “stamp of approval.”

Make a scratch page.

Do you have collaborators who might need a notes section? A sandbox to play in? Give them a dedicated place with clear instructions on how to get there.

Lock your doc down.

Some folks only need to update table values, or to upvote agenda items. In these cases, use locking to your advantage. The goal here is not to lock folks out of your doc, but to provide them the structure to work freely without feeling like they will mess something up.

4. Test your doc to unearth any issues.

The ultimate exercise in empathy is to test your doc with the humans who will be using it. Before you push it out to the whole team, have a few folks test it. For best results, have people test it who did not help build it. You want folks with fresh, unbiased eyes. In a similar vein, include a Dory somewhere in your doc (with specific instructions on how to use it) to elicit feedback from collaborators later down the line.

Now what?

You made it! And your doc is ready for collaborators. So what next?

Was this helpful?

YesNo