-# Build under Ubuntu
-
-```sudo apt install software-properties-common wget
-wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
-sudo apt-add-repository 'deb http://apt.llvm.org/xenial/ llvm-toolchain-xenial-4.0 main'
-sudo apt update
-sudo apt install build-essential git clang-4.0 llvm-4.0-dev cmake zlib1g-dev
-git clone https://github.com/programmerjake/vulkan-cpu.git
-cd vulkan-cpu
-mkdir build
-cd build
-cmake .. -DCMAKE_CXX_COMPILER="`which clang++-4.0`" -DCMAKE_C_COMPILER="`which clang-4.0`" -DCMAKE_BUILD_TYPE=Debug
-make
-```
\ No newline at end of file
+# Vulkan-cpu
+
+Work-in-progress for Vulkan implementation on cpu
+
+## Build under Ubuntu 16.04 (xenial)
+
+ sudo apt install software-properties-common wget
+ wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
+ sudo apt-add-repository 'deb http://apt.llvm.org/xenial/ llvm-toolchain-xenial-4.0 main'
+ sudo apt update
+ sudo apt install build-essential git clang-4.0 llvm-4.0-dev cmake zlib1g-dev
+ git clone https://github.com/programmerjake/vulkan-cpu.git
+ cd vulkan-cpu
+ mkdir build
+ cd build
+ cmake .. -DCMAKE_CXX_COMPILER="`which clang++-4.0`" -DCMAKE_C_COMPILER="`which clang-4.0`" -DCMAKE_BUILD_TYPE=Debug
+ make
+
+Using the version of LLVM that comes with Ubuntu doesn't work.
+See [Issue #1](https://github.com/programmerjake/vulkan-cpu/issues/1) for more details.