diff --git a/doc/doxygen/src/creating-modules.md b/doc/doxygen/src/creating-modules.md
index 55ad515e2dcbefe74bc6c76e28b2128c5a4568a9..426d279493247a548cda255d33bf7c74448cb5f7 100644
--- a/doc/doxygen/src/creating-modules.md
+++ b/doc/doxygen/src/creating-modules.md
@@ -37,7 +37,8 @@ application's Makefile.
 ### Pitfalls ###
 
 The `MODULE` name should be unique or build breaks as modules overwrite the
-same output file.
+same output file. This might for example lead to `undefined reference to` errors
+in the linker which can be hard to track down.
 
 This problem happened in the past for: