As a remote company, documentation is a huge part of how we work together successfully. Clear, accessible documentation ensures that knowledge is shared efficiently, decisions are well-documented, and teammates can work autonomously. It helps us reduce redundant questions, onboard new teammates more smoothly, and create a transparent, well-organized workplace.
Why documentation matters
- Enables async collaboration: Since we don’t always work at the same time, documentation keeps everyone aligned, regardless of time zones.
- Creates transparency: Documentation helps us build trust by making decisions, strategies, and processes visible to all.
- Boosts efficiency: Instead of answering the same questions repeatedly, well-documented processes save time and allow for deep, focused work.
- Reduces knowledge silos: Important insights and decisions shouldn’t live only in DMs or someone’s memory. Documentation makes information accessible to everyone.
- Improves onboarding: New teammates can ramp up faster when there’s a clear record of how things work.
How we approach documentation
- Default to writing things down: If a decision is made or a process is created, document it somewhere accessible (like Notion, Campsite, or the project in Linear)
- Ensure it’s structured and searchable (like this page!): Structure documentation in a way that is easy to search and navigate.
- Clear and concise: Make sure the content is easy to read and understand
- Keep it updated: Make it a habit to review and refresh content regularly
Where to document what?
- Notion: Best for structured, formal documentation like evergreen resources, guides, and policies
- Note: we have two sections in Notion: ‣ and Teammate Handbook. The Teammate Handbook is a public-facing collection of guides, resources, and team processese and Internal Collaboration a private area where each team has their own space for project work, notes, and internal collaboration.
- Campsite: Ongoing team discussions, proposals, and async decision-making
- Slack: Quick updates, real-time conversations, and temporary discussions
- Linear: Task management, sprint planning, and project tracking