diff --git a/README.md b/README.md
index 5403f45..0124400 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,17 @@
 # c64-devkit
+All you need to start programming 6502 assembler for the Commodore 64 on Microsoft Windows.
 
-All you need to start programming 6502 assembler for the Commodore 64.
+## Usage
+Run `build.bat` to compile, crunch and launch your code in the VICE emulator.
+
+## Notes
+Source code is located in `source/` and can reside in multiple files ending with `.asm`. 
+
+This devkit is based on the following components:
+* ACME https://sourceforge.net/projects/acme-crossass/
+* pucrunch https://github.com/mist64/pucrunch
+* VICE http://vice-emu.sourceforge.net/
+* Genosine https://github.com/cliffordcarnmo/genosine
+* Pixcen https://github.com/Hammarberg/pixcen
+* Ganged http://www.thegang.nu/releases.php?type=4&year=all&headline=Utils&nomenu=1
+* vchar64 https://github.com/ricardoquesada/vchar64