Apply suggestions from code review

Co-authored-by: Dawn Kelly <[email protected]>

Author: nhussein11

develop/smart-contracts/dev-environments/foundry.md

@@ -10,9 +10,9 @@ description: Learn to install, configure, and use foundry-polkadot for smart con
 
 ## Overview
 
-Foundry is a fast, modular, and extensible toolkit for Ethereum application development, written in Rust. It provides a suite of command-line tools, such as `forge` for compiling, testing, and deploying smart contracts, and `cast` for interacting with blockchains. 
+Foundry is a fast, modular, and extensible toolkit for Ethereum application development written in Rust. It provides a suite of command-line tools, including `forge` for compiling, testing, and deploying smart contracts and `cast` for interacting with blockchains.
 
-[`foundry-polkadot`](https://github.com/paritytech/foundry-polkadot/){target=\_blank} is an adaptation specifically engineered for the Polkadot Hub, it's tailored for developers already familiar with Foundry who are seeking to leverage its capabilities within the Polkadot ecosystem. Additionally, this guide offers detailed information on the `forge` and `cast` commands supported within `foundry-polkadot`, complete with simple, runnable examples for quick reference.
+[`foundry-polkadot`](https://github.com/paritytech/foundry-polkadot/){target=\_blank} is an adaptation explicitly engineered for the Polkadot Hub, tailored for developers already familiar with Foundry who seek to leverage its capabilities within the Polkadot ecosystem. Additionally, this guide offers detailed information on the `forge` and `cast` commands supported within `foundry-polkadot`, complete with simple, runnable examples for quick reference.
 
 ## Installation
 
@@ -44,7 +44,7 @@ A core divergence lies in the underlying Solidity compiler.
         forge build --resolc
         ```
 
-        This instructs Forge to use `resolc` instead of `solc`, generating bytecode compatible with PolkaVM.
+        This command instructs Forge to use `resolc` instead of `solc`, generating bytecode compatible with PolkaVM.
 
     - **Configuration File**: Alternatively, you can configure `resolc` usage in the `foundry.toml` file by adding:
 
@@ -67,7 +67,7 @@ Not all functionalities from the original Foundry are present or behave identica
 - **Currently Unsupported**:
     - Compilation of Yul code is not yet supported.
     - Support for factory contracts deployment is a known issue that is currently unresolved.
-- **Broader Feature Limitations**: Integration with `Anvil` and `Chisel` (Foundry's local blockchain and EVM toolkit, respectively) is not available. This directly impacts the support for several key commands, including `forge test` for running tests, `forge snapshot` for creating blockchain state snapshots, and `forge script` for complex deployment and interaction scripts.
+- **Broader Feature Limitations**: Integration with `Anvil` and `Chisel` (Foundry's local blockchain and EVM toolkit, respectively) is not available. This limitation directly impacts the support for several key commands, including `forge test` for running tests, `forge snapshot` for creating blockchain state snapshots, and `forge script` for complex deployment and interaction scripts.
 - **Modified Feature**: The most notable modification is in the **compilation output**. When ``resolc`` is employed, the resulting bytecode will fundamentally differ from that generated by ``solc``, reflecting PolkaVM's distinct architectural requirements.
 
 ## Set up a Project
@@ -79,7 +79,7 @@ forge init my-polkadot-project
 cd my-polkadot-project
 ```
 
-This creates a complete project structure with the following components:
+This command creates a complete project structure with the following components:
 
 - **`src/`** - Contains the Solidity smart contracts (includes a sample `Counter.sol` contract by default)
 - **`lib/`** - Houses external dependencies and libraries (`forge-std` testing library is included)
@@ -253,7 +253,7 @@ This section provides a detailed breakdown of the `forge` and `cast` commands su
     * **Command**: `forge tree`
     * **Description**: Displays the dependency tree of your Solidity contracts.
 
-!!!warning "Not Working Commands"
+!!!warning "Non-working Commands"
 
     Consider that some foundry commands are not yet supported in `foundry-polkadot`:
 
@@ -486,7 +486,7 @@ This section provides a detailed breakdown of the `forge` and `cast` commands su
     * **Command**: `cast wallet address [OPTIONS]`
     * **Description**: Derives and displays the Ethereum address from a private key or mnemonic (if provided).
 
-!!!warning "Not Working Commands"
+!!!warning "Non-working Commands"
 
     Consider that some foundry commands are not yet supported in `foundry-polkadot`: