diff --git a/eclipse/.gitignore b/eclipse/.gitignore
index 65145a2..8bcc7e1 100644
--- a/eclipse/.gitignore
+++ b/eclipse/.gitignore
@@ -1,4 +1,11 @@
-# Eclipse output
+# NOTE: we don't include IDE-specific files (e.g. Eclipse .settings/) on-purpose.
+# Those patterns should go in a global gitignore or repository-specific excludes.
+# See http://www.gwtproject.org/makinggwtbetter.html#global_gitignore
+# The Eclipse projects in this directory (.project and .classpath) serve as IDE
+# project descriptions that can be imported into other IDEs than Eclipe (e.g.
+# IntelliJ IDEA).
+
+# output path configured in .classpath
 bin/
 
 # Generated by GWT tests