diff --git a/README.md b/README.md
index 690b50f..06696ad 100644
--- a/README.md
+++ b/README.md
@@ -19,10 +19,38 @@ Create and email invoices, track payments, expenses, and time tasks
 
 **Shipped version:** 5.2.14~ynh1
 
+**Demo:** https://app.invoiceninja.com/dashboard
 
+## Screenshots
+
+![](./doc/screenshots/Create-Invoices-in-Seconds.png)
+
+## Disclaimers / important information
+
+### Warning
+
+This is the new version of InvoiceNinja. There are several things not working at the moment:
+
+* migration from v4
+* installation into a sub-directory
+* sending mails
+
+Invoice Ninja is the #1 open-source platform to create & email invoices, track payments and expenses, and time billable tasks & projects for clients.
+
+## YunoHost specific features
+
+#### Multi-user support
+
+* There is no official LDAP support
+* The first user gets created after installing Invoice Ninja
+* Other users can be created from inside the application
 
 ## Documentation and resources
 
+* Official app website: https://invoiceninja.org
+* Official user documentation: https://yunohost.org/apps
+* Official admin documentation: https://docs.invoiceninja.com/index.html
+* Upstream app code repository: https://github.com/invoiceninja/invoiceninja
 * YunoHost documentation for this app: https://yunohost.org/app_invoiceninja5
 * Report a bug: https://github.com/YunoHost-Apps/invoiceninja5_ynh/issues
 
diff --git a/README_fr.md b/README_fr.md
index ccf77ff..9a312a8 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -15,10 +15,38 @@ Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour
 
 **Version incluse :** 5.2.14~ynh1
 
+**Démo :** https://app.invoiceninja.com/dashboard
 
+## Captures d'écran
+
+![](./doc/screenshots/Create-Invoices-in-Seconds.png)
+
+## Avertissements / informations importantes
+
+### Warning
+
+This is the new version of InvoiceNinja. There are several things not working at the moment:
+
+* migration from v4
+* installation into a sub-directory
+* sending mails
+
+Invoice Ninja is the #1 open-source platform to create & email invoices, track payments and expenses, and time billable tasks & projects for clients.
+
+## YunoHost specific features
+
+#### Multi-user support
+
+* There is no official LDAP support
+* The first user gets created after installing Invoice Ninja
+* Other users can be created from inside the application
 
 ## Documentations et ressources
 
+* Site officiel de l'app : https://invoiceninja.org
+* Documentation officielle utilisateur : https://yunohost.org/apps
+* Documentation officielle de l'admin : https://docs.invoiceninja.com/index.html
+* Dépôt de code officiel de l'app : https://github.com/invoiceninja/invoiceninja
 * Documentation YunoHost pour cette app : https://yunohost.org/app_invoiceninja5
 * Signaler un bug : https://github.com/YunoHost-Apps/invoiceninja5_ynh/issues