diff --git a/Documentation/Getting-Started/Building-MaxScale-from-Source-Code.md b/Documentation/Getting-Started/Building-MaxScale-from-Source-Code.md
index 0cc962ee9..09cb312ed 100644
--- a/Documentation/Getting-Started/Building-MaxScale-from-Source-Code.md
+++ b/Documentation/Getting-Started/Building-MaxScale-from-Source-Code.md
@@ -108,6 +108,11 @@ sudo make install
 
 Other useful targets for Make are `documentation`, which generates the Doxygen documentation, and `uninstall` which uninstall MariaDB MaxScale binaries after an install.
 
+**Note**: If you configure CMake multiple times, it's possible that you will run
+  into problems when building MaxScale. Most of the time this manifests as a
+  missing _pcre2.h_ header file. When this happens, delete everything in the
+  build directory and run the CMake command again.
+
 # Building MariaDB MaxScale packages
 
 In addition to the packages needed to build MariaDB MaxScale, you will need the