diff --git a/docs/src/api/params.md b/docs/src/api/params.md
index 27a3eb63e4..91fe6fc882 100644
--- a/docs/src/api/params.md
+++ b/docs/src/api/params.md
@@ -56,11 +56,13 @@ A selector to search for an element. If there are multiple elements satisfying t
 
 ## input-source
 - `source` <[string]>
+
 A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See
 [working with selectors](../selectors.md) for more details.
 
 ## input-target
 - `target` <[string]>
+
 A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See
 [working with selectors](../selectors.md) for more details.
 
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index df38bd8c3e..d66f9e823b 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -2140,8 +2140,8 @@ export interface Page {
   }): Promise<void>;
 
   /**
-   * @param source
-   * @param target
+   * @param source A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param target A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
    * @param options
    */
   dragAndDrop(source: string, target: string, options?: {
@@ -5185,8 +5185,8 @@ export interface Frame {
   }): Promise<void>;
 
   /**
-   * @param source
-   * @param target
+   * @param source A selector to search for an element to drag. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
+   * @param target A selector to search for an element to drop onto. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](https://playwright.dev/docs/selectors) for more details.
    * @param options
    */
   dragAndDrop(source: string, target: string, options?: {