diff --git a/README.md b/README.md
index b1b879c..fff1561 100644
--- a/README.md
+++ b/README.md
@@ -27,6 +27,11 @@
 
 1. Create credentials.yml template file
 
+Inventory Semantics
+===================
+
+[A full description of inventory semantics](inventory.md). 
+
 Scaffold required folders
 =========================