diff --git a/docs/building.md b/docs/building.md
index abdf9ae746..fcc28f6b49 100644
--- a/docs/building.md
+++ b/docs/building.md
@@ -82,3 +82,21 @@ If your changes require updates to the database read [Updating Database Schema](
 
 If your changes require introducing new dependencies or updating dependency versions please discuss this first on the
 dev mailing list. We do not accept new dependencies to be added lightly, so try to use what is available.
+
+### Building project from the IDE
+
+Some parts of the project rely on generated code using Maven plugins. These steps might be skipped when building using
+IDE resulting in compilation errors. To work around this make sure to build the project first using Maven. After the
+initial build with Maven you should be able to build the project using the IDE as it will use the classes previously
+generated by Maven plugins. Make sure you don't rebuild the whole project using the IDE as it would delete the generated
+classes. E.g. in IntelliJ IDEA use `Build → Build Project` instead of `Build → Rebuild Project`.
+
+---
+**NOTE**
+
+If you are building the Operator from your IDE, make sure to build the project with the `operator` profile enabled in Maven
+as it's excluded by default:
+
+    mvn clean install -Poperator -DskipTests
+
+---
\ No newline at end of file