diff --git a/README.md b/README.md
index 09da381..c56c46e 100644
--- a/README.md
+++ b/README.md
@@ -1,31 +1,33 @@
 # Halcyon for YunoHost
 
+[![Integration level](https://dash.yunohost.org/integration/halcyon.svg)](https://dash.yunohost.org/appci/app/halcyon) ![](https://ci-apps.yunohost.org/ci/badges/halcyon.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/halcyon.maintain.svg)  
+[![Install Halcyon with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=halcyon)
 
-[![Integration level](https://dash.yunohost.org/integration/halcyon.svg)](https://dash.yunohost.org/appci/app/halcyon)  
-[![Install halcyon with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=halcyon)
+> *This package allows you to install Halcyon quickly and simply on a YunoHost server.  
+If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
 
-<br><br>
-Version: **2.4.8**
-<br>
-### Interesting links
-
-- [YunoHost project](https://yunohost.org)
-- [Halcyon](https://notabug.org/halcyon-suite/halcyon)
-- [Other Halcyon instances](https://notabug.org/halcyon-suite/halcyon/wiki/Instances)
-
-## Introduction
+## Overview
 Halcyon is a webclient for Mastodon and Pleroma which looks like Twitter.
 
-<img src="https://halcyon.cybre.space/login/assets/images/preview0.png"><br>
+**Shipped version:** 2.4.8
+
+## Screenshots
+
+![](https://halcyon.cybre.space/login/assets/images/preview0.png)
 
 ## Limitations
 
-* The app require a dedicaed domain like halcyon.domain.tld
+* Halcyon requires a dedicated domain like halcyon.domain.tld
 
 #### Supported architectures
 
-* x86-64b - [![Build Status](https://ci-apps.yunohost.org/ci/logs/halcyon%20%28Community%29.svg)](https://ci-apps.yunohost.org/ci/apps/halcyon/)
-* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/halcyon%20%28Community%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/halcyon/)
-* Jessie x86-64b - [![Build Status](https://ci-stretch.nohost.me/ci/logs/halcyon%20%28Community%29.svg)](https://ci-stretch.nohost.me/ci/apps/halcyon/)
+* x86-64 - [![Build Status](https://ci-apps.yunohost.org/ci/logs/halcyon%20%28Apps%29.svg)](https://ci-apps.yunohost.org/ci/apps/halcyon/)
+* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/halcyon%20%28Apps%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/halcyon/)
 
+## Links
 
+ * Report a bug: https://github.com/YunoHost-Apps/halcyon_ynh/issues
+ * App website: https://notabug.org/halcyon-suite/halcyon
+ * Upstream app repository: https://notabug.org/halcyon-suite/halcyon
+ * Other Halcyon instances: https://www.halcyon.social/instances.php
+ * YunoHost website: https://yunohost.org/