diff --git a/service_container.rst b/service_container.rst
index d12f8604bfd..1b648050e7c 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -178,6 +178,9 @@ each time you ask for it.
- '../src/Entity/'
- '../src/Kernel.php'
+ # order is important in this file because service definitions
+ # always *replace* previous ones; add your own service configuration below
+
# ...
.. code-block:: xml
@@ -197,6 +200,9 @@ each time you ask for it.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies: