diff --git a/docs/cdk/getting-started/local-deployment.md b/docs/cdk/getting-started/quickstart.md
similarity index 100%
rename from docs/cdk/getting-started/local-deployment.md
rename to docs/cdk/getting-started/quickstart.md
diff --git a/docs/cdk/index.md b/docs/cdk/index.md
deleted file mode 100644
index 857cd636c..000000000
--- a/docs/cdk/index.md
+++ /dev/null
@@ -1,70 +0,0 @@
----
-hide:
- - toc
----
-
-
-
-
-
-
-
Polygon CDK
-
Polygon Chain Development Kit (CDK) is a modular, open-source blockchain stack for developers launching sovereign L2 chains powered by zero-knowledge (ZK) proofs.
-
-
-
-
-
diff --git a/docs/cdk/overview.md b/docs/cdk/overview.md
index 369f6dd4a..368bd88bb 100644
--- a/docs/cdk/overview.md
+++ b/docs/cdk/overview.md
@@ -10,49 +10,6 @@ Polygon CDK allows developers to build scalable and customizable Layer 2 blockch
---
-### Why Should Developers Care?
+### What Stack Should You Choose?
-- **Low costs and high performance**: Polygon CDK chains offer lower transaction fees and faster finality compared to Ethereum Layer 1 and many Layer 2 solutions.
-- **Seamless cross-chain interoperability**: With Agglayer integration (currently in testnet), Polygon CDK chains can interact securely with other chains and external networks.
-- **Modular and future-ready**: Developers can customize their chain’s architecture to meet specific use cases, ensuring compatibility with emerging technologies.
-- **Ethereum-compatible**: Polygon CDK supports EVM tooling, ensuring a smooth developer experience and easy migration for existing applications.
-
----
-
-### How Does It Work?
-
-Polygon CDK simplifies the process of building Layer 2 blockchains by providing pre-built components of a chain. Here’s how it works at a high level:
-
-#### Execution Layer
-
-- Sequencer Nodes: Handle transaction ordering and provide RPC (Remote Procedure Call) endpoints for interacting with the chain.
-- Prover: Ensures transaction validity and supports zk-Rollup configs by generating cryptographic proofs. Developers can use any prover suited to their needs.
-- Pool Manager: Optimizes resource allocation for chains to efficiently process transactions.
-
-#### Data Availability
-
-- Ethereum DA: Stores transaction data directly on Ethereum for zk-Rollup configs, ensuring security and decentralization.
-- Custom DAC: An off-chain solution for Validium configs, offering scalability and cost-efficiency while maintaining data integrity.
-- Agglayer Pessimistic Proofs: Provides security and enables cross-chain functionality for Sovereign configs without requiring zk-SNARKs or on-chain data storage.
-
-#### Settlement Layer
-
-- Ethereum Bridge Contracts: Used by zk-Rollup configs to finalize transactions on Ethereum.
-- Agglayer Integration: Sovereign configs settle transactions and enable interoperability through Agglayer using cryptographic pessimistic proofs.
-
-#### Sequencer
-
-- Sequence Sender: Ensures proper transaction ordering and maintains data integrity.
-
-#### Interoperability
-
-- Bridge APIs: Enable cross-chain transfers of assets and data, connecting Polygon CDK chains with Ethereum and other Layer 2s.
-- Aggregator: Combines multiple proofs into a single proof for zk-Rollup configs to optimize validation.
-
----
-
-### A Note on Configurations
-
-Polygon CDK supports three main configurations—zk-Rollup, Validium, and Sovereign—which align with the most common Layer 2 use cases. These configurations use a standard set of components optimized for scalability, security, and interoperability.
-
-While most developers rely on these configurations for simplicity, the stack is fully modular and customizable, allowing teams to adjust or replace components to create a Layer 2 chain tailored to their specific requirements.
\ No newline at end of file
+---
\ No newline at end of file
diff --git a/docs/cdk/releases/release-notes.md b/docs/cdk/releases/release-notes.md
deleted file mode 100644
index ceefaf457..000000000
--- a/docs/cdk/releases/release-notes.md
+++ /dev/null
@@ -1,24 +0,0 @@
-_Last updated: December 2024_
-
-Fork ID 12 brings significant updates to the Polygon CDK stack, enhancing performance, scalability, and the developer experience. This release focuses on improvements across the client layer, proving systems, and developer tooling, making it easier to build and operate high-performance Layer 2 chains.
-
----
-
-### Key Updates
-
-#### Erigon Integration
-- Faster syncing for quicker chain setup and operation.
-- Improved transaction throughput and resource efficiency.
-- Full compatibility with Ethereum tools and infrastructure.
-
-#### Proving System Enhancements
-- Increased capacity for handling complex transactions and higher volumes.
-- Faster proof generation for quicker deployment and smoother operations.
-
-#### Developer Tooling Improvements
-- Simplified CLI for easier chain deployment and configuration.
-- Updated documentation with improved guides for developers.
-
-#### Full Execution Proofs
-- Comprehensive validation: Verifies that all state transitions executed by the underlying VM (such as Polygon zkEVM) adhere to the protocol’s specifications.
-- Flexibility across modes: Supports both rollup and validium modes, providing scalability and security tailored to different use cases.
diff --git a/docs/cdk/glossary/index.md b/docs/cdk/resources/cdk-glossary.md
similarity index 100%
rename from docs/cdk/glossary/index.md
rename to docs/cdk/resources/cdk-glossary.md
diff --git a/docs/cdk/getting-started/cdk-erigon/chain-config.md b/docs/cdk/stacks/cdk-erigon/chain-config.md
similarity index 100%
rename from docs/cdk/getting-started/cdk-erigon/chain-config.md
rename to docs/cdk/stacks/cdk-erigon/chain-config.md
diff --git a/docs/cdk/getting-started/cdk-erigon/deploy-cdk-erigon.md b/docs/cdk/stacks/cdk-erigon/deploy-cdk-erigon.md
similarity index 100%
rename from docs/cdk/getting-started/cdk-erigon/deploy-cdk-erigon.md
rename to docs/cdk/stacks/cdk-erigon/deploy-cdk-erigon.md
diff --git a/docs/cdk/getting-started/cdk-erigon/index.md b/docs/cdk/stacks/cdk-erigon/index.md
similarity index 100%
rename from docs/cdk/getting-started/cdk-erigon/index.md
rename to docs/cdk/stacks/cdk-erigon/index.md
diff --git a/docs/cdk/getting-started/cdk-erigon/network-recovery.md b/docs/cdk/stacks/cdk-erigon/network-recovery.md
similarity index 100%
rename from docs/cdk/getting-started/cdk-erigon/network-recovery.md
rename to docs/cdk/stacks/cdk-erigon/network-recovery.md
diff --git a/docs/cdk/getting-started/cdk-erigon/release.md b/docs/cdk/stacks/cdk-erigon/release-notes.md
similarity index 100%
rename from docs/cdk/getting-started/cdk-erigon/release.md
rename to docs/cdk/stacks/cdk-erigon/release-notes.md
diff --git a/docs/cdk/getting-started/cdk-erigon/resources.md b/docs/cdk/stacks/cdk-erigon/resources.md
similarity index 100%
rename from docs/cdk/getting-started/cdk-erigon/resources.md
rename to docs/cdk/stacks/cdk-erigon/resources.md
diff --git a/docs/cdk/architecture/cdk-pp-highlevel-arch.md b/docs/cdk/stacks/cdk-pp-highlevel-arch.md
similarity index 100%
rename from docs/cdk/architecture/cdk-pp-highlevel-arch.md
rename to docs/cdk/stacks/cdk-pp-highlevel-arch.md
diff --git a/docs/cdk/architecture/cdk-validium.md b/docs/cdk/stacks/cdk-validium.md
similarity index 100%
rename from docs/cdk/architecture/cdk-validium.md
rename to docs/cdk/stacks/cdk-validium.md
diff --git a/docs/cdk/architecture/cdk-zkevm.md b/docs/cdk/stacks/cdk-zkevm.md
similarity index 100%
rename from docs/cdk/architecture/cdk-zkevm.md
rename to docs/cdk/stacks/cdk-zkevm.md
diff --git a/docs/cdk/architecture/high-level-views.md b/docs/cdk/stacks/high-level-views.md
similarity index 100%
rename from docs/cdk/architecture/high-level-views.md
rename to docs/cdk/stacks/high-level-views.md
diff --git a/docs/cdk/architecture/staking-the-bridge.md b/docs/cdk/stacks/staking-the-bridge.md
similarity index 100%
rename from docs/cdk/architecture/staking-the-bridge.md
rename to docs/cdk/stacks/staking-the-bridge.md
diff --git a/docs/cdk/architecture/type-1-prover/intro-t1-prover.md b/docs/cdk/stacks/type-1-prover/intro-t1-prover.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/intro-t1-prover.md
rename to docs/cdk/stacks/type-1-prover/intro-t1-prover.md
diff --git a/docs/cdk/architecture/type-1-prover/t1-architecture.md b/docs/cdk/stacks/type-1-prover/t1-architecture.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/t1-architecture.md
rename to docs/cdk/stacks/type-1-prover/t1-architecture.md
diff --git a/docs/cdk/architecture/type-1-prover/t1-cpu-component.md b/docs/cdk/stacks/type-1-prover/t1-cpu-component.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/t1-cpu-component.md
rename to docs/cdk/stacks/type-1-prover/t1-cpu-component.md
diff --git a/docs/cdk/architecture/type-1-prover/t1-ctl-protocol.md b/docs/cdk/stacks/type-1-prover/t1-ctl-protocol.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/t1-ctl-protocol.md
rename to docs/cdk/stacks/type-1-prover/t1-ctl-protocol.md
diff --git a/docs/cdk/architecture/type-1-prover/t1-design-challenge.md b/docs/cdk/stacks/type-1-prover/t1-design-challenge.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/t1-design-challenge.md
rename to docs/cdk/stacks/type-1-prover/t1-design-challenge.md
diff --git a/docs/cdk/architecture/type-1-prover/t1-rangechecks.md b/docs/cdk/stacks/type-1-prover/t1-rangechecks.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/t1-rangechecks.md
rename to docs/cdk/stacks/type-1-prover/t1-rangechecks.md
diff --git a/docs/cdk/architecture/type-1-prover/testing-and-proving-costs.md b/docs/cdk/stacks/type-1-prover/testing-and-proving-costs.md
similarity index 100%
rename from docs/cdk/architecture/type-1-prover/testing-and-proving-costs.md
rename to docs/cdk/stacks/type-1-prover/testing-and-proving-costs.md
diff --git a/mkdocs.yml b/mkdocs.yml
index 2bf2b9e3e..eb20f0743 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,6 +1,6 @@
site_name: Polygon Knowledge Layer
site_author: Polygon Labs
-copyright: Copyright © 2024 Polygon Labs
+copyright: Copyright © 2025 Polygon Labs
repo_name: Polygon Knowledge Layer
repo_url: https://github.com/0xPolygon/polygon-docs
edit_uri: edit/main/docs/
@@ -51,56 +51,28 @@ theme:
nav:
- Home: index.md
- Agglayer: "https://docs.agglayer.dev"
- - CDK:
- - Polygon CDK: cdk/index.md
- - Overview: cdk/overview.md
- - Current Release:
- - Release Notes: cdk/releases/release-notes.md
- - Get Started:
- - Quickstart: cdk/getting-started/local-deployment.md
- - CLI Tool: cdk/getting-started/cli-tool.md
- - CDK Erigon:
- - Overview: cdk/getting-started/cdk-erigon/index.md
- - Release: cdk/getting-started/cdk-erigon/release.md
- - How To:
- - Deploy a Node: cdk/getting-started/cdk-erigon/deploy-cdk-erigon.md
- - Configure Chains Dynamically: cdk/getting-started/cdk-erigon/chain-config.md
- - Recover the Network: cdk/getting-started/cdk-erigon/network-recovery.md
- - Resources: cdk/getting-started/cdk-erigon/resources.md
- - How To:
- - Migration Guides:
- - General Guide: cdk/how-to/migrate/fork.md
- - Fork ID 9 to 12: cdk/how-to/migrate/forkid-9-12.md
- - Fork ID 7 to 9: cdk/how-to/migrate/forkid-7-to-9.md
- - Create A Native Token: cdk/how-to/use-native-token.md
- - Integrate DA Layer: cdk/how-to/integrate-da.md
- - Manage Allowlists with Policies: cdk/how-to/manage-policies.md
- - Quickly Test a Running Stack: cdk/how-to/quick-test-stack.md
- - Connect to CDK Testnets: cdk/how-to/connect-testnet.md
+ - Polygon CDK:
+ - Overview:
+ - What is Polygon CDK?: cdk/overview.md
+ - What is Polygon CDK-opgeth?: cdk/stacks/cdk-opgeth/index.md
+ - What is Polygon CDK-erigon?: cdk/stacks/cdk-erigon/index.md
+ - Why Use CDK?: cdk/overview/why-cdk.md
+ - Overview of Benefits: cdk/overview/benefits.md
+ - What Configuration Should I Choose?: cdk/overview/configuration.md
+ - FAQs: cdk/overview/faqs.md
+ - CDK-opgeth:
+ - Get Started: cdk/opgeth/get-started.md # Tabs: Quickstart, CLI Tool, Deploy a Node, Connect to Testnets
+ - CDK-erigon:
+ - Get Started: cdk/erigon/get-started.md # Tabs: Quickstart, CLI Tool, Deploy a Node, Connect to Testnets
+ - Migration Guide:
+ - Fork ID 9 to 12: cdk/how-to/cdk-erigon/migrate-forkid-9-12.md
- Concepts:
- - Full Execution Proofs (FEP): cdk/concepts/full-execution-proofs.md
- - Pessimistic Proofs (PP): cdk/concepts/pessimistic-proofs.md
- - Layer 2s: cdk/concepts/layer2s.md
- - L2 Architecture Overview: cdk/concepts/architecture.md
- - L2 Transaction Lifecycle: cdk/concepts/transaction-lifecycle.md
- - Rollups vs. Validiums: cdk/concepts/rollup-vs-validium.md
- - ZK vs. Optimistic Rollups: cdk/concepts/zk-vs-optimistic.md
- - Batches, Blocks, Transactions: cdk/concepts/blocks.md
- - Transaction Finality: cdk/concepts/transaction-finality.md
- - Gas Fees: cdk/concepts/gas-fees.md
- - Bridging & Interoperability: cdk/concepts/bridging.md
- - Admin Upgradeability: cdk/concepts/admin-upgradeability.md
- - Architecture:
- - FEP Overview: cdk/architecture/high-level-views.md
- - PP Overview: cdk/architecture/cdk-pp-highlevel-arch.md
- - Rollup Overview: cdk/architecture/cdk-zkevm.md
- - Validium Overview: cdk/architecture/cdk-validium.md
- - Staking the Bridge (STB): cdk/architecture/staking-the-bridge.md
- - Glossary:
+ - Layer 2 Basics: cdk/concepts/layer2-basics.md
+ - Rollups vs. Validiums: cdk/concepts/rollups-validiums.md
+ - Bridging & Interoperability: cdk/concepts/bridging-interoperability.md
+ - Resources:
- Glossary: cdk/glossary/index.md
- - Additional Resources:
- - Third-Party Guides: cdk/resources/third-party-guides.md
- - Polygon CDK Repos: cdk/resources/cdk-repo-reference.md
+ - CDK Repos: cdk/resources/cdk-repo-reference.md
- zkEVM:
- zkEVM: zkEVM/index.md
- Overview: zkEVM/overview.md
@@ -393,8 +365,7 @@ nav:
- EIP-1559: pos/concepts/transactions/eip-1559.md
- EIP-4337: pos/concepts/transactions/eip-4337.md
- Meta transactions: pos/concepts/transactions/meta-transactions.md
- - Miden:
- - Miden: miden/index.md
+ - Miden: "https://0xpolygonmiden.github.io/miden-docs/"
- Developer tools:
- Developer tools: tools/index.md
- Start building:
@@ -695,4 +666,4 @@ extra_javascript:
- https://cdnjs.cloudflare.com/polyfill/v3/polyfill.min.js?version=4.8.0
- https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js
- https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/katex.min.js
- - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js
+ - https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.16.7/contrib/auto-render.min.js
\ No newline at end of file