How to write docs people will actually read.
Your Product Brief deserves to be more than a PM bandwidth consumer.
At Coda, we get excited about innovative and elegant solutions happening in docs every day. Now more than ever, we see teams coming together in docs to streamline their operations and collaborate effectively.

But as an increasing portion of our work happens in virtual spaces, how do we make sure we're reaching and engaging our audiences and co-workers successfully in those spaces?

Meeting notes can be so much more than just an exercise in frantic typing for the note-taker. And Product Briefs can be more than an effort to consume PM bandwidth. As the business adage goes:

"Your job communicating is not done until you've been understood."

To help make docs more useful, actionable, and delightful to readers (and Makers!), we've made quite a few changes to text in Coda these past few months and uncovered some best practices along the way.

1. Give your text clarity & navigability.

2. Keep your text (and yourself) organized.

3. Understand your text as you go.

4. Give your text a little character.

5. And don't be shy about context.

Bonus: Some other helpful tools to engage readers

Which of these features will you use?
0
Idea
Vote
Upvotes
1
Page Outlines
👍
0
0
2
Collapsible Content
👍
0
0
3
Drag-and-drop text
👍
0
0
4
Checklists
👍
0
0
5
Word & character count
👍
0
0
6
Word clouds
👍
0
0
7
Font sizes & styles
👍
0
0
8
Block Quotes
👍
0
0
9
Pull Quotes
👍
0
0
10
Subtitles
👍
0
0
11
Author Bylines
👍
0
0
12
"I've Read It" Button
👍
0
0
13
Sentiment Tracker
👍
0
0
14
Topic Voting (Hey, that's this one!)
👍
0
0
There are no rows in this table
This table is a demo in "play mode" for readers. When you add the table to your docs, you'll be able to accumulate votes for your entire team and sort to see the top vote-getters at the top!

Parting thoughts

Some docs might use every one of these features; some may use just one. Even simpler scenariosーlike meeting notes or blog posts draftsーbenefit from some combination of our latest text features. At the end of the day, we hope you're able to quickly and easily implement the text features that resonate most with your readers, and help you get your point across clearly and effectively.

We can't wait to see (and read!) what you make next.

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.