diff --git a/README.md b/README.md
new file mode 100644
index 0000000..371a9dd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,6 @@
+# vga
+This crate provides vga specific functions, data structures,
+and access to various registers.
+
+Memory addresses `0xA0000 -> 0xBFFFF` must be readable and writeable
+this crate to work properly.