diff --git a/ucm/README.md b/ucm/README.md
new file mode 100644
index 0000000..2cbbfd1
--- /dev/null
+++ b/ucm/README.md
@@ -0,0 +1,5 @@
+Use Case Configuration files v1 syntax
+--------------------------------------
+
+This directory holds old UCM configuration files. The new
+configuration files should be created in the ucm2 tree only.
diff --git a/ucm2/README.md b/ucm2/README.md
new file mode 100644
index 0000000..3aefdf7
--- /dev/null
+++ b/ucm2/README.md
@@ -0,0 +1,17 @@
+Use Case Configuration files
+----------------------------
+
+Library directories:
+
+  platforms/
+  codecs/
+  dsps/
+
+Those directories are not inspected for the list of
+available UCM configurations. They contain files
+included from other UCMs.
+
+Syntax, value names
+-------------------
+
+https://git.alsa-project.org/?p=alsa-lib.git;a=blob;f=include/use-case.h