Merge pull request 0xPolygon#672 from 0xPolygon/matic-to-pol

MATIC to POL migration

Author: rahuldamodar94

docs/img/pos/change-token-name-1.png

@@ -1,29 +1,28 @@
-!!! danger "Important update"
+POL is the native token upgrade for the Polygon ecosystem, designed for use in a wide range of activities and various purposes. For instance, POL is used as a tool for network participation and security. By staking POL, participants can actively contribute to the ecosystem as validators. Importantly, like MATIC, POL is built on OpenZeppelin's ERC20 implementations, supports [EIP-2612](https://eips.ethereum.org/EIPS/eip-2612) for signature-based permit approvals, and thus inherits most of the features found in MATIC.
 
-    There is a proposal to transition the native token of the Polygon PoS network from MATIC to POL. This document will provide details on what this means for users of MATIC, the Polygon ecosystem, and the planned changes. Please read carefully and find more information [here](https://polygon.technology/blog/polygon-2-0-implementation-officially-begins-the-first-set-of-pips-polygon-improvement-proposals-released).
+## PIPs
 
-POL is the native token upgrade for the Polygon ecosystem, designed for use in a wide range of activities and purposes, including as a tool for network participation and security. By staking POL, participants can actively contribute to the ecosystem as validators. Importantly, POL has many of the same features as MATIC, is built on OpenZeppelin's ERC20 implementations, and supports [EIP-2612](https://eips.ethereum.org/EIPS/eip-2612) for signature-based permit approvals.
+Community-driven governance and feedback played a crucial role in refining the POL token's design and functionality. Learn more about the proposals by following the links below.
 
-If the POL proposal is supported by the community, the POL upgrade is estimated to take place in Q4 2023. The systems utilizing MATIC will not begin the transition until Q1 2024, allowing time for a smooth migration/upgrade and stakeholder preparation. The initial amount of POL refers to the total number of POL when the upgrade occurs. In the case of POL, the initial amount is 10 billion tokens — 1:1 with MATIC since this is an upgrade.
+1. [PIP-17: Polygon Ecosystem Token (POL)](https://forum.polygon.technology/t/pip-17-polygon-ecosystem-token-pol/12912)
+2. [PIP-18: Polygon 2.0 Phase 0 - Frontier](https://forum.polygon.technology/t/pip-18-polygon-2-0-phase-0-frontier/12913)
+3. [PIP-19: Update Polygon PoS Native Token to POL](https://forum.polygon.technology/t/pip-19-update-polygon-pos-native-token-to-pol/12914)
+4. [PIP-25: Adjust POL Total Supply](https://forum.polygon.technology/t/pip-25-adjust-pol-total-supply/13008)
+5. [PIP-26: Transition from MATIC to POL Validator Rewards](https://forum.polygon.technology/t/pip-26-transition-from-matic-to-pol-validator-rewards/13046)
 
-## Do I need to do anything today
+!!! info "Initial amount of POL tokens"
 
-### ...as an active participant?
+    In the case of POL, the initial amount (the total number of POL when the upgrade occurs) is 10 billion tokens — 1:1 with MATIC since this is an upgrade.
 
-No, if you’re currently using MATIC in the Polygon PoS network, there is nothing to do in the near term.
+## Do I need to do anything manually?
 
-Separately, you are encouraged to engage in the governance and decision-making processes put forward by the recent PIPs.
-Your involvement and input can play a significant role in shaping the future of the Polygon ecosystem.
+Please refer to the [MATIC to POL migration guide](../../get-started/matic-to-pol.md) for details on what action you need to take, if any, depending on the chain they are currently located, i.e., Ethereum, Polygon PoS, Polygon zkEVM, etc. 
 
-You can participate in governance proposals to vote on various aspects of the Polygon ecosystem through the PIP program.
+!!! tip "Deep dive into POL"
 
-### ...as a node delegator or operator?
+    Read the detailed [blog post on the POL migration](https://polygon.technology/blog/save-the-date-matic-pol-migration-coming-september-4th-everything-you-need-to-know) to learn more about the POL token, its properties, and what the migration means for the Polygon ecosystem.
 
-No. You can provide feedback on the proposed changes in the PIPs and monitor GitHub and the forum for new node software versions to remain compatible with your given chain when PIPs are approved by the community.
-
-### ...as an application or tooling developer?
-
-No. You can review the [PIPs](https://forum.polygon.technology/t/pip-17-polygon-ecosystem-token-pol/12912) and provide feedback on the proposed changes and analyze if any changes break your smart contracts. Developers for applications on the Polygon PoS should not see any breaking changes.
+As a dApp developer, feel free to review the PIP's to analyze the changes to the token protocol. Ideally, developers shouldn't see any breaking changes. But if you do, feel free to reach out to us via the [developer Discord](https://discord.com/invite/0xPolygonDevs).
 
 ## POL technical information
 

docs/img/pos/change-token-name-2.png

@@ -0,0 +1,62 @@
+## Overview
+
+The technical upgrade from MATIC to POL marks a critical juncture for the Polygon networks, enhancing utility and aligning with the vision as an aggregated network of blockchains. 
+
+POL will serve as a hyperproductive token: the native gas and staking token on Polygon PoS, as well as supporting the network's future expansion and security as an aggregated network.
+
+## Steps to migrate to POL
+
+### MATIC tokens on Ethereum
+
+!!! info "Stakers and delegators"
+
+    MATIC stakers don't need to take any action to upgrade from MATIC to POL.
+
+If your MATIC tokens are on Ethereum, you can use [Polygon Portal's migration interface](https://portal.polygon.technology/pol-upgrade) to migrate your MATIC tokens to POL. The process is as follows:
+
+1. Navigate to Polygon Portal's migration interface: https://portal.polygon.technology/pol-upgrade
+2. Switch to Ethereum network in your wallet and connect to the Portal UI.
+3. Approve the migration action by granting the upgrade contract permission to access your MATIC tokens.
+4. Perform the migration action to receive POL in your wallet.
+
+### MATIC tokens on Polygon PoS
+
+If your MATIC tokens are stored in your wallet on the Polygon PoS chain, you won't need to manually migrate them — they'll be automatically converted to POL at a 1:1 ratio.
+
+However, you'll need to update the native token symbol in your wallet's network settings. If the token symbol isn't updated, the wallet may continue to display MATIC as the token name instead of POL.
+
+Here’s how to do this in MetaMask.
+
+1. Within your browser, open your MetaMask wallet in the expanded mode by selecting on the **Expand view** option from the options menu in the top-right corner.
+
+    <center>
+    ![change-token-name-1](../../img/pos/change-token-name-1.png){width=50%}
+    </center>
+
+2. Select the options menu again from the wallet's expanded view, and then select **Settings** from the drop-down list.
+
+    ![change-token-name-2](../../img/pos/change-token-name-2.png)
+
+3. Select the **Networks** tab from left sidebar to bring up the network settings. Switch to **Polygon Mainnet** if you're currently on another network. The list of configuration options on the right shows the **Currency symbol** which is currently set to **MATIC**.
+
+    ![change-token-name-3](../../img/pos/change-token-name-3.png)
+
+4. Change the **Currency symbol** to **POL**, and select **Save** at the bottom. You can ignore the warning in yellow in this case.
+
+    <center>
+    ![change-token-name-4](../../img/pos/change-token-name-4.png){width=50%}
+    </center>
+
+The process to change the token symbol may vary depending on the wallet you're using. Please refer to the docs specific to your wallet and follow the outlined steps accordingly.
+
+### MATIC tokens on Polygon zkEVM
+
+If your MATIC tokens are on the zkEVM chain, use [Polygon Portal](https://portal.polygon.technology/bridge) to bridge your tokens to Ethereum, and then follow the steps described in the [MATIC tokens on Ethereum section](#matic-tokens-on-ethereum).
+
+## Read more about POL
+
+1. [Detailed blog post on MATIC to POL migration](https://polygon.technology/blog/save-the-date-matic-pol-migration-coming-september-4th-everything-you-need-to-know)
+2. [POL token reference doc](../concepts/tokens/pol.md)
+
+
+

docs/img/pos/change-token-name-3.png

@@ -312,6 +312,7 @@ nav:
       - Overview: pos/overview.md
       - Get started: 
         - Get started: pos/get-started/index.md
+        - Migrate to POL: pos/get-started/matic-to-pol.md
         - Building on Polygon: pos/get-started/building-on-polygon.md
         - Becoming a validator: pos/get-started/becoming-a-validator.md
       - Builder how-tos: