diff --git a/docs/src/api/class-screenshotassertions.md b/docs/src/api/class-screenshotassertions.md
index 3089adfbdd..0662028502 100644
--- a/docs/src/api/class-screenshotassertions.md
+++ b/docs/src/api/class-screenshotassertions.md
@@ -19,6 +19,14 @@ Ensures that passed value, either a [string] or a [Buffer], matches the expected
 // Basic usage.
 expect(await page.screenshot()).toMatchSnapshot('landing-page.png');
 
+// Basic usage and the file name is derived from the test name.
+expect(await page.screenshot()).toMatchSnapshot();
+
+// Pass options to customize the snapshot comparison and have a generated name.
+expect(await page.screenshot()).toMatchSnapshot({
+  maxDiffPixels: 27, // allow no more than 27 different pixels.
+});
+
 // Configure image matching threshold.
 expect(await page.screenshot()).toMatchSnapshot('landing-page.png', { threshold: 0.3 });
 
@@ -29,10 +37,10 @@ expect(await page.screenshot()).toMatchSnapshot(['landing', 'step3.png']);
 
 Learn more about [visual comparisons](./test-snapshots.md).
 
-### param: ScreenshotAssertions.toMatchSnapshot.name
-- `name` <[string]|[Array]<[string]>>
+### param: ScreenshotAssertions.toMatchSnapshot.nameOrOptions
+- `nameOrOptions` <[string]|[Array]<[string]>|[Object]>
 
-Snapshot name.
+Optional snapshot name. If not passed, the test name and ordinals are used when called multiple times. Also passing the options here is supported.
 
 ### option: ScreenshotAssertions.toMatchSnapshot.maxDiffPixels = %%-assertions-max-diff-pixels-%%
 
diff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.md
index 1d5a2e8e76..3f05b46de7 100644
--- a/docs/src/release-notes-js.md
+++ b/docs/src/release-notes-js.md
@@ -22,7 +22,6 @@ title: "Release notes"
 
   ```js
   expect(await page.screenshot()).toMatchSnapshot({
-    fullPage: true, // take a full page screenshot
     maxDiffPixels: 27, // allow no more than 27 different pixels.
   });
   ```