diff --git a/ext/angle_install_notes.md b/ext/angle_install_notes.md
new file mode 100644
index 0000000..fae4821
--- /dev/null
+++ b/ext/angle_install_notes.md
@@ -0,0 +1,77 @@
+## Angle install on macOS
+
+* Get ninja if needed: `brew install ninja`
+* Get the `depot_tools`repo: `git clone https://chromium.googlesource.com/* chromium/tools/depot_tools.git`
+* Set path: `export PATH=/path/to/depot_tools:$PATH`
+
+* Maybe necessary to fiddle with certificates here, otherwise `fetch angle` fails in the subsequent steps.
+
+```
+cd /Applications/Python\ 3.6
+sudo ./Install\ Certificates.command
+```
+* Fetch angle:
+
+```
+mkdir angle 
+cd angle
+fetch angle
+```
+* Generate build config: `gn gen out/Debug`
+
+	* To see available arguments: `gn args out/Debug --list`
+	* To change arguments: `gn args out/Debug`
+
+For example, to generate dwarf dsyms files, set:
+
+```	
+enable_dsyms=true
+use_debug_fission=true
+symbol_level=2
+```
+
+We also need to set `is_component_build=false` in order to have self-contained librarries.
+
+Then, build with `autoninja -C out/Debug`and wait until you pass out.
+
+## Angle install on windows
+
+* need Python3 (can install through win app store)
+* need Windows SDK
+* clone `depot_tools`: `git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git`
+or download and unzip bundle at [https://storage.googleapis.com/chrome-infra/depot_tools.zip](https://storage.googleapis.com/chrome-infra/depot_tools.zip)
+* set `depot_tools` in path env variable through control panel>System and security>system>advanced system settings
+* run `gclient` in a cmd shell
+* set `DEPOT_TOOLS_WIN_TOOLCHAIN=0`
+* `mkdir angle`
+* `cd angle`
+* `fetch angle`
+* wait a million years
+
+* if it fails when running `python3 third_party/depot_tools/download_from_google_storage.py ...`
+  -> open `DEPS` and change `third_party/depot_tools` to `../depot/tools`
+* run `gclient sync` to complete previous step
+
+* `gn gen out/Debug`
+* `gn args out/Debug` and edit arguments:
+	* `angle_enable_vulkan = false`
+	* `angle_build_tests = false`
+	* `is_component_build = false`
+
+* link with `libEGL.dll.lib` and `libGLESv2.dll.lib`
+* put `libEGL.dll` and `libGLESv2.dll` in same directory as executable
+
+## To get debugging kinda working with renderdoc:
+
+Run `gn args out/Debug` and set
+	* `angle_enable_trace = true`
+	* `angle_enable_annotator_run_time_checks = true`
+
+* `autoninja -C out/Debug`
+* wait a while
+
+In renderdoc, set env variables
+`RENDERDOC_HOOK_EGL 0` (if you want to trace underlying native API)
+`RENDERDOC_HOOK_EGL 1` (if you want to trace EGL calls. You also need to put `libEGL` in the renderdoc folder so it's found when capturing stuff. Unfortunately though, that seems to provoke crashes...)
+
+`ANGLE_ENABLE_DEBUG_MARKERS 1` (to turn on debug markers)
diff --git a/ext/angle_install_notes.txt b/ext/angle_install_notes.txt
deleted file mode 100644
index b80b5f3..0000000
--- a/ext/angle_install_notes.txt
+++ /dev/null
@@ -1,44 +0,0 @@
-angle install on windows
-
-* need Python3 (can install through win app store)
-* need Windows SDK
-* clone depot_tools git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
-or download and unzip bundle at https://storage.googleapis.com/chrome-infra/depot_tools.zip
-* set depot_tools in path env variable through control panel>System and security>system>advanced system settings
-* run gclient in a cmd shell
-
-* set DEPOT_TOOLS_WIN_TOOLCHAIN=0
-* mkdir angle
-* cd angle
-* fetch angle
-* wait a million years
-
-* fails when running python3 third_party/depot_tools/download_from_google_storage.py ...
-  -> open DEPS and change third_party/depot_tools with ../depot/tools
-
-* run gclient sync to complete previous step
-
-* gn gen out/Debug
-* gn args out/Debug and edit arguments:
-	angle_enable_vulkan = false
-	angle_build_tests = false
-	is_component_build = false
-
-	#to get debugging kinda working with renderdoc:
-	angle_enable_trace = true
-	angle_enable_annotator_run_time_checks = true
-
-
-* autoninja -C out/Debug
-* wait a while
-
-* link with libEGL.dll.lib and libGLESv2.dll.lib
-* put libEGL.dll and libGLESv2.dll in same directory as executable
-
-Debugging
----------
-in renderdoc, set env variables
-RENDERDOC_HOOK_EGL 0 (if you want to trace underlying native API)
-RENDERDOC_HOOK_EGL 1 (if you want to trace EGL calls. You also need to put libEGL in the renderdoc folder so it's found when capturing stuff. Unfortunately though, that seems to provoke crashes...)
-
-ANGLE_ENABLE_DEBUG_MARKERS 1 (to turn on debug markers)