diff --git a/hledger/test/ledger-compat/README.md b/hledger/test/ledger-compat/README.md
new file mode 100644
index 000000000..17e7dc76d
--- /dev/null
+++ b/hledger/test/ledger-compat/README.md
@@ -0,0 +1,9 @@
+Ledger compatibility tests, focussed on reading journal files for now.
+See https://github.com/simonmichael/hledger/issues/1962
+
+baseline/ and regress/ are a snapshot of Ledger's functional tests,
+with all but the sample data commented, converted to shelltests which
+test reading.
+
+test runs all tests and saves a dated pretty log which can be browsed
+with org mode.