diff --git a/README.md b/README.md
index 773da99..3812bd2 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,13 @@ You should have a relatively recent version of Rust installed, then you just do:
 cargo build
 ```
 in the main directory of the project
+### Known build issues and workarounds:
++ * cmake not installed on Windows: * Install windows binaries from https://cmake.org/download/
++ * CMake Error: The source directory ".../ZLUDA/ext/spirv-tools" does not appear to contain CMakeLists.txt.*: update linked git submodules 
+```
+git submodule init
+git submodule update
+```
 
 ## License