2 files changed, 13 insertions, 3 deletions
diff --git a/README b/README
new file mode 100644
index 00000000..55a9c430
--- /dev/null
+++ b/README
@@ -0,0 +1,6 @@
+This repository contains the documentation for all main GNU Taler components.
+
+Before building the documentation, make sure that you have the required
+dependencies installed using pip3:
+
+$ pip3 install --user --upgrade recommonmark sphinx
diff --git a/conf.py b/conf.py
index 47f494ff..2558c784 100644
--- a/conf.py
+++ b/conf.py
@@ -51,14 +51,18 @@ extensions = [
     'tsref',
     'sphinx.ext.todo',
     'sphinx.ext.imgmath',
-    'httpdomain.httpdomain'
+    'httpdomain.httpdomain',
+    'recommonmark',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
-# The suffix of source filenames.
-source_suffix = '.rst'
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.txt': 'markdown',
+    '.md': 'markdown',
+}
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'