diff --git a/CHANGELOG.md b/CHANGELOG.md
index a09d8af94..9ad3e81a1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,17 +4,26 @@
 
 Note: Can be used with `sfdx plugins:install sfdx-hardis@beta` and docker image `hardisgroupcom/sfdx-hardis@beta`
 
-- [hardis:project:deploy:smart](https://sfdx-hardis.cloudity.com/hardis/project/deploy/smart/): Refactor deployment errors parsing: use JSON output instead of text output
-- [hardis:org:test:apex](https://sfdx-hardis.cloudity.com/hardis/org/test/apex/): Display the number of failed tests in messages and notifications
-- [hardis:org:monitor:backup](https://sfdx-hardis.cloudity.com/hardis/org/monitor/backup/): New option **--exclude-namespaces** that can be used with **--full** option
-- Obfuscate some data from text log files
-- Kill some exit handlers in case they are making the app crash after a throw SfError
-- Trigger notifications during the command execution, not after
-- Do not display warning in case no notification has been configured in case we are running locally
-- Fix Individual deployment tips markdown docs by adding quotes to YML properties
-- Fix init sfdx-hardis project commands and docs
-- Display warning message in case package.xml has wrong format
-- Allow to override package-no-overwrite from a branch .sfdx-hardis.yml config file
+- Visual flow management, using MermaidJs
+  - [hardis:doc:project2markdown](https://sfdx-hardis.cloudity.com/hardis/doc/project2markdown/): Add a markdown file for each Flow
+  - [hardis:doc:flow2markdown](https://sfdx-hardis.cloudity.com/hardis/doc/flow2markdown/): Generate the markdown documentation of a single flow (available from VsCode extension)
+  - [hardis:project:generate:flow-git-diff](https://sfdx-hardis.cloudity.com/hardis/project/generate/flow-git-diff/): Generate the visual git diff for a single flow (available from VsCode extension)
+  - [hardis:project:deploy:smart](https://sfdx-hardis.cloudity.com/hardis/project/deploy/smart/): Add visual git diff for flows updated by a Pull Request
+
+- Command updates
+  - [hardis:project:deploy:smart](https://sfdx-hardis.cloudity.com/hardis/project/deploy/smart/): Refactor deployment errors parsing: use JSON output instead of text output
+  - [hardis:org:test:apex](https://sfdx-hardis.cloudity.com/hardis/org/test/apex/): Display the number of failed tests in messages and notifications
+  - [hardis:org:monitor:backup](https://sfdx-hardis.cloudity.com/hardis/org/monitor/backup/): New option **--exclude-namespaces** that can be used with **--full** option
+
+- Core enhancements & fixes
+  - Obfuscate some data from text log files
+  - Kill some exit handlers in case they are making the app crash after a throw SfError
+  - Trigger notifications during the command execution, not after
+  - Do not display warning in case no notification has been configured in case we are running locally
+  - Fix Individual deployment tips markdown docs by adding quotes to YML properties
+  - Fix init sfdx-hardis project commands and docs
+  - Display warning message in case package.xml has wrong format
+  - Allow to override package-no-overwrite from a branch .sfdx-hardis.yml config file
 
 ## [5.10.1] 2024-12-12