diff --git a/src/Codeception/Module/Doctrine2.php b/src/Codeception/Module/Doctrine2.php
index 669b58f..e46a0b3 100644
--- a/src/Codeception/Module/Doctrine2.php
+++ b/src/Codeception/Module/Doctrine2.php
@@ -881,8 +881,9 @@ protected function proceedSeeInRepository(string $entity, array $params = []): a
 
     /**
      * Selects field value from repository.
-     * It builds query based on array of parameters.
+     * It builds a query based on an array of parameters.
      * You can use entity associations to build complex queries.
+     * For Symfony users, it's recommended to [use the entity's repository instead](#Grabbing-Entities-with-Symfony)
      *
      * Example:
      *
@@ -909,8 +910,9 @@ public function grabFromRepository(string $entity, string $field, array $params
 
     /**
      * Selects entities from repository.
-     * It builds query based on array of parameters.
+     * It builds a query based on an array of parameters.
      * You can use entity associations to build complex queries.
+     * For Symfony users, it's recommended to [use the entity's repository instead](#Grabbing-Entities-with-Symfony)
      *
      * Example:
      *
@@ -938,8 +940,9 @@ public function grabEntitiesFromRepository(string $entity, array $params = []):
 
     /**
      * Selects a single entity from repository.
-     * It builds query based on array of parameters.
+     * It builds a query based on an array of parameters.
      * You can use entity associations to build complex queries.
+     * For Symfony users, it's recommended to [use the entity's repository instead](#Grabbing-Entities-with-Symfony)
      *
      * Example:
      *