diff --git a/README b/README
new file mode 100644
index 0000000000000000000000000000000000000000..6577c3da6cef7f60f81eb2b38292adfe5daa94ca
--- /dev/null
+++ b/README
@@ -0,0 +1,5 @@
+
+## The switch Markov chain
+
+An implementation of an algorithm using the switch Markov chain for sampling irregular graphs and digraphs
+