From 8dd6c422ea443ae86b66b03b329f9ca186bb02d2 Mon Sep 17 00:00:00 2001
From: Manuel de Brito Fontes <aledbf@gmail.com>
Date: Thu, 13 Sep 2018 10:24:18 -0300
Subject: [PATCH] Add note about default namespace and merge behavior

---
 docs/deploy/index.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/deploy/index.md b/docs/deploy/index.md
index 8306d3941..e39726145 100644
--- a/docs/deploy/index.md
+++ b/docs/deploy/index.md
@@ -25,6 +25,13 @@ The following resources are required for a generic deployment.
 kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/master/deploy/mandatory.yaml
 ```
 
+!!! attention
+    The default configuration watches Ingress object from all the namespaces.
+    To change this behavior use the flag `--watch-namespace` to limit the scope to a particular namespace.
+
+!!! warning
+    If multiple Ingresses define different paths for the same host, the ingress controller will merge the definitions.
+
 ### Provider Specific Steps
 
 There are cloud provider specific yaml files.