diff --git a/docs/composer/plugin/d4d/index.md b/docs/composer/plugin/d4d/index.md
index bef8b96e5974bef66380b3c21943518ec6fd8705..5f4bfa642392511f706ad5ace412c89f56344df1 100644
--- a/docs/composer/plugin/d4d/index.md
+++ b/docs/composer/plugin/d4d/index.md
@@ -104,6 +104,7 @@ Note that Solr, Node and Varnish are not enabled by default. See the [customizat
 ### PHP Debugging
 
 By default, PHP is configured with XDebug being enabled and you should check the instructions for your IDE on how to get started with a debugging session.
+For the IDE's IntelliJ and PHPStorm from [Jetbrains](https://jetbrains.com) you find an instruction [here](../../../dev_tools/index.md#debugging-drupal-code).
 
 ### Watch the logs
 
diff --git a/docs/dev_tools/index.md b/docs/dev_tools/index.md
index 2d9c35800a61f19e1df910c57b9df199516f4b2d..8223adbd4b2d479f76958e62bf7a3df5912977ec 100644
--- a/docs/dev_tools/index.md
+++ b/docs/dev_tools/index.md
@@ -1,6 +1,63 @@
 ---
-title: Development Tools
+title: Developer Tools
 tags:
 - documentation
 - tools
----
\ No newline at end of file
+---
+# Developer Tools
+
+## IDE
+
+We use the IDE's IntelliJ and PHPStorm from [Jetbrains](https://jetbrains.com), because we are convinced to use best toolset in the 
+market so far.
+
+## Debugging Drupal Code
+
+### Add a PHP Server
+
+First, you have to set up a Drupal environment with the tool [l3d](../docker/l3d/index.md). The tool is 
+based on Docker containers.
+
+Now navigate to File->Settings in your IDE and create a server:
+
+![Screenshot](/files/screenshots/settings_php_new_server.png)
+
+Set the following values:
+
+![Screenshot](/files/screenshots/settings_php_add_server.png)
+
+**Important: Always use Docker as name of your server.** 
+
+Do not forget to add the file mapping to `/var/www/html`.
+
+### Add a new Run/Debug Configuration
+
+![Screenshot](/files/screenshots/configuration_add.png)
+
+First create a new `PHP Web Page` configuration:
+
+![Screenshot](/files/screenshots/configuration_new_webpage.png)
+
+Set the following values:
+
+![Screenshot](/files/screenshots/configuration_done.png)
+
+Select the server you just have created.
+
+**Important: Always use Docker as name of your configuration.** 
+
+### Start Debugging
+
+First, check the debug settings in your IDE. It should look something like this:
+
+![Screenshot](/files/screenshots/settings_php_debug.png)
+
+Now activate the `Phone` icon in your IDE:
+
+![Screenshot](/files/screenshots/start_debug.png)
+
+Now you can set your breakpoints and enjoy debugging Drupal code.
+
+## Execute Drupal tests within your IDE
+
+
diff --git a/docs/files/screenshots/configuration_add.png b/docs/files/screenshots/configuration_add.png
new file mode 100644
index 0000000000000000000000000000000000000000..2c29d7e6e55b37feafd9c3ccf21f67328c30bc08
--- /dev/null
+++ b/docs/files/screenshots/configuration_add.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0a2b35144e5278faeb5ec373002ff93f31b7b14d5603b25435eee342ca84354f
+size 31426
diff --git a/docs/files/screenshots/configuration_done.png b/docs/files/screenshots/configuration_done.png
new file mode 100644
index 0000000000000000000000000000000000000000..ffed74c6318cf37b14efcc19dcb2f2c66a04b84d
--- /dev/null
+++ b/docs/files/screenshots/configuration_done.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7dcc63d1d642bf1b988429393e9ddd48579dc43a80f6b1d3ce2a30377e1bb69b
+size 42556
diff --git a/docs/files/screenshots/configuration_new_webpage.png b/docs/files/screenshots/configuration_new_webpage.png
new file mode 100644
index 0000000000000000000000000000000000000000..3538c3102bc742f9563658bdf91f3bc83d829b97
--- /dev/null
+++ b/docs/files/screenshots/configuration_new_webpage.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:771edc61d04ffe6627ce4aa574b23b261e8b75d1533298470f980233a799c276
+size 52276
diff --git a/docs/files/screenshots/settings_php_add_server.png b/docs/files/screenshots/settings_php_add_server.png
new file mode 100644
index 0000000000000000000000000000000000000000..6772ae8964fcdd18bc9e31f386115591acfa67cd
--- /dev/null
+++ b/docs/files/screenshots/settings_php_add_server.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:401f707c2be7e92386f7e65e6bcef1762f154f079fa72d4c61436e06d0b3c4bf
+size 60007
diff --git a/docs/files/screenshots/settings_php_debug.png b/docs/files/screenshots/settings_php_debug.png
new file mode 100644
index 0000000000000000000000000000000000000000..817bb4aa4fded36d1f55a44c7bc07e7ec25357f1
--- /dev/null
+++ b/docs/files/screenshots/settings_php_debug.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:97beb69aff4f7fe6cd448092d61c97ae2519f0949abc53c6cf386e86d3680be6
+size 124690
diff --git a/docs/files/screenshots/settings_php_new_server.png b/docs/files/screenshots/settings_php_new_server.png
new file mode 100644
index 0000000000000000000000000000000000000000..7317ce7599c4a1bc7e120a9c3d6bd4004922de79
--- /dev/null
+++ b/docs/files/screenshots/settings_php_new_server.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:f07d2e7dcf09d30c393d152b2e669ab50b11090e55a3f3b4bfcac1884951400c
+size 21510
diff --git a/docs/files/screenshots/start_debug.png b/docs/files/screenshots/start_debug.png
new file mode 100644
index 0000000000000000000000000000000000000000..fd56d9982f73ea205ef9d4c26737dabcfd20cff2
--- /dev/null
+++ b/docs/files/screenshots/start_debug.png
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:126dc4605ae672c1eeec825743fe88adff6828acb8bc22e9fabcf0784acd5618
+size 16211