Gallery
Making a People Operations Wiki on Coda
Share
Explore
Gallery
Making a People Operations Wiki on Coda

icon picker
Making a People Operations Wiki on Coda

How much can I contribute to my HSA? What’s the travel policy? When do we get paid? Where do I file this receipt for reimbursement? etc. etc. etc.

Why Coda for wikis?

If you work on a People team, you’ve likely been asked these questions... and probably more than once. At Coda, we use our product to make information as easily accessible to our employees as we can. Having it all in one place makes sure that employees have the all the information they need at their fingertips, and saves our People team a ton of time.
light

What’s in this doc?

Along with this primer on decisions we made in building our people wiki outlined below, we’ve included our wiki content starting
here
⁠
. We scrubbed some information out to protect private information - hopefully you can still get the gist.
If you need this at your company, feel free to make a copy of this doc use this as a starting point!
⁠
Make a copy
⁠
⁠
⁠

Some choices we’ve made on our People Wiki

👥 Grouping relevant topics

We have our People Wiki grouped into 5 main sections, which you can see along the left side of this doc.
⁠
Employee Handbook
⁠
⁠
⁠
Benefits & Perks
⁠
⁠
⁠
Guidelines & Info
⁠
⁠
⁠
Employee Programs
⁠
⁠
⁠
Coda Offices
⁠
⁠
Within each section, we have as many subpages as we need, easily adding, removing and consolidating as our programs evolve. The doc is searchable, so even if a Codan doesn’t know what category their question belongs to, they can easily search for mentions across the wiki.

⚙️ Consolidating and automating Q&A

If one Codan has a question, it’s likely others do, too. In the
Setup
⁠
page of this doc, we have a table of each category, and a
Base Table: Q&A
⁠
of every question that Codan have added.
On each page, we include a callout and button to add any questions. Clicking that button adds a new row to the Q&A table and applies the current page’s category.
Each page shows a filtered view of the the table by the category so it only shows relevant questions.
If you want to get extra fancy,
you can set up an automation
⁠
that sends you a Slack message or email for whenever a new row is added.
⁠
⁠
⁠
We hide the categories and base table on our
Setup
⁠
page to keep the doc looking clean.

📄 Embedding pages to collect information from disparate source

The content in our wiki isn’t strictly limited to folks from our small People team. We lean on Finance, Recruiting, IT, Legal, etc. for content. Rather than make our partners keep their policies up to date in multiple places, we use embedded pages to display and link docs from across the business.
Here’s an example of an /embed in action:
⁠
⁠
⁠

Writing Principles to spark your writing

Here are some writing principles we recommend to make your Wiki, a powerful one!
Conversational tone. Write as if you’re talking to a friend. This will make it more relatable and less formal.
Provide real-life examples. It’s often helpful to break down concepts, especially when it may go over someone’s head like taxes and withholdings, or rollovers, by applying an example so they can picture themselves in that common situation.
Break up the content. Use subpages and headers to get your point across, quickly, so readers won’t have to read through large chunks of text
Use searchable words. To help employees find information on a particular topic, think of common words or phrases used. It’s trickier for employees to think of “HSA” or “COBRA” but they’ll likely search “health care” or “benefits”.
Leave a spot for questions. Having a Q&A accessible on each page will make it easy for your employees to know where to post their question.
Add your POC. In case they want to follow up with a person directly, this alleviates your employee not knowing who to go to.

walking

Start your walk through of our Wiki here at
Welcome to Wikipops
⁠
.

If you have any questions or want to know how Coda People Team runs on Coda, shoot me an email at leah [at]
coda.io
⁠


Gallery
Share
 
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.