PoS: style and language review

Fixing:

- Styling and format
- Obvious inaccuracies and mistakes

Author: hsutaiyu

docs/img/pos/stake-management-flow.png

@@ -1,17 +1,8 @@
 This guide provides a curated list of common commands and Polygon-specific operations essential for node operators. Whether you're setting up a full node, validator node or troubleshooting, these commands will assist you in managing your Polygon PoS environment effectively.
 
-## Frequently Used Commands for Bor & Heimdall
+## Frequently used commands
 
-Use the tabs below to switch between commands for Bor and Heimdall:
-
-<Tabs
-  defaultValue="bor"
-  values={[
-    { label: 'Bor Commands', value: 'bor', },
-    { label: 'Heimdall Commands', value: 'heimdall', },
-  ]
-}>
-<TabItem value="bor">
+### Bor
 
 To execute Bor IPC commands, use the following syntax:
 
@@ -32,8 +23,7 @@ bor attach .bor/data/bor.ipc <command>
 | `eth.getBlock("latest").number` | `curl http://YourIP:8545 -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0", "id":1, "method":"bor_getSigners", "params":["0x98b3ea"]}'` | Queries the height of the latest Bor block. |
 |  | `curl http://YourIP:8545 -X POST -H "Content-Type: application/json" --data '{"method":"eth_chainId","params":[],"id":1,"jsonrpc":"2.0"}'` | Retrieves the `chainID`. |
 
-</TabItem>
-<TabItem value="heimdall">
+### Heimdall
 
 | Command | Description |
 | ------- | ----------- |
@@ -45,9 +35,6 @@ bor attach .bor/data/bor.ipc <command>
 | `heimdalld unsafe-reset-all` | Resets the database in case of issues. |
 | `curl localhost:26657/status` | Provides comprehensive information about Heimdall. |
 
-</TabItem>
-</Tabs>
-
 ## Node Management Commands
 
 | Description                           | Command                                        |
@@ -95,14 +82,14 @@ curl http://<your ip>:8545 -X POST -H "Content-Type: application/json" -d '{"jso
 
 ### Cleanup: Deleting Remnants of Heimdall and Bor
 
-**For Linux package:**
+##### For Linux package:
 
 ```bash
 sudo dpkg -i matic-bor
 sudo rm -rf /etc/bor
 ```
 
-**For Binaries:**
+##### For Binaries:
 
 ```bash
 sudo rm -rf /etc/bor
@@ -111,14 +98,14 @@ sudo rm /etc/heimdall
 
 ### Terminate Bor Process
 
-**For Linux:**
+##### For Linux:
 
 ```bash
 ps -aux | grep bor
 sudo kill -9 <PID>
 ```
 
-**For Binaries:**
+##### For Binaries:
 
 ```bash
 cd CS-2003/bor
@@ -139,14 +126,14 @@ exit
 
 ### Stop Heimdall and Bor Services
 
-**For Linux packages:**
+##### For Linux packages:
 
 ```bash
 sudo service heimdalld stop
 sudo service bor stop
 ```
 
-**For Binaries:**
+##### For Binaries:
 
 ```bash
 pkill heimdalld
@@ -157,14 +144,14 @@ bash stop.sh
 
 ### Remove Heimdall and Bor Directories
 
-**For Linux packages:**
+##### For Linux packages:
 
 ```bash
 sudo rm -rf /etc/heimdall/*
 sudo rm -rf /etc/bor/*
 ```
 
-**For Binaries:**
+##### For Binaries:
 
 ```bash
 sudo rm -rf /var/lib/heimdalld/

docs/img/pos/stake-management-flow.svg

@@ -2,7 +2,7 @@ Bor is an integral component of the Polygon network that operates based on princ
 
 ## Proposers and Producers Selection
 
-Block Producers for the Bor layer are a committee selected from the Validator pool on the basis of their stake, which happens at regular intervals and is shuffled periodically. These intervals are decided by the Validator's governance with regard to dynasty and network.
+Block Producers for the Bor layer are a committee selected from the validator pool on the basis of their stake, which happens at regular intervals and is shuffled periodically. These intervals are decided by the Validator's governance with regard to dynasty and network.
 
 The ratio of Stake/Staking power specifies the probability to be selected as a member of the block producer committee.
 
@@ -17,7 +17,7 @@ The ratio of Stake/Staking power specifies the probability to be selected as a m
 
 ### Validators in Polygon's Proof-of-Stake System
 
-In Polygon's Proof-of-Stake (PoS) framework, participants can stake Matic tokens on a designated Ethereum smart contract, known as the "staking contract," to become validators. Active validators on Heimdall are eligible for selection as block producers through the `bor` module.
+In Polygon's Proof-of-Stake (PoS) framework, participants can stake MATIC tokens on a designated Ethereum smart contract, known as the "staking contract," to become validators. Active validators on Heimdall are eligible for selection as block producers through the Bor module.
 
 ### Span: Defining Validator Sets and Voting Power
 
@@ -47,7 +47,7 @@ The potential for forks arises when backup producers generate blocks due to dela
 
 ### View Change and Span Commitment
 
-At the end of each span, Bor undergoes a view change, fetching new producers for the subsequent span. This involves an HTTP call to the Heimdall node to retrieve new span data and a `commitSpan` call to the BorValidatorSet genesis contract. Block headers in Bor are also structured to include producer bytes, aiding in the fast-syncing process.
+At the end of each span, Bor undergoes a view change, fetching new producers for the subsequent span. This involves an HTTP call to the Heimdall node to retrieve new span data and a `commitSpan` call to the `BorValidatorSet` genesis contract. Block headers in Bor are also structured to include producer bytes, aiding in the fast-syncing process.
 
 ### State Synchronization with the Ethereum Chain
 

docs/pos/architecture/bor/commands.md

@@ -1,6 +1,6 @@
 This guide provides a detailed list of default ports used across Polygon nodes, including Bor and Heimdall. Understanding these ports is crucial for network configuration and effective communication between nodes.
 
-## Bor Node
+## Bor node
 
 | Name                    | Port  | Tags                      | Description                                                                                                    |
 |-------------------------|-------|---------------------------|----------------------------------------------------------------------------------------------------------------|
@@ -13,7 +13,7 @@ This guide provides a detailed list of default ports used across Polygon nodes,
 | Pprof Server            | 7071  | Internal, Monitoring      | Pprof server for collecting Bor metrics.                                                                        |
 | UDP Discovery           | 30301 | Can be Public, Internal   | Default port for Bootnode peer discovery.                                                                       |
 
-## Heimdall Node
+## Heimdall node
 
 | Name                    | Port  | Tags                      | Description                                                                                                    |
 |-------------------------|-------|---------------------------|----------------------------------------------------------------------------------------------------------------|