diff --git a/IQ/README.md b/IQ/README.md
new file mode 100644
index 0000000..59fb30d
--- /dev/null
+++ b/IQ/README.md
@@ -0,0 +1,17 @@
+IQ demodulation
+------------
+Basic equations of IQ demodulation with phase noise
+
+Test it
+----------
+run in iPython environment to show local variables
+
+```sh
+ipython
+```
+
+```ipython
+run IQ.py
+IF_I
+IF_Q
+```
diff --git a/PDH/README.md b/PDH/README.md
new file mode 100644
index 0000000..8807bd7
--- /dev/null
+++ b/PDH/README.md
@@ -0,0 +1,16 @@
+Pound-Drever-Hall
+------------
+PDH discriminant calculations
+
+Test it
+----------
+run in iPython environment to show local variables
+
+```sh
+ipython
+```
+
+```ipython
+run PDH.py
+eps_pdh
+```
diff --git a/compensated_link/README.md b/compensated_link/README.md
new file mode 100644
index 0000000..566eddd
--- /dev/null
+++ b/compensated_link/README.md
@@ -0,0 +1,17 @@
+Compensated link
+------------
+Compensated optical fiber-link based on Michelson setup.
+Correction applied to AOM frequency
+
+Test it
+----------
+run in iPython environment to show local variables
+
+```sh
+ipython
+```
+
+```ipython
+run compensated_link.py
+eps
+```
diff --git a/doppler/README.md b/doppler/README.md
new file mode 100644
index 0000000..cd6e0a7
--- /dev/null
+++ b/doppler/README.md
@@ -0,0 +1,16 @@
+Doppler
+------------
+Show Doppler effect on Q-demodulated signal
+
+Test it
+----------
+run in iPython environment to show local variables
+
+```sh
+ipython
+```
+
+```ipython
+run doppler.py
+Vmix
+```
diff --git a/mich_psd_calculations/README.md b/mich_psd_calculations/README.md
new file mode 100644
index 0000000..95d67d5
--- /dev/null
+++ b/mich_psd_calculations/README.md
@@ -0,0 +1 @@
+estimation of path lenght noise
diff --git a/michelson_w_AOM/README.md b/michelson_w_AOM/README.md
new file mode 100644
index 0000000..cda6b3a
--- /dev/null
+++ b/michelson_w_AOM/README.md
@@ -0,0 +1,16 @@
+Heterodyne Michelson with phase noise induced by Doppler effect
+------------
+Correction applied to path lenght with PZT or other
+
+Test it
+----------
+run in iPython environment to show local variables
+
+```sh
+ipython
+```
+
+```ipython
+run michelson_w_AOM.py
+Vmix
+```
diff --git a/mixer/README.md b/mixer/README.md
new file mode 100644
index 0000000..e3de539
--- /dev/null
+++ b/mixer/README.md
@@ -0,0 +1,17 @@
+Mixer equations
+------------
+Comparaison of polynomial and simple-product approaches of RF mixer
+
+Test it
+----------
+run in iPython environment to show local variables
+
+```sh
+ipython
+```
+
+```ipython
+run mixer.py
+Vmix_poly
+Vmix_prod
+```