diff --git a/README.md b/README.md
index 69c5532b913fb5d5c31802e656025ab5a8022bfa..57441c842a4a4a657287da16401a964d310445ed 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,13 @@
 # Frontend Toolkit
 
+## Overview
+
+This repository uses [yarn 1.x](https://classic.yarnpkg.com) workspaces to link
+multiple separate packages together and to hoist all shared dependencies to the
+top level node_modules.
+
+In addition we use [lerna](https://lerna.js.org/) for running commands for all contained packages (until we switch to yarn 2.x which should support this directly).
+
 ## Setup
 
 ```