diff --git a/docs/developers-guide.md b/docs/developers-guide.md
index 9cc0afdd962e7cb1ad5a214c1501cca4062ba01a..53431a3f7cf5c7017c4dd06c627d9b9233314035 100644
--- a/docs/developers-guide.md
+++ b/docs/developers-guide.md
@@ -70,6 +70,10 @@ Start the frontend build process with
 
     yarn run build-hot
 
+Caveat - Yarn does not properly support `build-hot` on Windows 8/10. You will need to manually build the frontend client with
+    
+    yarn run build
+
 This will get you a full development server running on port :3000 by default.