Published in


The importance of documentation for Remote Teams — Part I

As Andreas Klinger writes in his extremely insightful and practical post “Managing Remote Teams — A Crash Course”, a remote team needs roughly 5x process in comparison to a co-located team.

Process can sometimes be misinterpreted as bureaucracy, when it’s really trying to be the opposite of that. Good process is a set of clear rules and expectations that are easily accessible and easily followed. For a remote team, where you want to enable people to be as autonomous as possible, good process is essential.

Over the last month, we have been furiously documenting how we do things on our team (i.e. process), and I’ll be the first one to admit, it’s been a lot of work. However, we are starting to see results and as time goes by and the team grows, these benefits will grow exponentially.

The three key areas that we have focused on to start are: onboarding, management/career progression and hiring. In this post, I’ll dig deeper into onboarding.


Setting a new team member up for success from day one is critical. Onboarding colors how the new person perceives the team and the company. If their first contact with the company is a disorganized mess, they are much more likely to adopt bad habits which will be harder to break later. First impressions do matter! So, focus on onboarding first and get it right.

Here are some of the key areas we cover in our documentation:

Intro to the company and the team

  • Who we are
  • How we are structured
  • Our vision, mission, strategy, culture, objectives/priorities and our values

How we work

  • Work hours and breaks
  • Communication. What are the rules for using synchronous vs asynchronous communication. How do we respect each others’ time and boundaries? How do we optimize everyone’s time for deep work?
  • Slack. What channels do we have and what are they used for?
  • Check ins and check outs. Why we do them and what to expect.
  • Weekly team updates. What’s covered and when to expect them.
  • Escalation policies. How do you get in touch with people when things go sideways.
  • Our approach to Remote Work (refer to previous posts for more details)
  • How we run meetings and what are the rules and responsibilities around meetings.
  • Time off. How to request it? What about sick days?
  • Agile workflow. How we approach agile software development and what our practices are.
  • Tools and Accounts. What are all the tools we use? How do you get access?
  • General How Tos. Tips and tricks from the team.

Getting Set up

In this section, we tell people all the tactical details around getting set up. Here are the key areas we cover:

  • Equipment
  • Your Manager. Clearly defined set of responsibilities that a manger has so that people know what they can hold their managers accountable for.
  • Emergency Contact List
  • Team calendars
  • Email groups
  • Email signature
  • Referral policy

After the general introduction to the team/company, how we work and basic setup and information, each sub-team continues with its own specific onboarding. Let’s have a look at Engineering team’s onboarding in more detail.

Engineering Onboarding

Here are the areas that are covered in more detail:

  • Week 1–2 and 2+ general expectations
  • Day 1 detailed schedule
  • Engineering specific calendars
  • Overview of major areas engineering is responsible for
  • Top level architecture
  • Relevant Github repos
  • Processes related to agile, trunk based development, environments, PRs, testing, deployments, metrics and monitoring, etc.

This is our first pass of the onboarding documentation and it’s constantly getting better. As the team grows, it’s critical that each new person coming in is able to improve on this documentation, leaving it better for the next hire.

In Part II of this post, we’ll talk more about documenting management practices and career progression.




On building remote-first companies

Recommended from Medium

Nonessential Tech Tip: How to preserve and use your 15 year old Windows XP Operating System…

Tutorial: a Facebook Bot for beginners

Scrum vs Kanban

How to use TailwindCSS JIT with negative arbitrary values

Understanding Agile #Part1

Vertex Snapping Unity

0x Developer Update — August 2020

Selection Sort

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Marko Vasiljevic

Marko Vasiljevic

Tech Entrepreneur

More from Medium

Women’s History Month Showcase: Meet Tharaa Elmorssi

What would Super Mario do? Leveraging gamification at your virtual and hybrid event


‘Resonate’: Architecture Competition seeks ideas and projects Design contest for a concert hall in…