SONAR-17164 Document the side-effect of changing the web context

diff --git a/sonar-application/src/main/assembly/conf/sonar.properties b/sonar-application/src/main/assembly/conf/sonar.properties
index 779485312e17ccb41640b7fcf9f52c84cb5aef1e..c1e24de49cd3830825598c5304eed51b20331786 100644 (file)
--- a/sonar-application/src/main/assembly/conf/sonar.properties
+++ b/sonar-application/src/main/assembly/conf/sonar.properties
@@ -93,6 +93,10 @@
 #sonar.web.host=0.0.0.0
 
 # Web context. When set, it must start with forward slash (for example /sonarqube).
+# Changing this value and restarting the server can have unexpected consequences for logged in users,
+# as they may end up with multiple conflicting browser cookies. If your users experience odd
+# behaviors after you changed this value and restarted the server, ask them to clear their browser's
+# cookies and log in again.
 # The default value is root context (empty value).
 #sonar.web.context=
 # TCP port for incoming HTTP connections. Default value is 9000.