Search guides, tips, and videos
15 min read
How to build docs that scale with your team
Build docs that grow as your team grows.
Blueprint for a scalable doc.Your Coda doc is the home for all your team’s needs. Think of this guide as a blueprint that will teach you how to build a doc that scales, so that it always feels like home, no matter how much your team or data grows.
What’s in here.
What you’ll learn in this guide :
- How to build a scalable that doc grows with your team.
- An overview of how data looks and works in Coda.
Features you’ll use in this guide:
Getting started.Now that you know what you’ll learn in this guide, let’s grab our tools and get into it. Create a new doc by either clicking the new doc button from your Coda workspace home “coda.io/docs” or by typing coda.new in your browser.
1. Structuring your doc.Just like there are tons of different house styles (a-frame, colonial, ranch, etc), there are many different ways to set up your doc. No matter the style of your build, you need a good foundation. Here are some tips.
Start by answering these questions:
- Who is the audience you are building for (your team, cross functional, or leadership)? You’ll use this to make sure that you have a view for everyone.
- What key information are you trying to share? You’ll use this to make sure your tables have all the right columns of data.
- How will your audience use this doc? This will guide your doc structure. You can make this doc anything you want, but here are some common ideas to get you started:
- Is this doc a write up? Will you use it primarily to deliver information and help drive decision making?
- Is this a team hub? How much editing will others need to do?
- Is this a project tracker? Who’s doing the tracking? Are there sections of the doc that need to be locked to prevent accidental editing?
Start with tables for all your data.Tables are the structure of your docs. They are the scaffolding, the frame holding everything up.The easiest way to create a table is by typing /table anywhere on a page. For this guide, we are going to assume you have your table basics down, so we are going to use the tasks template. If you need a refresher check out this Coda Essentials video on tables. For now, type /tasks, anywhere on your page, select the tasks template, and watch the magic happen. Learn more about Coda’s templates here.
Now that you have your tasks table ready to use, let’s rename our page to make it clear this is the back-end. You can name it whatever you want but here are some ideas:
Set up the back-end.
- Back-end page: A straight forward option.
- DO NOT EDIT: Clear and aggressive for those of us tired of accidental edits.
- Behind the scenes: Adds a little whimsy to your doc.
Now to the front-end.Views live primarily in the front-end (where your team works on a day-to-day basis) and are essential to the scalability of your doc in many ways:
- All your data is interconnected, so you don’t have to spend time updating it all over the place.
- This interconnected data also means one table with multiple views performs better than a bunch of separate tables.
- Create a new page by clicking the new page option on the sidebar on the left of your screen.
- This will be your team’s main page, so name it something that lets people know what this doc is all about.
- Drag your page to the top of your page list (above your back-end page).
The next step is to put a view of your tasks table on your team’s main page.
- Type "/table" and select Table, then Tasks 2. You’ve created a view.
- Add a few rows to the View of Tasks 2 and make yourself the Assignee.
- Change the Status to in progress, and set some due dates to be past due.
If you return to your back-end page, you will see the new rows (and all the other changes you made) there as well. If you make any adjustments to either table, both will reflect the changes. Change an assignee or due date on your back-end table and it will match your view on the home page. Lastly, really increase the scalability, let’s add a filter bar to your table on your team’s page.
- Head back to your team’s main page.
- Click on the filter menu at the top of your view of tasks 2 table.
- In the side menu that opens on the right of your screen, select Enable filter bar.
- Use the filter bar to filter out all tasks that are due before today.
Tip: The filter bar is user specific, so any filter applies only to you. You don’t have to worry about messing up the view for anyone else!
2. Create the views your team needs.Views allow each of your teammates to ‘see’ data in the way they prefer. You can create connected views based off of any column of data in your table. You can create a view for a specific person, a team (if you have a team column), or anything else. Like you explored in the previous section, updating data in one view updates it all views making it easy for your team to stay in sync.
- Create a new page and title it My tasks.
- Add a view of the tasks table (”/table” and select tasks). Name this table “My tasks.”
- Click on the filter option to the top right of your new view.
- In the side menu that opens to the right of the screen:
- Click + Add filter.
- Choose assignee.
- Select current user.
You can also hide certain columns in one view if you don’t want them. Maybe for the view of current user it is no longer important to see the Assignee. This can help create streamlined views of data to make your doc easy to consume. In a view, right click the top of a column and then click hide. That data is still in your doc, just hidden from that specific view. Maybe you love everything about a table, but you only want to see information relevant to you. That’s when the filter bar (covered in the previous step) is really useful. Plus it can help your doc stay performant, too!
3. Bringing it all together.If you team feels at home, they are more likely to use your doc. They need to know how to switch on the lights, where the good snacks are. Add some buttons to make it abundantly clear how interact with the doc. Above your view, create a button to add a row to the view of tasks table.
- Type "/button" in the page.
- Label it “Add task” and choose the add row action.
- Select “My tasks” as the table to add a row to. Then, toggle on Open row for editing.
- Add another task to your table.
In a home, a welcome mat is the first thing people see, but it doesn’t make much since to get one until the home is (at least most of the way) built. Now that you have your doc construction nearing completion, you want a warm welcome for each page. So, give clear direction on the steps a user should take to interact and be successful. Written instructions (you can make them collapsible) on each page after your welcome page will ensure everyone is aware how the doc works.
- Add a welcome message by simply typing in the canvas.
- Format your text. You can add headings (by typing "/H1"), highlight your text different colors, or add emojis to get your audiences attention.
- If you’ve already typed something you can click the hamburger menu next to the text and change it to a callout, or you can start with a callout by typing "/callout" anywhere on your page.
You can also welcome your team and explain your doc with an embedded video This is a favorite of a the Coda team.
- Film your video and upload it to the streaming platform of your choice.
- Type "/embed" and choose embed.
- Paste in the link to your video.
That’s it! Your doc has the foundation it needs to be scalable. With views and the filter bar, your data is easily accessible in the way you need while not bogging down your doc. With clear instructions throughout the doc, buttons to interact with, and user specific views, your team won’t lose time onboarding to another tool. They feel right at home, whether they’ve been her for two years or tow weeks.
Using the Coda skills from this guide, there is no limit to what you can do.
Try bringing a standing meeting or project into Coda and see how you can keep everyone on the same page (pun intended) w/o the constant pinging/searching through your docs, emails and slack messages.