diff --git a/src/Codeception/Module/Symfony/BrowserAssertionsTrait.php b/src/Codeception/Module/Symfony/BrowserAssertionsTrait.php
index 7b417e62..b2a79180 100644
--- a/src/Codeception/Module/Symfony/BrowserAssertionsTrait.php
+++ b/src/Codeception/Module/Symfony/BrowserAssertionsTrait.php
@@ -83,8 +83,8 @@ public function seePageRedirectsTo(string $page, string $redirectsTo): void
     /**
      * Submit a form specifying the form name only once.
      *
-     * Use this function instead of $I->submitForm() to avoid repeating the form name in the field selectors.
-     * If you customized the names of the field selectors use $I->submitForm() for full control.
+     * Use this function instead of [`$I->submitForm()`](#submitForm) to avoid repeating the form name in the field selectors.
+     * If you customized the names of the field selectors use `$I->submitForm()` for full control.
      *
      * ```php
      * <?php
@@ -94,7 +94,7 @@ public function seePageRedirectsTo(string $page, string $redirectsTo): void
      * ]);
      * ```
      *
-     * @param string $name
+     * @param string $name The `name` attribute of the `<form>` (you cannot use an array as selector here)
      * @param string[] $fields
      */
     public function submitSymfonyForm(string $name, array $fields): void