From 129d9d3643e44f9ca14f036beceecdd7cc738b38 Mon Sep 17 00:00:00 2001
From: Yury Semikhatsky <yurys@chromium.org>
Date: Mon, 31 Jan 2022 11:44:10 -0800
Subject: [PATCH] docs(tracing): clarify capture semantics (#11756)

---
 docs/src/api/class-tracing.md             | 4 +++-
 packages/playwright-core/types/types.d.ts | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/src/api/class-tracing.md b/docs/src/api/class-tracing.md
index 64e4d83dfe..27c1ede630 100644
--- a/docs/src/api/class-tracing.md
+++ b/docs/src/api/class-tracing.md
@@ -125,7 +125,9 @@ a timeline preview.
 ### option: Tracing.start.snapshots
 - `snapshots` <[boolean]>
 
-Whether to capture DOM snapshot on every action.
+If this option is true tracing will
+* capture DOM snapshot on every action
+* record network activity
 
 ### option: Tracing.start.sources
 * langs: js, csharp, python
diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 4bf7fe9ba4..c14846d985 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -14708,7 +14708,9 @@ export interface Tracing {
     screenshots?: boolean;
 
     /**
-     * Whether to capture DOM snapshot on every action.
+     * If this option is true tracing will
+     * - capture DOM snapshot on every action
+     * - record network activity
      */
     snapshots?: boolean;