»Lesson 2

Best Practices for Structuring Information in Tettra

Investing in good organization is an investment in your future sanity. By organizing your knowledge well, it’ll be easier to find what you need, and other people on the team will have an easier time navigating (and adding to) your documentation. We’ve built Tettra’s search function to be pretty smart, but it also helps to follow a few best practices when you’re getting started. Here are some tips from customers on how they structure their information:
 

Categories

Most teams create categories that align with functional groups or departments. For instance, we have categories for Engineering, Product, Marketing, Support, Ops, etc. Additionally, we have 2 general categories that we keep pinned to the top of our Tettra dashboard. These include “Weekly Kickoffs & Recaps” and “Company Updates”, since we tend to access these categories on a regular basis, and they’re applicable to all.

 

Folders and Pages

Within a category, you can create folders to further organize your team’s knowledge. For example, within the “Product” category, there’s a folder we keep pinned to the top that’s titled “Monthly Priorities”. We create a new Tettra page for product priorities each month. It’s nice to have these pages all together and easily accessible, in case we want to review what we did during each month within a given quarter.
 

How to Structure Pages

Within your Tettra pages, there are some things you can do to help orient people to what they’re viewing. Some teams add a line at the top of every page with the context of that page. For example, this page might have the following blurb as its first line:
 
Context: This page contains a Tettra Academy lesson about properly organizing information”
 
This header helps people determine, at a glance, what the page contains. Another team suggests using various synonyms throughout the page to make sure the content is easy to find. For example, on this page, I might sprinkle in various “academy” synonyms like lesson, course, or tutorial, so that it’s easier to find this page when searching.

Your assignment

Start building out some basic categories, based on functional areas within your company. If you're launching Tettra with a single department or group, create different categories according to specific job functions. Also create at least one category that's for more general information, (like working from home policies or guidance about how you use email vs Slack vs meetings.)