Merge branch 'main' of github.com:0xPolygon/polygon-docs into empieichO-docs-review

Author: EmpieichO

.github/workflows/prod_deployment.yml

@@ -31,6 +31,7 @@ jobs:
         uses: actions/checkout@v3
         with:
           submodules: true
+          fetch-depth: 0
 
       - name: Configure AWS credentials
         uses: aws-actions/configure-aws-credentials@v1-node16

.github/workflows/staging_deployment.yml

@@ -24,6 +24,7 @@ jobs:
         uses: actions/checkout@v3
         with:
           submodules: true
+          fetch-depth: 0
 
       - name: Configure AWS credentials
         uses: aws-actions/configure-aws-credentials@v1-node16

docs/pos/operate-node/delegate/delegate.md

@@ -1,5 +1,5 @@
 
-# How to Delegate
+# How to delegate
 
 This is a step-by-step guide to help you become a delegator on the Polygon Network.
 
@@ -24,7 +24,7 @@ The only prerequisite is to have your MATIC tokens and ETH on the Ethereum mainn
     If you are a validator, use a different non-validating address to log in as delegator.
 
 
-## Delegate to a Validator
+## Delegate to a validator
 
   1. Click **Become a Delegator** or scroll down to a specific validator and click **Delegate**.
 
@@ -80,7 +80,7 @@ This will withdraw the MATIC token rewards to your Ethereum address.
 
 This will restake the MATIC token rewards to the validator and increase your delegation stake.
 
-## Unbond from a Validator
+## Unbond from a validator
 
   1. Click [My Account](https://staking.polygon.technology/account).
 

docs/pos/operate-node/delegate/delegator-faq.md

@@ -1,16 +1,12 @@
 
-### What is the Staking Dashboard URL?
+### What is the staking dashboard URL?
 
 The staking dashboard URL is https://staking.polygon.technology/.
 
 ### What is the minimum stake amount?
 
 There is no minimum stake amount to delegate. However, you can always start with 1 MATIC token.
 
-### How many rewards will I get if I delegate?
-
-Please use the [Staking Rewards Calculator](https://staking.polygon.technology/rewards-calculator) to determine your estimates.
-
 ### Why does my transaction take so long?
 
 All staking transactions of Polygon happen on Ethereum for security reasons.
@@ -47,15 +43,15 @@ On the Dashboard, you can click on the **My Account** option on the left-hand si
 ![Figure: My account](../../../img/pos/my-account.png)
 
 
-### Do I need ETH to pay for Gas fees?
+### Do I need ETH to pay for gas fees?
 
 Yes. You should provision for ~0.05-0.1 ETH to be safe.
 
-### Do I need to deposit MATIC tokens to the Polygon Mainnet network for staking?
+### Do I need to deposit MATIC tokens to the Polygon mainnet network for staking?
 
-No. All your funds need to be on the Main Ethereum Network.
+No. All your funds need to be on the main Ethereum network.
 
-### When I try to do the transaction my Confirm button is disabled, why so?
+### When I try to do the transaction my **Confirm** button is disabled.
 
 Please check if you have enough ETH for the gas fees.
 
@@ -84,7 +80,7 @@ You can claim your rewards instantly by clicking on the **Withdraw Reward** butt
 ![Figure: Withdraw-reward](../../../img/pos/withdraw-reward.png)
 
 
-### What is the Unbonding period?
+### What is the unbonding period?
 
 The unbonding period on Polygon is 80 checkpoints. This period applies to the originally delegated amount and re-delegated amounts - it does not apply to any rewards that were not re-delegated.
 
@@ -98,16 +94,14 @@ Delegation requires 2 transactions, one after the other. One to **Approve** the
 
 ![Figure: Delegate ](../../../img/pos/delegate.png) 
 
-
-
-### What does Redelegate Rewards mean?
+### What does redelegate rewards mean?
 
 Redelegating your rewards simply means that you want to increase your stake by restaking the rewards you have accumulated.
 
 ### Can I stake to any validator?
 Yes, you can delegate to any validator except the ones which are offline.
 
-### Which browser is compatible with Staking Dashboard?
+### Which browser is compatible with the Polygon earnings calculator?
 
 Chrome, Firefox, and Brave
 
@@ -122,7 +116,7 @@ Check for the following:
 
 ### How do I send funds from Binance or other exchanges to Polygon wallet?
 
-Technically, the Polygon Wallet Suite/Staking interface is just a web application. Currently it supports the following wallets - Metamask, WalletConnect, and WalletLink.
+The Polygon Wallet Suite is a web application. 
 
 First, you must withdraw your funds from Binance or any other exchange to your Ethereum address on Metamask. If you don't know how to use Metamask, google it a bit. There are plenty of videos and blogs to get started with it.
 
@@ -140,87 +134,34 @@ If you have not re-delegated your rewards before delegating additional funds to
 
 In case you dont want that to happen, re-delegate your rewards before delegating additional funds.
 
-### I have delegated my tokens via MetaMask on the Staking dashboard. Do I need to keep my system or device on?
+### I have delegated my tokens via MetaMask on the dashboard. Do I need to keep my system or device on?
 
-No. Once your Delegation transactions are confirmed, and you can see your tokens reflected in the **Total Stake** and **New Reward** sections, then you are done. There is no need to keep your system or device on.
+No. Once your delegation transactions are confirmed, and you can see your tokens reflected in the **Total Stake** and **New Reward** sections, then you are done. There is no need to keep your system or device on.
 
-### I have unbonded, how long will it take to Unbond?
+### I have unbonded, how long will it take to unbond?
 
 The unbonding period is currently set to 80 checkpoints. Every checkpoint takes approximately 30 minutes. However, some checkpoints could be delayed upto ~1 hour due to congestion on Ethereum.
 
-### I have unbonded, and I now see the Claim Stake button, but it is disabled, why is that?
+### I have unbonded, and I now see the **Claim Stake** button, but it is disabled.
 
 The Claim Stake button will only be enabled when your unbonding period is complete. The unbonding period is currently set at 80 checkpoints.
 
-### Do I know when will the Claim Stake button be enabled?
+### When will the **Claim Stake** button be enabled?
 
-Yes, under the Claim Stake button you would see a note on how many checkpoints are pending before the Claim Stake button would be enabled. Every checkpoint takes approximately 30 minutes. However, some checkpoints could be delayed upto ~1 hour due to congestion on Ethereum.
+Under the **Claim Stake** button you should see a note on how many checkpoints are pending before the **Claim Stake** button is enabled. Every checkpoint takes approximately 30 minutes. However, some checkpoints could be delayed upto ~1 hour due to congestion on Ethereum.
 
 ![Figure: Unbound ](../../../img/pos/unbond.png)
 
 
-<!-->Hiding questions pertaining to foundation nodes, since there are no foundation nodes anymore<!-->
-<!--
-### How do I switch my delegation from Foundation Nodes to External nodes?
-
-You can switch your Delegation using the **Move Stake** option on the Staking UI. This will switch your Delegation from the Foundation node to any other external node of your choice.
-
-<div align="center">
-  <img src={useBaseUrl("/img/delegator-faq/move-stake.png")} width="500" />
-</div>
-
-You will see a list of other validators:
-
-<div>
-  <img src={useBaseUrl("/img/delegator-faq/validators.png")} />
-</div>
-
-
-### Will there be any ubonding period when I switch Delegation from Foundation nodes to external nodes?
-
-There will be no Unbonding period when you switch Delegation from foundation nodes to external nodes. It will be a direct switch without any delays. However, if you are unbonding from a Foundation Node or an External node there will be an Unbonding period for that.
-
-### Are they any specifics to choose an external node during switch delegation?
-
-No. You can choose any node of your choice.
-
-### What happens to my rewards that are accumalated if I switch delegation from Foundation to External node?
-
-If you haven't already claimed your rewards before switching delegation, then upon successful switch of your delegation from Foundation to External the Rewards that were accumalated till then will be transferred back to your account.
-
-### Will delegation on the External Nodes work the same as Foundation Nodes?
-
-Yes, it will work the same as Foundation nodes.
-
-### Will I still get rewards after delegating to an External Node?
-
-Yes, rewards will be distributed the same as earlier with the Foundation nodes. Every successful submission of a checkpoint will yield in rewards. Rewards will be distributed and calculated at every checkpoint relative to the stake ratio, as currently implemented.
-
-### Will there be any unbonding period if I unbond from an External Node?
-
-Yes, the unbonding period will stay the same as currently implemented. 82 Checkpoints.
-
-### Will there be any locking period after I switch my Delegation from Foundation to External node?
-
-No. There won't be any locking period after you switch your delegation.
-
-### Can I partially switch my delegation from Foundation to External nodes?
-
-Yes, you will have the option to partially move your stake from Foundation node to an external node. The remaining partial stake will remain on the Foundation node. You can then move that to another node of your choice or the same node.
-
-### Can I switch delegation from an external node to another external node?
-
-No, the **Move Stake** option is only available on the Foundation Nodes. If you want to switch your delegation from an external node to another external node, you will have to unbond first and then delegate to another external node.
-<!-->
 
-### Have the Foundations nodes been turned off?
+### Have the foundations nodes been turned off?
 
 Yes, the foundation nodes had been turned off.
 
-### Will there be any Foundation nodes in the future?
+### Will there be any foundation nodes in the future?
 
 No, there won't be any Foundation nodes in the future.
 
-### How many transactions do I need to pay for Gas when I do a Move Stake?
+### How many transactions do I need to pay for gas when I do a "move stake"?
 
-The Move Stake is a single transaction only. All transactions would be on the Ethereum Blockchain so you would need to spend some ETH while doing the Move Stake transaction.
+The move stake is a single transaction only. All transactions are on the Ethereum blockchain so you will spend some ETH to make the transaction.

docs/pos/operate-node/validator/run-validator/binaries.md

@@ -11,11 +11,11 @@ follow the [Validator Node System Requirements](/pos/validator/validator-node-sy
     For snapshot download links, see [<ins>Polygon Chains Snapshots</ins>](https://snapshot.polygon.technology/).
 
 
-## Port Configuration Details
+## Port configuration details
 
-Here are a few instructions on how to configure ports for Sentry and Validator nodes.
+Here are a few instructions on how to configure ports for sentry and validator nodes.
 
-### For Sentry nodes
+### For sentry nodes
 
   - **Port 22**: Opening this to the public is not a good idea as the default SSH port 22 is prone to attacks. It is better to secure it by allowing it only in a closed network (VPN).
 
@@ -30,7 +30,7 @@ Here are a few instructions on how to configure ports for Sentry and Validator n
   - **Ports 8545, 8546, 1317**: Can be opened for Bor HTTP RPC, Bor WS RPC, and Heimdall API respectively; but only if really necessary.
 
 
-### For Validator nodes
+### For validator nodes
 
   - **Port 22**: Opening this to the public is not a good idea as the default SSH port 22 is prone to attacks. It is better to secure it by allowing it only in a closed network (VPN).
 

docs/pos/operate-node/validator/staking-faq.md

@@ -32,21 +32,21 @@ Please watch this video for a graphical illustration of how this works:
 
 Check if you have funds on the Main Ethereum Network, to delegate your tokens. All staking happens on the Ethereum Network only.
 
-### I am unable to view the Staking tab. How do I access Staking?
+### I am unable to view the staking tab. How do I access staking?
 
 You just need to access **https://staking.polygon.technology/**, where you will see the following landing page:
 
 ![img](../../../img/pos/staking-lp.png)
 
 
-### How do I know which Validator to select for better rewards?
+### How do I know which validator to select for better rewards?
 
 It depends on your understanding and research on which validator you would want to stake on. You can find the list of validators here : https://staking.polygon.technology/validators
 
 ### How to unbond?
 
-To Unbond from a Validator, navigate to MyAccount, where you find "Your Delegations".
-There you will see an Unbond button for each of the validators. Click on the Unbond button for whichever validator that you want to unbond from.
+To unbond from a validator, navigate to MyAccount, where you find **Your Delegations**.
+There you will see an **Unbond** button for each of the validators. Click on the **Unbond** button for whichever validator that you want to unbond from.
 
 ![img](../../../img/pos/unbond-from-validator.png)
 
@@ -66,8 +66,8 @@ This period applies to the originally delegated amount and re-delegated amounts.
 
 ### How to restake rewards?
 
-Go to “My Account” to check "Your Delegations".
-Clicking on "Restake Reward" will ask you for confirmation from your wallet account. Once you confirm the transaction, only then the restake transaction would be complete.
+Go to **My Account** to check **Your Delegations**.
+Clicking on **Restake Reward** will ask you for confirmation from your wallet account. Once you confirm the transaction, only then the restake transaction would be complete.
 
 `Step 1` 
   <center>
@@ -86,13 +86,13 @@ Please watch the video for a graphical illustration of how this works:
   <p>Your browser does not support the video element.</p>
 </video>
 
-### I want to Restake Rewards but I am unable to.
+### I want to restake rewards but I am unable to.
 
 You would need to have a minimum of **2 Matic** to restake rewards.
 
 ### How to withdraw rewards?
 
-You can claim your rewards by clicking on the “My Account”, all the delegators for a validator are displayed. Click on the “Withdraw Reward” button and the rewards will be transferred to your delegated account in wallet.
+You can claim your rewards by clicking on the **My Account**, all the delegators for a validator are displayed. Click on the **Withdraw Reward** button and the rewards will be transferred to your delegated account in wallet.
 
 `Step 1` <br/>
 <center>
@@ -111,13 +111,13 @@ Please watch the video for a graphical illustration of how this works:
   <p>Your browser does not support the video element.</p>
 </video>
 
-### I want to Withdraw Rewards but I am unable to.
+### I want to withdraw rewards but I am unable to.
 
 You would need to have a minimum of **2 Matic** to withdraw rewards.
 
 ### How to claim stake?
 
-Once the **unbonding period is complete**, the Claim Stake button will be enabled and you can then claim your staked tokens. The tokens will be transferred to your account.
+Once the unbonding period is complete, the **Claim Stake** button will be enabled and you can then claim your staked tokens. The tokens will be transferred to your account.
 
 `Step 1` <br/>
 <center>
@@ -143,15 +143,15 @@ Please watch the video for a graphical illustration of how this works:
 
 ### Are hardware wallets supported?
 
-Yes, hardware wallets are supported. You can use the "Connect Hardware Wallet" option on MetaMask and connect your Hardware wallet and then continue the delegation process.
+Yes, hardware wallets are supported. You can use the **Connect Hardware Wallet** option on MetaMask and connect your Hardware wallet and then continue the delegation process.
 
 ### Why can’t I stake directly from Binance?
 
 Staking through Binance is not yet supported. There will be an announcement if and when Binance starts supporting it.
 
 
-### Do I need to deposit Matic to the Polygon Mainnet network for staking?
-No. All your funds need to be on the Main Ethereum Network.
+### Do I need to deposit Matic to the Polygon mainnet network for staking?
+No. All your funds need to be on the Ethereum mainnet.
 
 
 ### When do rewards get distributed?
@@ -176,7 +176,7 @@ Rewards will be higher, to begin with, and will keep decreasing as the locked su
 No. Once you unbond you stop receiving rewards.
 
 ### Can I move the stake to another validator?
- Yes, you just have to reach "Your Delegations", click on "Move Stake", and then choose your new validator.
+ Yes, you just have to access **Your Delegations**, click on **Move Stake**, and then choose your new validator.
 
 Please watch the video for a graphical illustration of how this works:
 
@@ -185,14 +185,14 @@ Please watch the video for a graphical illustration of how this works:
   <p>Your browser does not support the video element.</p>
 </video>
 
-### Which browsers are compatible with the Staking Dashboard?
+### Which browsers are compatible with the staking dashboard?
 
 Chrome, Firefox, and Brave.
 
 ### Nothing happens when I try to log in or my MetaMask is stuck at confirming after logging in. What do I do?
 
 Check for the following:
-- If you’re using Brave, please turn off the option for “Use Crypto Wallets” in the settings panel.
+- If you’re using Brave, please turn off the option for **Use Crypto Wallets** in the settings panel.
 - Check if you are logged into Metamask.
 - Check if you are logged into MetaMask with Trezor/Ledger. You need to additionally turn on permission to call contracts on your Ledger device, if not enabled already.
 - Check your system timestamp. If the system time is not correct, you will need to correct it.

docs/pos/operate-node/validator/technical-faqs.md

@@ -265,12 +265,12 @@ You can run the following command to check it:
 Check the value of catching_up. If it is false then the node is all synced up.
 
 
-### 15. Deprecated FAQ: What if someone become a Top 10 staker, how he will receive his MATIC reward at the end?
+### 15. If someone becomes a top 10 staker, how do they receive their MATIC reward?
 
 Stage 1 rewards are not based on stake. Participants with high stake don't automatically qualify for a reward in this stage.
 
 
-### 16. What should be my heimdall version?
+### 16. What should the Heimdall version be?
 
 To check your Heimdall version you can simply run: