last chunk of formatting

Author: kmurphypolygon

docs/zkEVM/architecture/high-level/smart-contracts/api/lib/DepositContractBase.md

@@ -1,32 +1,36 @@
-This contract will be used as a helper for all the sparse merkle tree related functions
-Based on the implementation of the deposit eth2.0 contract https://github.com/ethereum/consensus-specs/blob/dev/solidity_deposit_contract/deposit_contract.sol
-
+This contract is a helper for all the sparse Merkle tree related functions and is based on the implementation of the deposit eth2.0 contract https://github.com/ethereum/consensus-specs/blob/dev/solidity_deposit_contract/deposit_contract.sol.
 
 ## Functions
-### getRoot
+
+### `getRoot`
+
+Computes and returns the Merkle root.
+
 ```solidity
   function getRoot(
   ) public returns (bytes32)
 ```
-Computes and returns the merkle root
 
+### `_addLeaf`
 
+Adds a new leaf to the merkle tree.
 
-### _addLeaf
 ```solidity
   function _addLeaf(
     bytes32 leaf
   ) internal
 ```
-Add a new leaf to the merkle tree
 
+##### Parameters
 
-##### Parameters:
 | Name | Type | Description                                                          |
 | :--- | :--- | :------------------------------------------------------------------- |
 |`leaf` | bytes32 | Leaf
 
-### verifyMerkleProof
+### `verifyMerkleProof`
+
+Verify Merkle proof.
+
 ```solidity
   function verifyMerkleProof(
     bytes32 leafHash,
@@ -35,29 +39,30 @@ Add a new leaf to the merkle tree
     bytes32 root
   ) public returns (bool)
 ```
-Verify merkle proof
 
+##### Parameters
 
-##### Parameters:
 | Name | Type | Description                                                          |
 | :--- | :--- | :------------------------------------------------------------------- |
 |`leafHash` | bytes32 | Leaf hash
 |`smtProof` | bytes32[32] | Smt proof
 |`index` | uint32 | Index of the leaf
 |`root` | bytes32 | Merkle root
 
-### calculateRoot
+### `calculateRoot`
+
+Calculate root from Merkle proof.
+
 ```solidity
   function calculateRoot(
     bytes32 leafHash,
     bytes32[32] smtProof,
     uint32 index
   ) public returns (bytes32)
 ```
-Calculate root from merkle proof
 
+##### Parameters
 
-##### Parameters:
 | Name | Type | Description                                                          |
 | :--- | :--- | :------------------------------------------------------------------- |
 |`leafHash` | bytes32 | Leaf hash

docs/zkEVM/architecture/high-level/smart-contracts/api/lib/DepositContractLib.md

@@ -1,32 +1,36 @@
-This contract will be used as a helper for all the sparse merkle tree related functions
-Based on the implementation of the deposit eth2.0 contract https://github.com/ethereum/consensus-specs/blob/dev/solidity_deposit_contract/deposit_contract.sol
-
+This contract is a helper for all the sparse Merkle tree related functions and is based on the implementation of the deposit eth2.0 contract https://github.com/ethereum/consensus-specs/blob/dev/solidity_deposit_contract/deposit_contract.sol.
 
 ## Functions
-### getRoot
+
+### `getRoot`
+
+Computes and returns the Merkle root.
+
 ```solidity
   function getRoot(
   ) public returns (bytes32)
 ```
-Computes and returns the merkle root
 
+### `_addLeaf`
 
+Adds a new leaf to the merkle tree
 
-### _addLeaf
 ```solidity
   function _addLeaf(
     bytes32 leaf
   ) internal
 ```
-Add a new leaf to the merkle tree
 
+##### Parameters
 
-##### Parameters:
 | Name | Type | Description                                                          |
 | :--- | :--- | :------------------------------------------------------------------- |
 |`leaf` | bytes32 | Leaf
 
-### verifyMerkleProof
+### `verifyMerkleProof`
+
+Verify Merkle proof.
+
 ```solidity
   function verifyMerkleProof(
     bytes32 leaf,
@@ -35,10 +39,9 @@ Add a new leaf to the merkle tree
     bytes32 root
   ) public returns (bool)
 ```
-Verify merkle proof
 
+##### Parameters
 
-##### Parameters:
 | Name | Type | Description                                                          |
 | :--- | :--- | :------------------------------------------------------------------- |
 |`leaf` | bytes32 | Leaf

docs/zkEVM/architecture/high-level/smart-contracts/api/lib/DepositContractV2.md

@@ -1,9 +1,11 @@
-This contract will be used in the PolygonZkEVMBridge contract, it inherits the DepositContractBase and adds the logic
-to calculate the leaf of the tree
-
+This contract is used by the `PolygonZkEVMBridge` contract. It inherits the `DepositContractBase` and adds the logic to calculate the leaf of the exit tree.
 
 ## Functions
-### getLeafValue
+
+### `getLeafValue`
+
+Given the leaf data returns the leaf value.
+
 ```solidity
   function getLeafValue(
     uint8 leafType,
@@ -15,10 +17,9 @@ to calculate the leaf of the tree
     bytes32 metadataHash
   ) public returns (bytes32)
 ```
-Given the leaf data returns the leaf value
 
+##### Parameters
 
-##### Parameters:
 | Name | Type | Description                                                          |
 | :--- | :--- | :------------------------------------------------------------------- |
 |`leafType` | uint8 | Leaf type -->  [0] transfer Ether / ERC20 tokens, [1] message

docs/zkEVM/architecture/high-level/smart-contracts/api/lib/LegacyZKEVMStateVariables.md

@@ -1,5 +1,3 @@
-Since the current contract of PolygonZkEVM will be upgraded to a PolygonRollupManager there's defined
-all the legacy public variables in order to not use previous used storage slots
-The variables will be used by the RollupManager only for initialize the zkEVM inside the initializer function
+Legacy contract used after upgrade to PolygonRollupManager to preserve previous used storage slots. The variables will be used by the RollupManager only for initialize the zkEVM inside the initializer function.