Document merge argument for navigate and popTo

Author: satya164

versioned_docs/version-7.x/native-stack-navigator.md

@@ -1016,6 +1016,7 @@ Navigates back to a previous screen in the stack by popping screens after it. Th
 
 - `name` - _string_ - Name of the route to navigate to.
 - `params` - _object_ - Screen params to pass to the destination route.
+- `merge` - _boolean_ - Whether params should be merged with the existing route params, or replace them (when navigating to an existing screen). Defaults to `false`.
 
 If a matching screen is not found in the stack, this will pop the current screen and add a new screen with the specified name and params.
 

versioned_docs/version-7.x/navigation-actions.md

@@ -28,6 +28,7 @@ The `navigate` action allows to navigate to a specific route. It takes the follo
 
 - `name` - _string_ - A destination name of the screen in the current or a parent navigator.
 - `params` - _object_ - Params to use for the destination route.
+- `merge` - _boolean_ - Whether params should be merged with the existing route params, or replace them (when navigating to an existing screen). Defaults to `false`.
 
 <Tabs groupId="config" queryString="config">
 <TabItem value="static" label="Static" default>
@@ -283,13 +284,20 @@ In a stack navigator ([stack](stack-navigator.md) or [native stack](native-stack
 - If you're on a different screen, it will push the new screen onto the stack.
 - If the [`getId`](screen.md#id) prop is specified, and another screen in the stack has the same ID, it will navigate to that screen and update its params instead.
 
+<details>
+<summary>Advanced usage</summary>
+
 The `navigate` action can also accepts an object as the argument with the following properties:
 
 - `name` - _string_ - A destination name of the screen in the current or a parent navigator
 - `params` - _object_ - Params to use for the destination route.
-- `merge` - _boolean_ - Whether we should merge the params of the current route with the provided `params`. Defaults to `false`.
+- `merge` - _boolean_ - Whether params should be merged with the existing route params, or replace them (when navigating to an existing screen). Defaults to `false`.
 - `path` - _string_ - The path (from deep link or universal link) to associate with the screen.
 
+This is primarily used internally to associate a path with a screen when it's from a URL.
+
+</details>
+
 ### reset
 
 The `reset` action allows to reset the [navigation state](navigation-state.md) to the given state. It takes the following arguments:

versioned_docs/version-7.x/navigation-object.md

@@ -74,8 +74,9 @@ The `navigate` method lets us navigate to another screen in your app. It takes t
 
 `navigation.navigate(name, params)`
 
-- `name` - A destination name of the route that has been defined somewhere
-- `params` - Params to pass to the destination route.
+- `name` - _string_ - A destination name of the screen in the current or a parent navigator.
+- `params` - _object_ - Params to use for the destination route.
+- `merge` - _boolean_ - Whether params should be merged with the existing route params, or replace them (when navigating to an existing screen). Defaults to `false`.
 
 <Tabs groupId="config" queryString="config">
 <TabItem value="static" label="Static" default>
@@ -297,8 +298,8 @@ It takes the following arguments:
 
 `navigation.navigateDeprecated(name, params)`
 
-- `name` - A destination name of the route that has been defined somewhere
-- `params` - Params to pass to the destination route.
+- `name` - _string_ - A destination name of the screen in the current or a parent navigator.
+- `params` - _object_ - Params to use for the destination route.
 
 In a stack navigator ([stack](stack-navigator.md) or [native stack](native-stack-navigator.md)), calling `navigate` with a screen name will have the following behavior:
 

versioned_docs/version-7.x/stack-actions.md

@@ -534,6 +534,7 @@ The method accepts the following arguments:
 
 - `name` - _string_ - Name of the route to navigate to.
 - `params` - _object_ - Screen params to pass to the destination route.
+- `merge` - _boolean_ - Whether params should be merged with the existing route params, or replace them (when navigating to an existing screen). Defaults to `false`.
 
 ```js
 import { StackActions } from '@react-navigation/native';

versioned_docs/version-7.x/stack-navigator.md

@@ -588,6 +588,10 @@ Navigates back to a previous screen in the stack by popping screens after it. Th
 - `name` - _string_ - Name of the route to navigate to.
 - `params` - _object_ - Screen params to pass to the destination route.
 
+- `name` - _string_ - Name of the route to navigate to.
+- `params` - _object_ - Screen params to pass to the destination route.
+- `merge` - _boolean_ - Whether params should be merged with the existing route params, or replace them (when navigating to an existing screen). Defaults to `false`.
+
 If a matching screen is not found in the stack, this will pop the current screen and add a new screen with the specified name and params.
 
 ```js