diff --git a/docs/configuration.md b/docs/configuration.md
index 4d014d08d6..40042180b0 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -10,9 +10,11 @@ Here is an example `.scalafmt.conf`:
 
 ```scala config
 align.preset = more    // For pretty alignment.
-maxColumn = 100 // For my wide 30" display.
+maxColumn = 1234
 ```
 
+> 🚧 Before using specific configuration make sure that your project agrees on the standards. Settings such as `maxColumn` could be a source of issues if different tools such as an IDE uses a different default value.
+
 ## Most popular
 
 ### `maxColumn`