diff --git a/README.markdown b/README.markdown
deleted file mode 100644
index 5cb1078..0000000
--- a/README.markdown
+++ /dev/null
@@ -1,8 +0,0 @@
-Jappix for Yunohost
-============
-
-[Yunohost project](https://yunohost.org/)
-
-Official website: <https://jappix.org/>
-
-Jappix v1.1.4
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b495116
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+Jappix for Yunohost
+-------------------
+
+*This is a work-in-progress package review to update it with changes
+new facilities - e.g. helpers - coming with YunoHost 2.3.x.*
+
+**Shipped version:** 1.1.6
+
+[Jappix](https://jappix.org) is a full-featured XMPP web-client
+with an open social platform which enables you to host your communication
+platform wherever you want to.
+
+## Installation
+
+While it's merged to the official application list, you can install it in order
+to try - or use it with caution! - either from the command line:
+
+    $ sudo yunohost app install https://github.com/YunoHost-Apps/jappix_ynh/tree/testing
+
+or from the Web administration:
+
+  * Go to *Applications*
+  * Click on *Install*
+  * Scroll to the bottom of the page and put `https://github.com/YunoHost-Apps/jappix_ynh/tree/testing`
+    under **Install custom app**.
+
+## Links ##
+
+**Jappix**: https://jappix.org/
+
+**YunoHost**: https://yunohost.org/