diff --git a/docs/experimental-features.md b/docs/experimental-features.md
index 712fc13cde2..800de71527e 100644
--- a/docs/experimental-features.md
+++ b/docs/experimental-features.md
@@ -16,7 +16,7 @@ Requires `extensibility` to be enabled. If enabled, users are able to fetch the
 The provider definitions also support aliasing via `bicepconfig.json` similar to [`moduleAliases`](https://learn.microsoft.com/azure/azure-resource-manager/bicep/bicep-config-modules#aliases-for-modules). For example `provider 'br/public:az@1.0.0' as az`.
 
 ### `extendableParamFiles`
-Enables the ability to extend bicepparam files from other bicepparam files.
+Enables the ability to extend bicepparam files from other bicepparam files. For more information, see [Extendable Bicep Params Files](./experimental/extendable-param-files.md).
 
 ### `extensibility`
 Allows Bicep to use a provider model to deploy non-ARM resources. Currently, we support Kubernetes provider ([Bicep extensibility Kubernetes provider](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extensibility-kubernetes-provider)) and Microsoft Graph provider ([Bicep templates for Microsoft Graph](https://aka.ms/graphbicep)).
diff --git a/docs/experimental/extendable-param-files.md b/docs/experimental/extendable-param-files.md
new file mode 100644
index 00000000000..5ff73b5bc01
--- /dev/null
+++ b/docs/experimental/extendable-param-files.md
@@ -0,0 +1,94 @@
+# Using the Extendable Bicep Parameters Feature
+
+## What is it?
+
+Extendable Bicep Parameter Files (enabled with the `extend` keyword) is a feature that allows you to reuse parameters from one `.bicepparam` file in another `.bicepparam` file. This enables better re-use across multiple deployments and helps to keep your code [DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself).
+
+When using extendable bicep parameter files, you will have a main `.bicepparam` file that can be consumed by multiple extended `.bicepparam` files.
+
+## Example Usage
+
+`main.bicep` This is your main bicep file, which will define your parameters for deployment.
+
+```bicep
+param namePrefix string
+param location string
+param tag string
+```
+
+`root.bicepparam` This is your main bicepparam file, which can be reused by multiple extended .bicepparam files and in multiple deployments.
+
+```bicep
+using none
+// Notice that the first line of this .bicepparam file declares `using none` which tells the compiler not to validate this against any particular .bicep file.
+
+param namePrefix = 'Prod'
+param location = 'westus'
+```
+
+`leaf.bicepparam` This is your extended bicepparam file, which will refer to one main.bicep file and one main .bicepparam file. Any parameter value in this file will override all previous values.
+
+```bicep
+using 'main.bicep'
+
+extends 'root.bicepparam'
+
+param namePrefix = 'Dev'
+param tag = 'test'
+```
+
+Resolved Values
+| Param | Value |
+| -- | -- |
+| namePrefix | `'Dev'` |
+| location | `'westus'` |
+| tag | `'test'` |
+
+**Note**: Any parameter values in the **`leaf.bicepparam`** file will override the values of the parameter in **both** the `main.bicep` and `root.bicepparam` files. So in this case, `namePrefix`is defined in both the `root.bicepparam` and `leaf.bicepparam` files, and is given the value `Dev` as defined in the `leaf.bicepparam` file, overriding the original value of `Prod`.
+
+### Nested Parameter Files
+We also support nested parameter files, so that `a.bicepparam` extends `b.bicepparam` extends `c.bicepparam`. In this case, you will use `using none` for file `a.bicepparam` and `b.bicepparam`.
+
+## Limitations
+
+We do not have support for:
+
+* variables: we will not have variable support in the `root.bicepparam` file to be able to read and override values in other files
+  ```bicep
+  var namePrefix = 'share'
+  ```
+* import function: you will not be able to import a parameter from another file
+  ```bicep
+  import {bar} from 'main.bicep'
+  ```
+* Multiple extends statements
+  ```bicep
+  using 'main.bicep'
+
+  extends 'root1.bicepparam'
+  extends 'root2.biepparam'
+  extends 'root3.bicepparam'
+  ```
+* Ability to merge (union) parameters of type object and array
+  ```bicep
+  param loc1 string = [
+  'westus'
+  'westus2'
+  ]
+  
+  param loc2 string = [
+  'eastus'
+  'eastus2'
+  ]
+  
+  union(loc1, loc2)
+  ```
+* user-defined functions and user-defined types
+  ```bicep
+  type namePrefix = 'extend'
+  func outputName(name string) => 'Hi ${name}!'
+  ```
+
+## Raising bugs or feature requests
+
+Please raise bug reports or feature requests under [Bicep Issues](https://github.com/Azure/bicep/issues) as usual.