diff --git a/docs/contracts/v4/concepts/erc6909.mdx b/docs/contracts/v4/concepts/erc6909.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/concepts/flash-accounting.mdx b/docs/contracts/v4/concepts/flash-accounting.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/concepts/hooks.mdx b/docs/contracts/v4/concepts/hooks.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/concepts/subscribers.mdx b/docs/contracts/v4/concepts/subscribers.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/concepts/v4-vs-v3.mdx b/docs/contracts/v4/concepts/v4-vs-v3.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/deployments.mdx b/docs/contracts/v4/deployments.mdx
new file mode 100644
index 000000000..4139cb0c2
--- /dev/null
+++ b/docs/contracts/v4/deployments.mdx
@@ -0,0 +1,5 @@
+---
+id: deployments
+title: Deployments
+sidebar_position: 1.1
+---
\ No newline at end of file
diff --git a/docs/contracts/v4/concepts/01-intro-to-v4.mdx b/docs/contracts/v4/deprecated/concepts/01-intro-to-v4.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/01-intro-to-v4.mdx
rename to docs/contracts/v4/deprecated/concepts/01-intro-to-v4.mdx
diff --git a/docs/contracts/v4/concepts/02-1-overview.mdx b/docs/contracts/v4/deprecated/concepts/02-1-overview.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/02-1-overview.mdx
rename to docs/contracts/v4/deprecated/concepts/02-1-overview.mdx
diff --git a/docs/contracts/v4/concepts/02-2-pool-manager-and-initialization.mdx b/docs/contracts/v4/deprecated/concepts/02-2-pool-manager-and-initialization.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/02-2-pool-manager-and-initialization.mdx
rename to docs/contracts/v4/deprecated/concepts/02-2-pool-manager-and-initialization.mdx
diff --git a/docs/contracts/v4/concepts/03-managing-position.mdx b/docs/contracts/v4/deprecated/concepts/03-managing-position.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/03-managing-position.mdx
rename to docs/contracts/v4/deprecated/concepts/03-managing-position.mdx
diff --git a/docs/contracts/v4/concepts/04-swap-tokens.mdx b/docs/contracts/v4/deprecated/concepts/04-swap-tokens.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/04-swap-tokens.mdx
rename to docs/contracts/v4/deprecated/concepts/04-swap-tokens.mdx
diff --git a/docs/contracts/v4/concepts/05-lock-mechanism.mdx b/docs/contracts/v4/deprecated/concepts/05-lock-mechanism.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/05-lock-mechanism.mdx
rename to docs/contracts/v4/deprecated/concepts/05-lock-mechanism.mdx
diff --git a/docs/contracts/v4/concepts/07-deployment.mdx b/docs/contracts/v4/deprecated/concepts/07-deployment.mdx
similarity index 100%
rename from docs/contracts/v4/concepts/07-deployment.mdx
rename to docs/contracts/v4/deprecated/concepts/07-deployment.mdx
diff --git a/docs/contracts/v4/concepts/_category_.json b/docs/contracts/v4/deprecated/concepts/_category_.json
similarity index 100%
rename from docs/contracts/v4/concepts/_category_.json
rename to docs/contracts/v4/deprecated/concepts/_category_.json
diff --git a/docs/contracts/v4/concepts/images/01_Pool_Initialization/HighLevelArchitecture.png b/docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/HighLevelArchitecture.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/01_Pool_Initialization/HighLevelArchitecture.png
rename to docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/HighLevelArchitecture.png
diff --git a/docs/contracts/v4/concepts/images/01_Pool_Initialization/v3_detailed_architecture.png b/docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v3_detailed_architecture.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/01_Pool_Initialization/v3_detailed_architecture.png
rename to docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v3_detailed_architecture.png
diff --git a/docs/contracts/v4/concepts/images/01_Pool_Initialization/v3_high_level_architecture.png b/docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v3_high_level_architecture.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/01_Pool_Initialization/v3_high_level_architecture.png
rename to docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v3_high_level_architecture.png
diff --git a/docs/contracts/v4/concepts/images/01_Pool_Initialization/v4_detailed_architecture.png b/docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v4_detailed_architecture.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/01_Pool_Initialization/v4_detailed_architecture.png
rename to docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v4_detailed_architecture.png
diff --git a/docs/contracts/v4/concepts/images/01_Pool_Initialization/v4_high_level_architecture.png b/docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v4_high_level_architecture.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/01_Pool_Initialization/v4_high_level_architecture.png
rename to docs/contracts/v4/deprecated/concepts/images/01_Pool_Initialization/v4_high_level_architecture.png
diff --git a/docs/contracts/v4/concepts/images/02_Managing_Position/PriceAndTicks.png b/docs/contracts/v4/deprecated/concepts/images/02_Managing_Position/PriceAndTicks.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/02_Managing_Position/PriceAndTicks.png
rename to docs/contracts/v4/deprecated/concepts/images/02_Managing_Position/PriceAndTicks.png
diff --git a/docs/contracts/v4/concepts/images/02_Managing_Position/SqrtPriceX96.png b/docs/contracts/v4/deprecated/concepts/images/02_Managing_Position/SqrtPriceX96.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/02_Managing_Position/SqrtPriceX96.png
rename to docs/contracts/v4/deprecated/concepts/images/02_Managing_Position/SqrtPriceX96.png
diff --git a/docs/contracts/v4/concepts/images/02_Managing_Position/sqrtPriceX96_to_tick.png b/docs/contracts/v4/deprecated/concepts/images/02_Managing_Position/sqrtPriceX96_to_tick.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/02_Managing_Position/sqrtPriceX96_to_tick.png
rename to docs/contracts/v4/deprecated/concepts/images/02_Managing_Position/sqrtPriceX96_to_tick.png
diff --git a/docs/contracts/v4/concepts/images/03_fee_calculation/FeeCalculation.png b/docs/contracts/v4/deprecated/concepts/images/03_fee_calculation/FeeCalculation.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/03_fee_calculation/FeeCalculation.png
rename to docs/contracts/v4/deprecated/concepts/images/03_fee_calculation/FeeCalculation.png
diff --git a/docs/contracts/v4/concepts/images/05_locking_mechanism/LockingMechanism_excali.png b/docs/contracts/v4/deprecated/concepts/images/05_locking_mechanism/LockingMechanism_excali.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/05_locking_mechanism/LockingMechanism_excali.png
rename to docs/contracts/v4/deprecated/concepts/images/05_locking_mechanism/LockingMechanism_excali.png
diff --git a/docs/contracts/v4/concepts/images/05_locking_mechanism/locking_mechanism.png b/docs/contracts/v4/deprecated/concepts/images/05_locking_mechanism/locking_mechanism.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/05_locking_mechanism/locking_mechanism.png
rename to docs/contracts/v4/deprecated/concepts/images/05_locking_mechanism/locking_mechanism.png
diff --git a/docs/contracts/v4/concepts/images/Liquidity1.png b/docs/contracts/v4/deprecated/concepts/images/Liquidity1.png
similarity index 100%
rename from docs/contracts/v4/concepts/images/Liquidity1.png
rename to docs/contracts/v4/deprecated/concepts/images/Liquidity1.png
diff --git a/docs/contracts/v4/first-hook/01-building-you-hook.mdx b/docs/contracts/v4/deprecated/first-hook/01-building-you-hook.mdx
similarity index 100%
rename from docs/contracts/v4/first-hook/01-building-you-hook.mdx
rename to docs/contracts/v4/deprecated/first-hook/01-building-you-hook.mdx
diff --git a/docs/contracts/v4/first-hook/02-hook-testing.mdx b/docs/contracts/v4/deprecated/first-hook/02-hook-testing.mdx
similarity index 100%
rename from docs/contracts/v4/first-hook/02-hook-testing.mdx
rename to docs/contracts/v4/deprecated/first-hook/02-hook-testing.mdx
diff --git a/docs/contracts/v4/first-hook/03-hook-deployment.mdx b/docs/contracts/v4/deprecated/first-hook/03-hook-deployment.mdx
similarity index 100%
rename from docs/contracts/v4/first-hook/03-hook-deployment.mdx
rename to docs/contracts/v4/deprecated/first-hook/03-hook-deployment.mdx
diff --git a/docs/contracts/v4/first-hook/_category_.json b/docs/contracts/v4/deprecated/first-hook/_category_.json
similarity index 100%
rename from docs/contracts/v4/first-hook/_category_.json
rename to docs/contracts/v4/deprecated/first-hook/_category_.json
diff --git a/docs/contracts/v4/guides/create-pool.mdx b/docs/contracts/v4/guides/create-pool.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/hooks/setup.mdx b/docs/contracts/v4/guides/hooks/setup.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/manage-liquidity/add-liquidity.mdx b/docs/contracts/v4/guides/manage-liquidity/add-liquidity.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/manage-liquidity/batch-liquidity.mdx b/docs/contracts/v4/guides/manage-liquidity/batch-liquidity.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/manage-liquidity/burn-liquidity.mdx b/docs/contracts/v4/guides/manage-liquidity/burn-liquidity.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/manage-liquidity/collect.mdx b/docs/contracts/v4/guides/manage-liquidity/collect.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/manage-liquidity/decrease-liquidity.mdx b/docs/contracts/v4/guides/manage-liquidity/decrease-liquidity.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/manage-liquidity/mint-liquidity.mdx b/docs/contracts/v4/guides/manage-liquidity/mint-liquidity.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/read-pool-state.mdx b/docs/contracts/v4/guides/read-pool-state.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/subscriber.mdx b/docs/contracts/v4/guides/subscriber.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/swap.mdx b/docs/contracts/v4/guides/swap.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/guides/testing.mdx b/docs/contracts/v4/guides/testing.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/reference/core/overview.mdx b/docs/contracts/v4/reference/core/overview.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/reference/core/poolmanager.mdx b/docs/contracts/v4/reference/core/poolmanager.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/reference/periphery/overview.mdx b/docs/contracts/v4/reference/periphery/overview.mdx
new file mode 100644
index 000000000..e69de29bb
diff --git a/docs/contracts/v4/reference/periphery/positionmanager.mdx b/docs/contracts/v4/reference/periphery/positionmanager.mdx
new file mode 100644
index 000000000..e69de29bb