diff --git a/2-IOC-deployment.md b/2-IOC-deployment.md
index 671ad9a37ef070f3077e05de4feec628a93f6ff4..fb73dc415b2d75b597da668b4f5b2bdd1de9d331 100644
--- a/2-IOC-deployment.md
+++ b/2-IOC-deployment.md
@@ -181,7 +181,10 @@ $ echo "LINUX_NET_INSTALLED = NO" > configure/CONFIG_SITE.local
 
 ### 2.8 Build the IOC
 
+We do a clean build at this point to ensure the fix for the previous failed build takes effect.  The value that was set in in `CONFIG_SITE.local` causes some software to be exluded from the IOC.  Without the `make distclean` the excluded software can be partially included in the IOC, which results in build problems.
+
 ```
+$ make distclean
 $ make
 ```