PoS: MATIC to POL migration

- New MATIC to POL migration guide
- Updates to POL reference doc

Author: hsutaiyu

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

@@ -1,29 +1,28 @@
-!!! danger "Important update"
-
-    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).
-
 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.
 
-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.
+## PIPs
 
-## Do I need to do anything today
+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.
 
-### ...as an active participant?
+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)
 
-No, if you’re currently using MATIC in the Polygon PoS network, there is nothing to do in the near term.
+!!! info "Initial amount of POL tokens"
 
-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.
+    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.
 
-You can participate in governance proposals to vote on various aspects of the Polygon ecosystem through the PIP program.
+## Do I need to do anything manually?
 
-### ...as a node delegator or operator?
+Please refer to the [MATIC to POL migration guide](../../get-started/matic-to-pol.md) for details on what action you need to perform, if any, depending on the chain they are currently located, i.e., Ethereum, Polygon PoS, Polygon zkEVM, etc. 
 
-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.
+!!! tip "Deep dive into POL"
 
-### ...as an application or tooling developer?
+    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 it entails for the Polygon ecosystem.
 
-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,56 @@
+# Overview
+
+The POL token represents a significant technical upgrade for the Polygon network. As the new native gas and staking token, POL will serve as the fundamental unit of value within Polygon ecosystem. 
+
+POL token's introduction aligns with Polygon’s broader vision of becoming an aggregated network of blockchains, enabling enhanced interoperability and scalability. By transitioning to POL, Polygon aims to optimize network efficiency, improve security, and provide a more robust foundation for future development.
+
+# Steps to migrate to POL
+
+## 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>
+
+## MATIC tokens on Ethereum
+
+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 zkEVM
+
+If your MATIC tokens are on the zkEVM chain, use Polygon Portal 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](https://docs.polygon.technology/pos/concepts/tokens/pol/)
+
+
+

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: