diff --git a/docs/tools/phpstorm.md b/docs/tools/phpstorm.md
index 8454feacd2aa9708952d4fbf0cccfa3a922503f2..01abb854c0197518a1fb208bc61d610250d14e2a 100644
--- a/docs/tools/phpstorm.md
+++ b/docs/tools/phpstorm.md
@@ -48,6 +48,8 @@ on completion of civibuild. You should also be able to find it by running
 - `CIVICRM_UF`: Use "UnitTests" unless you're running WebTests or End-to-end
 tests.
 
+For step by step instructions and screenshots(!) -> please see: https://civicrm.stackexchange.com/questions/16489/how-do-i-run-php-unit-tests-w-xdebug-from-within-phpstorm-on-mac
+
 ### Adding external libraries
 
 It can be frustrating when writing tests the PHPStorm complains about missing
@@ -64,5 +66,7 @@ After that you just add the directory to your project include paths by
 [phpstorm-include-paths]: https://www.jetbrains.com/help/phpstorm/configuring-include-paths.html
 [phpunit]: https://github.com/sebastianbergmann/phpunit
 
+Alternatively: always use buildkit to generate you CiviCRM development environment; it ships with many tools - including phpunit4
+