diff --git a/README.adoc b/README.adoc
index feb0e9a0f0..740f2ed408 100644
--- a/README.adoc
+++ b/README.adoc
@@ -1600,6 +1600,11 @@ added after the original pull request but before a merge.
 
 == How to build it
 
+IMPORTANT: You need to have all the necessary Groovy plugins
+ installed for your IDE to properly resolve the sources. For example in
+ Intellij IDEA having both Eclipse Groovy Compiler Plugin & GMavenPlus Intellij Plugin
+ results in properly imported project.
+
 === Project structure
 
 Here you can find the Spring Cloud Contract folder structure
diff --git a/docs/src/main/asciidoc/building.adoc b/docs/src/main/asciidoc/building.adoc
index 3165106df7..445653ed3e 100644
--- a/docs/src/main/asciidoc/building.adoc
+++ b/docs/src/main/asciidoc/building.adoc
@@ -1,5 +1,10 @@
 == How to build it
 
+IMPORTANT: You need to have all the necessary Groovy plugins
+ installed for your IDE to properly resolve the sources. For example in
+ Intellij IDEA having both Eclipse Groovy Compiler Plugin & GMavenPlus Intellij Plugin
+ results in properly imported project.
+
 === Project structure
 
 Here you can find the Spring Cloud Contract folder structure