diff --git a/README.md b/README.md
new file mode 100644
index 0000000..30cea3f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+Software repository for the neutron reflectometer Amor at the Paul Scherrer Institut, Switzerland
+
+reduction of the raw files (.hdf) to reflectivity files in one of the representations of the **ORSO reflectivity file format**:
+
+> eos.py
+
+visualisation of the content of a raw file (.hdf):
+
+> events2histogram.py
+