diff --git a/README.md b/README.md
index f98f434708..55b9dc086b 100644
--- a/README.md
+++ b/README.md
@@ -35,11 +35,11 @@
 </div>  
 <br>
 
-`bpmn-visualization` is a TypeScript library for visualizing process execution data on [BPMN](https://www.omg.org/spec/BPMN/2.0.2/) diagrams with:
-- additional display options for execution data (highlight some transitions, counters, and more)
-- interactive capacities (mouse hover, click)
+`bpmn-visualization` is a TypeScript library for visualizing process execution data on [BPMN](https://www.omg.org/spec/BPMN/2.0.2/) diagrams, with simplicity.
 
-<br>
+Based on the customization capability, it provides a set of diagram visualization features that includes additional display options for execution data (_highlighting of some elements_, _adding customizable overlays_, and more) as well as personalized interactive capabilities (_mouse hover_, _click_, and more).
+
+We hope it will help you to create applications for process visualization and analysis 🙂
 
 
 ## 🎮 Demo and examples
diff --git a/docs/users/intro.adoc b/docs/users/intro.adoc
index 4fcd979019..676368e8e9 100644
--- a/docs/users/intro.adoc
+++ b/docs/users/intro.adoc
@@ -1,2 +1,5 @@
-`bpmn-visualization` is a TypeScript library for visualizing process execution data on https://www.omg.org/spec/BPMN/2.0.2/[BPMN]
-diagrams.
+`bpmn-visualization` is a TypeScript library for visualizing process execution data on https://www.omg.org/spec/BPMN/2.0.2/[BPMN] diagrams, with simplicity.
+
+Based on the customization capability, it provides a set of diagram visualization features that includes additional display options for execution data (_highlighting of some elements_, _adding customizable overlays_, and more) as well as personalized interactive capabilities (_mouse hover_, _click_, and more).
+
+We hope it will help you to create applications for process visualization and analysis 🙂