diff --git a/README b/README.md
similarity index 63%
rename from README
rename to README.md
index 32ea32586e08814f74dd4faea27d626d62b16cb5..a1e2ba6ead7e48a9324d044204ca873a02939a00 100644
--- a/README
+++ b/README.md
@@ -1,7 +1,10 @@
+# Ring Android
+
+## Environnement
+
 Make sure you have the android-ndk and android-sdk, and you'll want something
 like this in your .bashrc (or equivalent):
 
-# setup Android paths
 export ANDROID_NDK=$HOME/src/android-ndk
 export ANDROID_NDK_ROOT=$ANDROID_NDK
 export ANDROID_SDK=$HOME/src/android-sdk-linux
@@ -9,9 +12,21 @@ export ANDROID_HOME=$ANDROID_SDK
 export PATH=$ANDROID_SDK/platform-tools:${PATH}
 
 
+## Build instructions
+
 When all else fails:
 
 rm -rf sflphone
 git clean -dfx
 export ANDROID_ABI=armeabi-v7a
 ./compile.sh
+
+
+## Common issues
+
+* Makeinfo issue
+
+    makeinfo: command not found
+    WARNING: 'makeinfo' is missing on your system.
+
+    **Solution**: Install texinfo package containing makeinfo dep.