diff --git a/docker-compose.yml b/docker-compose.yml
index 9007d8a..06ffb57 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,5 +1,10 @@
 version: '2'
 
+# NOTE: There are secrets in plain text in this file!
+# In a real production environment, this info would be
+# managed by the orchestration tooling,
+# eg. docker swarm, kubernetes, etc.
+
 services:
   rails:
     build: