diff --git a/Rez/README.md b/Rez/README.md
new file mode 100644
index 0000000000..807dc0cffd
--- /dev/null
+++ b/Rez/README.md
@@ -0,0 +1,12 @@
+Rez Resource Compiler
+=====================
+
+A reimplementation of the classic Rez resource compiler.
+
+
+Known Bugs & Limitations
+-----------------
+
+* `$ABCD` alternate syntax for hex numbers is not supported
+* hex strings not supported
+* Other than in Apple Rez, the preprocessor is case sensitive.