diff --git a/packages/playwright-core/types/types.d.ts b/packages/playwright-core/types/types.d.ts
index 97fd5c0044..fa9fb77521 100644
--- a/packages/playwright-core/types/types.d.ts
+++ b/packages/playwright-core/types/types.d.ts
@@ -18542,6 +18542,10 @@ export interface Clock {
   /**
    * Makes `Date.now` and `new Date()` return fixed fake time at all times, keeps all the timers running.
    *
+   * Use this method for simple scenarios where you only need to test with a predefined time. For more advanced
+   * scenarios, use [clock.install([options])](https://playwright.dev/docs/api/class-clock#clock-install) instead. Read
+   * docs on [clock emulation](https://playwright.dev/docs/clock) to learn more.
+   *
    * **Usage**
    *
    * ```js
@@ -18558,9 +18562,6 @@ export interface Clock {
    * Sets system time, but does not trigger any timers. Use this to test how the web page reacts to a time shift, for
    * example switching from summer to winter time, or changing time zones.
    *
-   * Don't use together with [clock.install([options])](https://playwright.dev/docs/api/class-clock#clock-install). Read
-   * docs on [clock emulation](https://playwright.dev/docs/clock) to learn more.
-   *
    * **Usage**
    *
    * ```js