diff --git a/README.md b/README.md
index 6ff2d51..9f4798e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,21 @@
 # jipf 2023
 
 #### install
+---
 
 this project uses submodules recursively, so you after cloning you need to :
+
 `git submodule update --init --recursive`
+
+
+#### presentation
+---
+
+- this repo is a plugin for wordpress, designed to be used inside a specific website : [2022.lejourdesprofs.org](https://2022.lejourdesprofs.org/#programme)
+- this is a website for an event, that took place in november 2022, and was proposing hundreds of speakers all around the world
+- and this plugin generates a map, based on google maps, with markers that places every speach
+- it allows for filters and selections
+
+![demonstration of the markers zooming](docs/ljdp_map_clusters.gif)
+![demonstration of the filters for selection](docs/ljdp_map_filters.gif)
+