diff --git a/pkgs/README.md b/pkgs/README.md
new file mode 100644
index 00000000..43ceb7e4
--- /dev/null
+++ b/pkgs/README.md
@@ -0,0 +1,5 @@
+### Notes
+
+propagatedBuildInputs: when providing definition for a package xo-foo:
+dependencies xo-foo needs, that will also be transitive for some other package
+that uses xo-foo.