diff --git a/README.md b/README.md
index 8cb6db9..be18079 100644
--- a/README.md
+++ b/README.md
@@ -59,7 +59,7 @@ Running the demo only:
- Build the lib: `npm run build -w packages/addons`
- Run the demo: `npm run dev -w packages/demo`. The demo is accessible at http://localhost:5173/
-Develop in the lib and live update the demo
+Develop the lib and live update the demo
- run `npm run dev`
@@ -95,7 +95,7 @@ Create a new GitHub release by following the [GitHub help](https://help.github.c
## ⚡ Powered by
-
+
**[GitHub Pages](https://pages.github.com/)** (demo live environment)
diff --git a/packages/addons/README.md b/packages/addons/README.md
index 3066b49..700c8a7 100644
--- a/packages/addons/README.md
+++ b/packages/addons/README.md
@@ -26,7 +26,7 @@ Limitations
### `PathResolver`
-Infer paths. Currently, only infer edges/flows given a list of flow node ids.
+Infer BPMN path. Currently, only infer edges/flows given a list of flow node ids.
**WARNING**: this is front-end processing. It's more efficient for this type of processing to be carried out in the backend.
Use it to bypass the limitations of the tools and algorithms provided in the backend.
diff --git a/packages/demo/README.md b/packages/demo/README.md
index 28fcdb3..98c283d 100644
--- a/packages/demo/README.md
+++ b/packages/demo/README.md
@@ -3,3 +3,5 @@
The demo has been initialized using [bpmn-visualization-demo-template](https://github.com/process-analytics/bpmn-visualization-demo-template/).
See the main [README](../../README.md) for development setup.
+
+The list of features demonstrated is available in [index.html](./index.html).
diff --git a/packages/demo/index.html b/packages/demo/index.html
index 7957d91..8a4b136 100644
--- a/packages/demo/index.html
+++ b/packages/demo/index.html
@@ -1,24 +1,37 @@
-