diff --git a/docs/site/docs-en/introduction.md b/docs/site/docs-en/introduction.md
index e6456372..cf3d119b 100644
--- a/docs/site/docs-en/introduction.md
+++ b/docs/site/docs-en/introduction.md
@@ -1,8 +1,10 @@
 ---
-title: Introduction
-description: What FerrFlow is and why it exists.
+title: What is FerrFlow? Semantic versioning CLI
+description: FerrFlow is a single binary that reads your commits, bumps versions in any file format, writes the changelog and publishes the release. Monorepo or classic repo.
 ---
 
+# What is FerrFlow?
+
 FerrFlow is a single binary that automates semantic versioning for any repository: monorepo or classic, any language.
 
 It reads your commit history, determines the right version bump, updates your version files, writes a changelog, creates a git tag, and publishes a release. Zero runtime dependencies.
diff --git a/docs/site/docs-fr/introduction.md b/docs/site/docs-fr/introduction.md
index ac1a43fe..7db2ac34 100644
--- a/docs/site/docs-fr/introduction.md
+++ b/docs/site/docs-fr/introduction.md
@@ -1,8 +1,10 @@
 ---
-title: Introduction
-description: Ce qu'est FerrFlow et pourquoi il existe.
+title: Qu'est-ce que FerrFlow ? CLI de versionnage sémantique
+description: FerrFlow est un binaire unique qui lit vos commits, incrémente les versions dans n'importe quel format de fichier, rédige le changelog et publie la release. Monorepo ou repo classique.
 ---
 
+# Qu'est-ce que FerrFlow ?
+
 FerrFlow est un binaire unique qui automatise le versionnage sémantique pour n'importe quel repository : monorepo ou classique, quel que soit le langage.
 
 Il analyse votre historique de commits, détermine le bon incrément de version, met à jour vos fichiers de version, rédige un changelog, crée un tag git et publie une release. Zéro dépendance runtime.