diff --git a/README.md b/README.md
index fbdf40d..ee4cf3f 100644
--- a/README.md
+++ b/README.md
@@ -36,3 +36,12 @@
   Now you can open [localhost:4000](http://127.0.0.1:4000/msm/) with your Web
   browser. Jekyll will automatically regenerate the pages if any of the source
   files changes.
+
+## Add new SoC / PMIC
+
+Base your new file in either `./_soc/` or `./_pmic/` on `_soc.template` or
+`_pmic.template` respectively. If those files do not exist yet in your tree,
+call `./regen.py`!
+
+For an SoC file you can additionally specify the key `pmic:` where you can
+reference PMICs which are usually bundled with a given SoC.