docs: document scroll: false option

docs/02-app/02-api-reference/04-functions/use-router.mdx

@@ -41,8 +41,8 @@ export default function Page() {
 
 ## `useRouter()`
 
-- `router.push(href: string)`: Perform a client-side navigation to the provided route. Adds a new entry into the [browser’s history](https://developer.mozilla.org/en-US/docs/Web/API/History_API) stack.
-- `router.replace(href: string)`: Perform a client-side navigation to the provided route without adding a new entry into the [browser’s history stack](https://developer.mozilla.org/en-US/docs/Web/API/History_API).
+- `router.push(href: string, options?: { scroll: false })`: Perform a client-side navigation to the provided route. Adds a new entry into the [browser’s history](https://developer.mozilla.org/en-US/docs/Web/API/History_API) stack. You can optionally set `scroll: false` when you don't need to scroll back to top again when the URL changes.
+- `router.replace(href: string, options: { scroll: false })`: Perform a client-side navigation to the provided route without adding a new entry into the [browser’s history stack](https://developer.mozilla.org/en-US/docs/Web/API/History_API). You can optionally set `scroll: false` when you don't need to scroll back to top again when the URL changes.
 - `router.refresh()`: Refresh the current route. Making a new request to the server, re-fetching data requests, and re-rendering Server Components. The client will merge the updated React Server Component payload without losing unaffected client-side React (e.g. `useState`) or browser state (e.g. scroll position).
 - `router.prefetch(href: string)`: [Prefetch](/docs/app/building-your-application/routing/linking-and-navigating#prefetching) the provided route for faster client-side transitions.
 - `router.back()`: Navigate back to the previous route in the browser’s history stack using [soft navigation](/docs/app/building-your-application/routing/linking-and-navigating#soft-navigation).

packages/next/src/shared/lib/app-router-context.ts

@@ -70,6 +70,12 @@ export type CacheNode =
 export interface NavigateOptions {
   /** @internal */
   forceOptimisticNavigation?: boolean
+  /**
+   * Set to `false` when you don't need to scroll back to the top
+   * when the URL changes (For instance hash query changes).
+   *
+   * @default true
+   */
   scroll?: boolean
 }