diff --git a/README.md b/README.md
index 24713fe..29eea87 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,31 @@ If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/in
 
 ## Overview
 
-Glitch-Soc, a fork of Mastodon, is a free, open-source microblogging social network. It is a decentralized alternative to commercial platforms like Twitter and avoids the risks of a single company monopolizing your communication for commercial purposes. 
+`glitch-soc` is a friendly [fork](https://en.wikipedia.org/wiki/Fork_(software_development)) of the open-source social media software [Mastodon](https://joinmastodon.org/), with the aim of providing additional features at the risk of potentially less stable software.
+
+###  What's different from Mastodon?
+
+`glitch-soc` adds a number of experimental features to Mastodon, such as:
+
+- Media improvements
+  - Images inside the CW spoiler
+  - fullwidth images
+  - scaling options
+- Formatted toots
+- Reply selection in lists
+- Filter improvements
+- Highlighting of misleading links
+- Hiding follower count
+- An app settings modal
+- Collapsible toots
+- Toot visibility icons
+- Local-only toots
+- Threaded mode
+- `data-*` attributes on statuses
+- Advanced theming via flavours+skins
+- Doodle
+
+See more [on the documentation](https://glitch-soc.github.io/docs/).
 
 
 **Shipped version:** 2022.02.12~ynh1
@@ -26,6 +50,8 @@ Glitch-Soc, a fork of Mastodon, is a free, open-source microblogging social netw
 
 ⚠️ Glitch-Soc is beta software, and under active development. Use at your own risk!
 
+### Install
+
 * This app require a dedicated domain or subdomain.
 * The user choosen during the installation is created in Glitch-Soc with admin rights.
 
diff --git a/README_fr.md b/README_fr.md
index 3f98063..934c3b8 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -11,7 +11,31 @@ Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour
 
 ## Vue d'ensemble
 
-Glitch-Soc, une scission de Mastodon, est un réseau social de microblog auto-hébergé et open source. C'est une alternative décentralisée aux plates-formes commerciales comme Twitter. Glitch-Soc évite ainsi les risques qu'une seule société monopolise votre communication à des fins commerciales.
+`glitch-soc` est une [scission](https://fr.wikipedia.org/wiki/Fork_(d%C3%A9veloppement_logiciel)) sympa du logiciel de réseau social libre [Mastodon](https://joinmastodon.org/), avec comme objectif de fournir des fonctionnalités supplémentaires, au risque d'un logiciel un peu moins stable.
+
+###  Quelles sont les différences avec Mastodon?
+
+`glitch-soc` ajoute de nombreuses fonctionnalitées expérimentals, comme :
+
+- Améliorations des média
+  - Images masquées pas le CW
+  - Images en pleine largeure
+  - Options de mise à l'échelle
+- Formattage des pouets
+- Sélectionner les réponses dans les listes
+- Amélioration des filtres
+- Mise en avant des liens trompeurs
+- Cacher les compteur d'abonné⋅e⋅s
+- Une boite de paramètres
+- Pouets pliants
+- Icones pour le niveau de visibilité des pouets
+- Pouets locaux
+- Mode fil de pouts
+- Attribut `data-*` sur les pouets
+- Gestion des thèmes avancée via flavours+skins
+- Doodle
+
+Voir plus [sur la documentation](https://glitch-soc.github.io/docs/) (en anglais).
 
 
 **Version incluse :** 2022.02.12~ynh1
@@ -22,10 +46,12 @@ Glitch-Soc, une scission de Mastodon, est un réseau social de microblog auto-h
 
 Glitch-Soc est en constant développement, fournis avec les dernières fonctionnalités (incluant les derniers bugs).
 
-* L'application a besoin d'un domaine dédié.
-* L'utilisateur⋅ice choisi⋅es lors de l'installation sera administrateur⋅ice de l'instance. Il est possible d'en ajouter d'autre depuis l'application.
+### Installation
 
-L'authentification par LDAP et le Single-Sign-On sont activés pour les utilisateur⋅ices YunoHost.
+* L'application a besoin d'un domaine dédié.
+* L'utilisateurice choisie lors de l'installation sera administrateurice de l'instance. Il est possible d'en ajouter d'autre depuis l'application.
+
+L'authentification par LDAP et le Single-Sign-On sont activés pour les utilisateurices YunoHost.
 
 Nous vous invitons à bloquer les instances malveillantes depuis l'interface d'administration. Vous pouvez également ajouter du texte sur votre page d'accueil.