diff --git a/man/README.md b/man/README.md
new file mode 100644
index 000000000..1d7a54fac
--- /dev/null
+++ b/man/README.md
@@ -0,0 +1,11 @@
+runc man pages
+====================
+
+This directory contains man pages for runc in markdown format.
+
+To generate man pages from it, use this command
+
+    ./md2man-all.sh
+
+You will see man pages generated under the man8 directory.
+