1 files changed, 21 insertions, 0 deletions
diff --git a/src/features/README.md b/src/features/README.md
new file mode 100644
index 000000000..75c85a84f
--- /dev/null
+++ b/src/features/README.md
@@ -0,0 +1,21 @@
+# OpenType features
+
+This directory contains most (but not all) OpenType feature code.
+
+- Some features are maintained by the Glyphs application and are stored in the .glyphs file.
+- The order of features are defined in the .glyphs file
+
+Each feature file in this directory is automatically wrapped in a `feature {...}` block.
+For example, `cv07.fea` contains the following code:
+
+```fea
+sub germandbls by germandbls.1;
+```
+
+And when the font is compiled, it actually becomes:
+
+```
+feature cv07 {
+  sub germandbls by germandbls.1;
+}
+```