Fix some PR comments

docs/core-tech/address.md

@@ -4,21 +4,21 @@ title: Address
 sidebar_label: Address
 ---
 
-An Alephium address is an identifier used to interact with an Alephium network. Addresses can be user-controlled or deployed through a contract.
+An Alephium address represents a user or a contract within the Alephium network. Addresses can be user-controlled or deployed through a contract.
 
 ## Address type
 
 Alephium has two address types:
 
-* Asset: corresponding to a public/private key pair. Controlled by the private key
-* Contract: created when deploying a contract. Controlled by the code.
+* Asset: generated with one or multiple public/private key pair or a script.
+* Contract: Created when deploying a contract. Controlled by the code.
 
 Both address types are able to:
 
 * Receive, hold and send ALPH and tokens
 * Interact with deployed contracts
 
-Assets can have three different form:
+Assets can have three different forms:
 
 * P2PKH: Pay-to-Public-Key-Hash
 * P2MPKH: Pay-to-Multi-Public-Key-Hash, also known as `multisig`
@@ -28,11 +28,11 @@ While contract addresses are currently only defined as:
 
 * P2C: Pay-to-Contract
 
-## Asset address
+## P2PKH address
 
-An asset address is derived from a cryptographic pair of public and private keys, using the same [secp256k1's elliptic curve](https://en.bitcoin.it/wiki/Secp256k1) as bitcoin. 
-Those keys play a crucial role in validating the authenticity of a transaction and safeguarding against fraudulent activities. 
-The private key is used to sign the transactions, as the address is derived from the public key, anyone can validate the signature.
+An p2pkh address is derived from a cryptographic pair of public and private keys, using the same [secp256k1's elliptic curve](https://en.bitcoin.it/wiki/Secp256k1) as bitcoin.
+Those keys play a crucial role in validating the authenticity of a transaction and safeguarding against fraudulent activities.
+The private key can be used to sign any messages, including transactions. As the address is derived from the public key, anyone can validate the signature.
 
 ## Contract address
 

docs/core-tech/block.md

@@ -4,16 +4,16 @@ title: Block
 sidebar_label: Block
 ---
 
-A block is a fundamental component of the blockchain, it is a data structure that contains a batch of validated transactions along with other essential information. 
+A block is a fundamental component of the blockchain, it is a data structure that contains a batch of validated transactions along with other essential information.
 Blocks are linked together to form a [BlockFlow](/core-tech/blockflow-and-sharding).
 
 ## Prerequisites
 
-Understanding of a [Transaction](/core-tech/transaction) is a plus.
+Understanding of a [Transaction](/core-tech/transaction) is required.
 
 ## Overview of a Block
 
-Each Alephium block includes various components, such as the timestamp of creation, a record of transactions, and a reference to the dependencies blocks. Additionally, it incorporates the solution to the mining puzzle that is unique to each block, so the network can easily verify its correctness. While multiple valid solutions may exist for a given block, only one needs to be discovered to consider the block solved. As an incentive for solving each block, miners are rewarded with new generated ALPH.
+Each Alephium block includes various components, such as the timestamp of creation, a record of transactions, and a references to the dependent blocks. Additionally, it incorporates the solution to the mining puzzle that is unique to each block, so the network can easily verify its correctness. While multiple valid solutions may exist for a given block, only one needs to be discovered to consider the block solved. As an incentive for solving each block, miners are rewarded with newly generated ALPH.
 
 New transactions are constantly being processed by miners into new blocks and added to the BlockFlow.
 
@@ -27,7 +27,7 @@ The block model is quite simple:
 The `header` contains all other metadata:
 
 * nonce
-* version: 
+* version:
 * blockDeps: A list of older block hashes, used to validate the BlockFlow
 * depStateHash: : TBD
 * txsHash: An hash based on all transactions