update from comments

Author: eltharin

doctrine.rst

@@ -875,26 +875,24 @@ it is mandatory to use ``#[MapEntity]`` attributes and this can become cumbersom
         Document $document,
     ): Response
     {
-        // the database queries in this case would be:
+        // this would result in the following database queries:
         // $document = $documentRepository->findOneBy(['id' => 'the id', 'name' => 'the name']);
         // $category = $categoryRepository->findOneBy(['slug' => 'the slug']);
     }
 
-As an alternative, you can also use Mapped Route Parameters.
-
-When adding route parameters, you can now define the mapping between the route parameter and the controller argument::
+By using mapped route parameters, you can define the mapping between the route parameter and the controller argument::
 
     #[Route('/document/{slug:category}/{id:document}-{name:document}')]
     public function showDocument(Document $document, Category $category): Response
     {
-        // the database queries in this case would be:
+        // this would result in the following database queries:
         // $document = $documentRepository->findOneBy(['id' => 'the id', 'name' => 'the name']);
         // $category = $categoryRepository->findOneBy(['slug' => 'the slug']);
     }
 
 .. versionadded:: 7.1
 
-    The mapped route parameters were introduced in Symfony 7.1.
+    Mapped route parameters were introduced in Symfony 7.1.
 
 But when two properties have the same name, you will catach an error if you try ::
 
@@ -914,7 +912,7 @@ In this case we have to return to MapEntiy::
         Document $document,
     ): Response
     {
-        // the database queries in this case would be:
+        // this would result in the following database queries:
         // $document = $documentRepository->findOneBy(['id' => 'the id', 'slug' => 'the slug document']);
         // $category = $categoryRepository->findOneBy(['slug' => 'the slug category']);
     }
@@ -926,7 +924,7 @@ When adding route parameters, you can now define the mapping between the route p
     #[Route('/document/{slugCategory:category.slug}/{id:document}-{slugDocument:document.slug}')]
     public function showDocument(Document $document, Category $category): Response
     {
-        // the database queries in this case would be:
+        // this would result in the following database queries:
         // $document = $documentRepository->findOneBy(['id' => 'the id', 'slug' => 'the slug document']);
         // $category = $categoryRepository->findOneBy(['slug' => 'the slug category']);
     }