diff --git a/README.md b/README.md
index ad94a1d..28e9f08 100644
--- a/README.md
+++ b/README.md
@@ -23,6 +23,24 @@ bin/console plugin:refresh
 bin/console plugin:install --activate {{pluginName}}
 ```
 
+## Developer experience
+
+The repository contains a `Makefile` which provides you with the following actions to provide you convience actions to work with it:
+
+```bash
+activate                       Installs and activate plugin
+administration-fix             Run eslint on the administration files
+administration-lint            Run eslint on the administration files
+ecs-dry                        Run easy coding style in dry mode
+ecs-fix                        Run easy coding style in fix mode
+eslint-fix                     Synonym to 'administration-fix'
+eslint                         Synonym to 'administration-lint'
+storefront-fix-styles          Fixes the stylesheets using Stylelint
+storefront-fix                 Run eslint on the storefront files
+storefront-lint-styles         Lints the stylesheets using Stylelint
+storefront-lint                Run eslint on the storefront files
+```
+
 ## Code quality tools set up & configuration
 
 In this project we're using Prettier as the main formatter for the source code and extended it with the following