--- a
+++ b/README.md
@@ -0,0 +1,20 @@
+# OpenSAFELY ehrQL
+
+ehrQL is a Python-based query language for electronic health record (EHR) data.
+It has been designed for use with the OpenSAFELY platform.
+
+Documentation is at the [OpenSAFELY documentation site](https://docs.opensafely.org/ehrql).
+
+# For developers
+
+See [DEVELOPERS.md](DEVELOPERS.md).
+
+There is also [a glossary](GLOSSARY.md) of terms used in the codebase.
+
+# About the OpenSAFELY framework
+
+The OpenSAFELY framework is a Trusted Research Environment (TRE) for electronic
+health records research in the NHS, with a focus on public accountability and
+research quality.
+
+Read more at [OpenSAFELY.org](https://opensafely.org).