diff --git a/srcs/compose/README.md b/srcs/compose/README.md
new file mode 100644
index 0000000..a3cfdb3
--- /dev/null
+++ b/srcs/compose/README.md
@@ -0,0 +1,8 @@
+# Compose sequences
+
+The `compose.py` program parses the compose sequences found in this directory
+and generates `srcs/juloo.keyboard2/ComposeKeyData.java`.
+
+## `en_US_UTF_8_Compose.pre`
+
+This file is copied from the `xorg` project. Copyright applies.