diff --git a/config/README.md b/config/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..db49bcb775f4eb68c478a9070647fad24545c8d5
--- /dev/null
+++ b/config/README.md
@@ -0,0 +1,21 @@
+# Configuration files Documentation
+
+Note that most configuration files (`config/*.*`) committed into
+[gitlab-ce](https://gitlab.com/gitlab-org/gitlab-ce) **would not be used** for
+[omnibus-gitlab](https://gitlab.com/gitlab-org/omnibus-gitlab). Configuration
+files committed into gitlab-ce are only used for development.
+
+## gitlab.yml
+
+You could find most of GitLab configuration here.
+
+## mail_room.yml
+
+It's intended to be an ERB file because `mail_room` would use ERB to evaluate
+it before parsing it as a YAML file. It would try to read values from
+`gitlab.yml` so you should configure it there.
+
+## resque.yml
+
+It's called `resque.yml` for historical reason, and we're not using rescue
+at the moment. It's served as a **Redis configuration file** instead.