From f452cef95230fd090095631458a46a3df6315743 Mon Sep 17 00:00:00 2001
From: Sebastien Quioc <sebastien.quioc@sekoia.fr>
Date: Thu, 7 May 2026 15:55:28 +0200
Subject: [PATCH 1/2] feat(Mise): add mise en place to manage the dev
 environment for the documentation

---
 mise.toml | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 mise.toml

diff --git a/mise.toml b/mise.toml
new file mode 100644
index 0000000000..c7f64b6d20
--- /dev/null
+++ b/mise.toml
@@ -0,0 +1,45 @@
+[tools]
+node = "22"
+python = "3.14"
+uv = "0.11.8"
+yarn = "1.22.22"
+
+[settings]
+python.uv_venv_auto = "create|source"
+
+[env]
+OPENAPI_VIEWER_DIR = "lib/openapi-viewer"
+
+[tasks.install]
+description = "Setup the project"
+run = '''
+uv sync
+yarn --cwd ${OPENAPI_VIEWER_DIR} install
+'''
+
+[tasks."doc:serve"]
+description = "Serve the documentation"
+run = "uv run mkdocs serve -s"
+
+[tasks."doc:check"]
+description = "Validate the documentation"
+run = "uv run mkdocs build -s"
+
+[tasks."doc:dev"]
+description = "Start the documentation server"
+run = "uv run mkdocs serve --watch docs"
+
+[tasks."openapi:dev"]
+description = "Serve the OpenAPI viewer"
+run = "yarn run start"
+dir = "{{env.OPENAPI_VIEWER_DIR}}"
+
+[tasks."openapi:build"]
+description = "Build the OpenAPI viewer"
+run = "yarn run build"
+dir = "{{env.OPENAPI_VIEWER_DIR}}"
+
+[tasks."openapi:check"]
+description = "Validate the OpenAPI viewer"
+run = "yarn run lint"
+dir = "{{env.OPENAPI_VIEWER_DIR}}"

From 445b00b0de2623446e402aa562d656d85ba2515d Mon Sep 17 00:00:00 2001
From: Sebastien Quioc <sebastien.quioc@sekoia.fr>
Date: Thu, 7 May 2026 15:55:53 +0200
Subject: [PATCH 2/2] chore(Mise): update the README.md

---
 README.md | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index 00a64e7c4f..ff8db261fb 100644
--- a/README.md
+++ b/README.md
@@ -10,32 +10,38 @@ Once your pull request is created, a Sekoia.io reviewer will take responsibility
 
 ## Test locally
 
-### Back
+### Set up
+
+This project is managed by [mise-en-place](https://mise.jdx.dev/). Please refer to the [Getting Started](https://mise.jdx.dev/getting-started.html) to install this tool.
 
-This project is managed by `uv` that should be installed first before you can test locally the doc. Please refer to the [“Installing uv”](https://docs.astral.sh/uv/getting-started/installation/) documentation to install this tool.
+After having installed mise-en-place, set up the project:
+
+```shell
+$ mise run install
+```
+
+### Back
 
-The service relies on the [MkDocs](https://www.mkdocs.org/) Python framework helped by [MkDocs-Material](https://squidfunk.github.io/mkdocs-material/). To serve the documentation on the port `8000` of your computer, you should create a Python virtual environment, install the few requirements detailed in `pyproject.toml` and trigger the execution of the MkDocs server:
+The service relies on the [MkDocs](https://www.mkdocs.org/) Python framework helped by [MkDocs-Material](https://squidfunk.github.io/mkdocs-material/). To serve the documentation on the port `8000` of your computer, you should trigger the execution of the MkDocs server:
 
 ```shell
-$ uv run mkdocs serve --strict
+$ mise run doc:serve
 ```
 
 ### Front
 
-The front end is placed in `./lib/openapi-viewer`. You need node and yarn installed.
-To serve the doc locally, you need to load the back end service upper.
+The front end is placed in `./lib/openapi-viewer`. To serve the doc locally, you need to load the back end service upper.
 
-Install yarn
+Start the back:
 
 ```shell
-$ npm install yarn -g
+$ mise run doc:serve
 ```
 
-Launch the front
+In another shell, Launch the front
 
 ```shell
-$ yarn install
-$ yarn start
+$ mise run openapi:dev
 ```
 
 Go to http://127.0.0.1:8080/developer/api/