From ed5124230a9e8bdacad8c9ab7459f0e2785e281a Mon Sep 17 00:00:00 2001
From: n-valverde <64469669+n-valverde@users.noreply.github.com>
Date: Sat, 17 Feb 2024 10:52:22 +0100
Subject: [PATCH] Update service_container.rst

---
 service_container.rst | 23 ++++++++++++++---------
 1 file changed, 14 insertions(+), 9 deletions(-)

diff --git a/service_container.rst b/service_container.rst
index 569f549990b..1afc59189ed 100644
--- a/service_container.rst
+++ b/service_container.rst
@@ -1035,20 +1035,25 @@ to them.
 Linting Service Definitions
 ---------------------------
 
-The ``lint:container`` command checks that the arguments injected into services
-match their type declarations. It's useful to run it before deploying your
-application to production (e.g. in your continuous integration server):
+The ``lint:container`` command performs some additional checks to make sure
+the container is properly configured:
+* ensures the arguments injected into services match their type declarations.
+* ensures the interfaces configured as alias are resolving to a compatible
+service.
+It's useful to run it before deploying your application to production
+(e.g. in your continuous integration server):
 
 .. code-block:: terminal
 
     $ php bin/console lint:container
 
-Checking the types of all service arguments whenever the container is compiled
-can hurt performance. That's why this type checking is implemented in a
-:doc:`compiler pass </service_container/compiler_passes>` called
-``CheckTypeDeclarationsPass`` which is disabled by default and enabled only when
-executing the ``lint:container`` command. If you don't mind the performance
-loss, enable the compiler pass in your application.
+Doing those checks whenever the container is compiled
+can hurt performance. That's why this is implemented in
+:doc:`compiler passes </service_container/compiler_passes>` called
+``CheckTypeDeclarationsPass`` and ``CheckAliasValidityPass`` which are disabled
+by default and enabled only when executing the ``lint:container`` command.
+If you don't mind the performance loss, enable these compiler passes in
+your application.
 
 .. _container-public: