diff --git a/etc/neutron.conf b/etc/neutron.conf
index 2455f2fd75d..31977a8748e 100644
--- a/etc/neutron.conf
+++ b/etc/neutron.conf
@@ -413,6 +413,10 @@ admin_password = %SERVICE_PASSWORD%
 # Replace 127.0.0.1 above with the IP address of the database used by the
 # main neutron server. (Leave it as is if the database runs on this host.)
 # connection = sqlite://
+# NOTE: In deployment the [database] section and its connection attribute may
+# be set in the corresponding core plugin '.ini' file. However, it is suggested
+# to put the [database] section and its connection attribute in this
+# configuration file.
 
 # Database engine for which script will be generated when using offline
 # migration