update links language in overview

kmurphypolygon · kmurphypolygon · commit f41704ba2072 · 2024-08-12T08:48:42.000+02:00
diff --git a/docs/cdk/getting-started/local-deployment.md b/docs/cdk/getting-started/local-deployment.md
@@ -1,29 +1,31 @@
-# Get started
+## Deploy CDK locally
 
-This _getting started_ guide walks you through the process of setting up a Layer 2 blockchain using the Polygon CDK on your local machine, running the components in Docker containers.
+This guide walks you through the process of setting up and deploying a layer 2 blockchain on your local machine using the Polygon CDK with [Kurtosis](https://docs.kurtosis.com/). 
 
-## Setting up your environment
+The components run in Docker containers.
 
-To run the Polygon CDK locally, the following prerequisites are required:
+## Prerequisites
 
-Hardware Requirements:
+### Hardware
 
-- A Linux-based Operating System (or [WSL](https://learn.microsoft.com/en-us/windows/wsl/about))
-- Minimum 8GB RAM and 2-core CPU
-- An AMD64 architecture system
+- A Linux-based operating system (or [WSL](https://learn.microsoft.com/en-us/windows/wsl/about)).
+- Minimum 8GB RAM and 2-core CPU.
+- An AMD64 architecture system.
 
-Software Dependencies:
+### Software
 
-- [Docker Engine](https://docs.docker.com/engine/) (version 4.27 or higher)
+- [Docker Engine](https://docs.docker.com/engine/) version 4.27 or higher.
 - [Kurtosis CLI](https://docs.kurtosis.com/install/)
 - [Foundry](https://book.getfoundry.sh/getting-started/installation)
-- Optional: [yq](https://github.com/mikefarah/yq), [jq](https://stedolan.github.io/jq/), and [polycli](https://github.com/maticnetwork/polygon-cli) help submit transactions and interact with the environment.
+- [yq](https://github.com/mikefarah/yq)
+- [jq](https://stedolan.github.io/jq/)
+- [polycli](https://github.com/maticnetwork/polygon-cli) to help submit transactions and interact with the environment.
 
-## Exploring the CDK kurtosis package
+## Set up the Kurtosis environment
 
-The [Polygon CDK Kurtosis package](https://github.com/0xPolygon/kurtosis-cdk/) allows you to easily customize and instantiate all of the components of a CDK chain. It uses the [Kurtosis](https://docs.kurtosis.com/) tool to orchestrate the setup of the chain components in Docker containers, with logic defined in [Starlark](https://github.com/bazelbuild/starlark) (a Python dialect) scripts to define the step-by-step process of setting up the chain.
+The [Polygon CDK Kurtosis package](https://github.com/0xPolygon/kurtosis-cdk/) allows you to easily customize and instantiate all the components of a CDK chain. It uses the [Kurtosis](https://docs.kurtosis.com/) tool to orchestrate the setup of the chain components in Docker containers, with logic defined in [Starlark](https://github.com/bazelbuild/starlark) scripts (a Python dialect) that define the step-by-step process of setting up the chain.
 
-### Cloning the repository
+### Clone the repository
 
 To get started, clone the repository and navigate to the `kurtosis-cdk` directory:
 
@@ -32,7 +34,7 @@ git clone https://github.com/0xPolygon/kurtosis-cdk.git
 cd kurtosis-cdk
 ```
 
-### Checking your environment
+### Check your environment
 
 Ensure Docker is running on your machine, then run the following command to confirm that all prerequisites are installed:
 
@@ -56,7 +58,7 @@ You might as well need the following tools to interact with the environment...
 🎉 You are ready to go!
 ```
 
-### Customizing your chain
+### Customize your chain
 
 To begin understanding the codebase, there are two key files to inspect:
 
@@ -90,7 +92,7 @@ The `params.yml` file defines the parameters of the chain and the deployment pro
 
 You can modify each of these parameters to customize the chain to your specific needs.
 
-## Running the chain locally
+## Run the chain locally
 
 First run the [kurtosis clean](https://docs.kurtosis.com/clean) to remove any existing Kurtosis environments:
 
diff --git a/docs/cdk/overview.md b/docs/cdk/overview.md
@@ -2,26 +2,34 @@
 comments: true
 ---
 
-Polygon Chain Development Kit (CDK) is a modular, open source software toolkit for blockchain developers which supports the installation and configuration of a variety of chain architectures. Polygon CDK empowers developers to launch new L2 chains running Polygon zkEVM technology on Ethereum or, in the future, transition existing Layer 1 (L1) chains into ZK-EVM L2s. 
+Polygon Chain Development Kit (CDK) is a modular, open source, software toolkit for blockchain developers which supports the installation and configuration of a variety of chain architectures. 
+
+Polygon CDK empowers developers to launch new L2 chains running Polygon zkEVM technology on Ethereum or, in the future, transition existing layer 1 (L1) chains into custom ZK-EVM L2s. 
 
 ## CDK features
 
-Polygon CDK provides the components necessary to build a layer 2 blockchain that is secure, scalable, and interoperable with other chains. Below are some of the key features of the CDK:
+Polygon CDK builds layer 2 blockchains that are secure, scalable, and interoperable with other chains. Below are some of the key features of CDK:
+
+- Security: CDK builds high-performance, high-security, scalable L2s that utilize the latest innovations in zero-knowledge technology such as [Plonky3](../innovation-design/plonky.md#plonky-3).
+
+- Scalability: Transaction fees are orders of magnitude lower than Ethereum and processed substantially faster. This enables a fast, cheap, and secure user experience unaffected by any high activity experienced on shared networks.
+
+- Modularity: CDK modular components allow developers to easily customize their L2 environment and build a chain that meets their specific needs.
+
+- Interoperability: Opt-in to the [AggLayer](../cdk/agglayer/overview.md) to bootstrap your chain's ecosystem, enable cross-chain transactions, and gain access to the users and liquidity of other chains.
 
-- Security: Build high-performance, high-security, scalable L2s that utilize the latest innovations in zero-knowledge technology such as [plonky3](https://docs.polygon.technology/learn/plonky/?h=plonky3#plonky-3).
+- Sovereignty: Maintain full control over your chain's revenue, governance, security, economic policies, and more.
 
-- Scalability: Transaction fees are orders of magnitude lower and processed substantially faster compared to Ethereum. Enabling a fast, cheap, and secure user experience unaffected by any extraneous high activity experienced on shared networks.
+## Dive deeper into CDK
 
-- Modularity: As logic is separated into modular components, developers can easily customize all components of the L2 to build a chain that meets their specific needs.
+Polygon CDK gives developers a toolkit for sovereign and modular chain design, without sacrificing future interoperability with other L2 chains. 
 
-- Interoperability: Opt-in to the [AggLayer](https://docs.polygon.technology/cdk/glossary/#agglayer-v1-al1) to bootstrap your chain&rsquo;s ecosystem, enable cross-chain transactions, and access to the users and liquidity of other chains.
+Chains built with Polygon CDK will have access to an ecosystem of (forthcoming) unified liquidity, optimized performance, and seamless asset transfers, all while prioritizing user experience and data security.
 
-- Sovereignty: Maintain full control over your chain&rsquo;s revenue, governance, security, economic policies, and more.
+### Where to now?
 
-## Dive deeper into the CDK
+- [Deploy a local CDK on Kurtosis](./getting-started/local-deployment.md). Follow the guide to deploy a CDK stack on your local machine.
 
-Polygon CDK gives developers a toolkit for sovereign and modular chain design, without sacrificing future interoperability with other L2 chains. Chains built with Polygon CDK can access an ecosystem of (forthcoming) unified liquidity, optimized performance, and seamless asset transfers, all while prioritizing user experience and data security.
+- Check out the [concepts documentation](./concepts/layer2s.md) to understand the CDK at a high level.
 
-- [Concepts](https://docs.polygon.technology/cdk/concepts/layer2s) to understand the CDK at a high level.
-- [Getting Started](https://docs.polygon.technology/cdk/getting-started) to deploy a CDK stack on your local machine.
-- [Architecture](https://docs.polygon.technology/cdk/architecture/cdk-zkevm/) to understand the CDK&rsquo;s components and how they interact with each other.
+- Have a look at the [CDK architecture docs](https://docs.polygon.technology/cdk/architecture/cdk-zkevm/) to understand the CDK's components and how they interact with each other.
