diff --git a/README.md b/README.md
index 710f0d5e..12cfd39b 100644
--- a/README.md
+++ b/README.md
@@ -13,3 +13,12 @@ The repo uses `pnpm` workspaces. To install the dependencies:
 ```sh
 pnpm install
 ```
+
+and to build the packages:
+
+```sh
+pnpm run build
+```
+
+Note, that everytime you make a change to a workspace that is used as a dependency of another, you need to rebuild the
+changed package (otherwise you might get weird JS/TS errors).
diff --git a/packages/common/README.md b/packages/common/README.md
index d44dcb59..b01cd831 100644
--- a/packages/common/README.md
+++ b/packages/common/README.md
@@ -1,3 +1,11 @@
 # common
 
 Utilities commonly used by other packages.
+
+## Getting started
+
+Use:
+
+```sh
+pnpm run build
+```