Dev tools: restructuring and update

hsutaiyu · hsutaiyu · commit 4655d3589dd5 · 2024-09-13T15:16:01.000+04:00
- Restructure for a more logical flow, taking page popularity into account
- MATIC -&gt; POL migration updates
- dapp-launchpad minor update
diff --git a/docs/pos/get-started/building-on-polygon.md b/docs/pos/get-started/building-on-polygon.md
@@ -44,7 +44,6 @@ There are several other third-party wallet options available to choose from, and
 
     Refer to the following guides and follow along to set up your wallet for making web3 function calls:
     
-    - [MetaMask](../../tools/wallets/metamask/index.md)
     - [Venly](../../tools/wallets/venly/index.md)
 
 ## Common tasks
diff --git a/docs/tools/dApp-development/common-tools/remix.md b/docs/tools/dApp-development/common-tools/remix.md
@@ -79,7 +79,7 @@ The `update` function is another public function that is similar to the constr
 
 Now, we have to deploy our smart contract on Amoy, the Polygon testnet. Not only does it cost money (e.g., gas fees) to deploy a smart contract on Polygon mainnet, but the contract is immutable and can't be changed once deployed. Therefore, it's best to deploy your smart contract to the testnet first.
 
-To deploy to the Amoy testnet, we have to connect to the web3 with a service like MetaMask, Brave, Portis, etc. We use MetaMask in this tutorial. Please follow this [guide to set up a MetaMask account](../../wallets/metamask/index.md).
+To deploy to the Amoy testnet, we have to connect to the web3 with a service like MetaMask, Brave, Portis, etc. We use MetaMask in this tutorial. Please follow this [guide to set up a MetaMask account](https://support.metamask.io/getting-started/getting-started-with-metamask/).
 
 - Open Metamask. Click on the network dropdown menu (set to **Ethereum Mainnet** by default) and click on the **Add Network** button. MaticVigil provides a public endpoint and is rate-limited. Therefore, most developers use a free blockchain provider like [Alchemy](https://docs.alchemy.com/docs/how-to-add-polygon-to-metamask) or [Quicknode](https://www.quicknode.com/guides/smart-contract-development/how-to-deploy-a-smart-contract-on-maticpolygon#setting-up-metamask-with-polygon-node) to have a dedicated RPC endpoint with faster throughput AKA computing units per second (CUPs). You need to create a free account to get your private API key from one of these providers to put into the dedicated RPC endpoint URL below.
 
diff --git a/docs/tools/dApp-development/common-tools/replit.md b/docs/tools/dApp-development/common-tools/replit.md
@@ -29,7 +29,7 @@ You need a browser-based web3 wallet to interact with the Polygon Amoy testnet a
 You must set up all of the following prerequisites to be able to deploy your solidity smart contract on Polygon:
 
 1. [Create a Replit account](https://replit.com/signup).
-2. [Download MetaMask wallet](../../wallets/metamask/index.md).
+2. [Download MetaMask wallet](https://support.metamask.io/getting-started/getting-started-with-metamask/).
 3. [Configure Polygon on MetaMask](../../wallets/metamask/add-polygon-network.md).
 4. [Get testnet tokens](https://faucet.polygon.technology).
 
diff --git a/docs/tools/dApp-development/launchpad/quickstart.md b/docs/tools/dApp-development/launchpad/quickstart.md
@@ -53,15 +53,15 @@ There are mandatory environment variables in both the `frontend` and `smart-cont
 
 3. Open the `.env` file and add the `NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID` to the file. 
 
-    !!! info "How to get the WalletConnect project id"
+    !!! info "How to get the WalletConnect project "
         You can get the variable by creating an application on [WalletConnect](https://cloud.walletconnect.com/). 
         
         1. Create an account and sign in.
         2. Select **Create a new project**.
-        3. Give it a name and select **App**. 
-        4. The URL can be blank. 
-        5. Click the **Create** button underneath the project box.
-        6. Copy the project id and paste it into the frontend `.env` file.
+        3. Give it a name and select **Continue**. You can leave the URL empty for now.
+        4. Select **AppKit** and continue.
+        5. Select **Next.js** and then select the **Create** button the bottom right of the pop-up window.
+        6. This brings up the dashboard. Copy the project ID form the sidebar on the left and paste it into the frontend `.env` file.
 
 4. Navigate to the smart-contracts directory and copy the example file.
 
diff --git a/docs/tools/gas/matic-faucet.md b/docs/tools/gas/matic-faucet.md
@@ -2,45 +2,39 @@
 comments: true
 ---
 
-The Polygon Faucet is a tool provided by Polygon and ecosystem partners like Alchemy, QuickNode, and GetBlock. It enables developers to acquire free MATIC/ETH test tokens on the PoS Amoy and zkEVM Cardona testnets. Start deploying and testing your dApps on the Polygon network with test tokens that allow you to explore Polygon features without spending actual MATIC tokens on the mainnet.
-
-Polygon Faucet drips:
-
-- MATIC on PoS Amoy and Ethereum Sepolia.
-- Test ETH on zkEVM Cardona.
-
 !!! info "Testnet tokens hold no real-world value"
       Tokens on testnets such as PoS Amoy, Ethereum Sepolia, and zkEVM Cardona hold no real value and are solely used for testing purposes.
 
-Several faucet tools are available to receive test MATIC and ETH on Sepolia-anchored Polygon networks:
+Several faucet tools are available to receive test POL and ETH on Sepolia-anchored Polygon networks:
 
-|          Faucet          | Supported networks                                                                                                    |
-| :----------------------: | --------------------------------------------------------------------------------------------------------------------- |
-|      Polygon Faucet      | [zkEVM Cardona, PoS Amoy, Ethereum Sepolia](https://faucet.polygon.technology)                                                 |
-|         Alchemy Faucet         | [PoS Amoy](https://www.alchemy.com/faucets/polygon-amoy) \| [Ethereum Sepolia](https://www.alchemy.com/faucets/ethereum-sepolia) |
-| QuickNode Polygon Faucet | [PoS Amoy](https://faucet.quicknode.com/polygon/amoy)                                                                 |
-|     GetBlock Faucet      | [PoS Amoy](https://getblock.io/faucet/matic-amoy/) \| [Ethereum Sepolia](https://getblock.io/faucet/eth-sepolia)                 |  
+|          Faucet          | Supported networks                                                                                                               |
+| :----------------------: | -------------------------------------------------------------------------------------------------------------------------------- |
+|      Polygon Faucet      | [zkEVM Cardona, PoS Amoy, Ethereum Sepolia](https://faucet.polygon.technology)                                                   |
+|      Alchemy Faucet      | [PoS Amoy](https://www.alchemy.com/faucets/polygon-amoy) \| [Ethereum Sepolia](https://www.alchemy.com/faucets/ethereum-sepolia) |
+| QuickNode Polygon Faucet | [PoS Amoy](https://faucet.quicknode.com/polygon/amoy)                                                                            |
+|     GetBlock Faucet      | [PoS Amoy](https://getblock.io/faucet/matic-amoy/) \| [Ethereum Sepolia](https://getblock.io/faucet/eth-sepolia)                 |
 
 ## Polygon Faucet
 
+The Polygon Faucet is a tool provided by Polygon and ecosystem partners like Alchemy, QuickNode, and GetBlock. It enables developers to acquire free POL/ETH test tokens on the PoS Amoy and zkEVM Cardona testnets. Start deploying and testing your dApps on the Polygon network with test tokens that allow you to explore Polygon features without spending actual POL tokens on the mainnet.
+
+Polygon Faucet drips:
+
+- POL on PoS Amoy.
+- POL and a dummy ERC20 token on Ethereum Sepolia.
+- Test ETH on zkEVM Cardona.
+
 - Start by navigating to [faucet.polygon.technology](https://faucet.polygon.technology/) and connecting/verifying your Discord by selecting **Connect Discord** in the top-right corner of the page.
 
    <center>
    ![img](../../img/tools/gas/faucet.png){width=70%}
    </center>
 
-- Select one of the blockchain testnet networks from the drop-down list:
-  
-      - **Polygon zkEVM (Cardona)**
-      - **Polygon PoS Amoy (Amoy)**
-      - **Sepolia**
+- Select one of the blockchain testnet networks from the drop-down list. We'll select **Polygon zkEVM (cardona)** for this example.
 
-- Select the type of token you want to receive:
-  
-      - **zkEVM ETH**: Testnet ETH on zkEVM Cardona.
-      - **MATIC**: Testnet MATIC on the PoS Amoy and Ethereum Sepolia.
+- Select the type of token you want to receive; zkEVM ETH in this case.
 
-- Once done, copy your wallet address and select **Paste** to paste it in the text box. Typing is disabled to prevent entering a wrong address. 
+- Copy your wallet address and either paste it directly in the **Wallet Address** field, or select **Paste**. Typing is disabled to prevent entering a wrong address.
 
 - Select **Submit**. 
 
@@ -50,45 +44,45 @@ Several faucet tools are available to receive test MATIC and ETH on Sepolia-anch
    ![img](../../img/tools/gas/confirm-transaction.png){width=50%}
    </center>
 
-!!! danger
-
-      If you don't have enough MATIC testnet tokens in your account to pay for the gas fees, the transaction may fail. If you require testnet tokens in bulk, please fill out [this form](https://docs.google.com/forms/d/e/1FAIpQLSe4npoGldJknEs9EBtPaV3AS-0HTso2IuMWDCiMmLEMCx8euQ/viewform).
-
 - Testnet tokens usually arrive within 1 to 2 minutes.
 
    <center>
    ![img](../../img/tools/gas/success.png){width=50%}
    </center>
 
+!!! tip "Always maintain sufficient test token balance"
+
+      If you don't have enough POL/ETH test tokens in your wallet account to pay for gas fees when sending transactions, the action will fail. If you require testnet tokens in bulk, please fill out [this form](https://docs.google.com/forms/d/e/1FAIpQLSe4npoGldJknEs9EBtPaV3AS-0HTso2IuMWDCiMmLEMCx8euQ/viewform).
+
 ## Alchemy Faucet
 
-!!! tip "Get 0.5 Amoy MATIC"
-      If you sign up or log in with an Alchemy account, you get 0.5 MATIC per day. Without an account, you get 0.2.
+!!! tip "Get 0.5 Amoy POL"
+      If you sign up or log in with an Alchemy account, you get 0.5 POL per day. Without an account, you get 0.2.
 
-- You can request MATIC tokens from Alchemy's Amoy Faucet. In order to receive testnet tokens, head over to the [Alchemy Polygon Amoy MATIC faucet](https://www.alchemy.com/faucets/polygon-amoy), enter your wallet address and hit the **Send Me MATIC** button.
+- You can request POL tokens from Alchemy's Amoy Faucet. In order to receive testnet tokens, head over to the [Alchemy Polygon Amoy POL faucet](https://www.alchemy.com/faucets/polygon-amoy), enter your wallet address and hit the **Send Me POL** button.
 
    ![img](../../img/tools/gas/alchemy-faucet1.png)
 
-- Check the transaction hash as soon as you finish requesting your MATIC, and view the transaction details on [Polygonscan](https://amoy.polygonscan.com/).
+- Check the transaction hash as soon as you finish requesting your POL, and view the transaction details on [Polygonscan](https://amoy.polygonscan.com/).
 
 ## QuickNode Polygon Faucet
 
-In order to receive Amoy MATIC tokens using QuickNode faucet,
+In order to receive Amoy POL tokens using QuickNode faucet,
 
 - Head over to the [QuickNode Polygon Faucet](https://faucet.quicknode.com/polygon). Connect your Coinbase, MetaMask, or Phantom wallet by clicking on **Connect Wallet**. Then, choose **Amoy**, and finally select **Continue**.
 
    <center>
    ![img](../../img/tools/gas/quicknode-faucet2.png){width=80%}
    </center>
 
-!!! tip "Get 2x MATIC"
-      Tweet the [drip faucet URL](https://faucet.quicknode.com/drip) with your wallet address to get *twice* as many MATIC testnet tokens.
+!!! tip "Get 2x POL"
+      Tweet the [drip faucet URL](https://faucet.quicknode.com/drip) with your wallet address to get *twice* as many POL testnet tokens.
 
 - Click on the transaction hash to view transaction details on [Polygonscan](https://amoy.polygonscan.com/).
 
 ## GetBlock Polygon Faucet
 
-Head over to the [GetBlock Polygon Faucet](https://getblock.io/faucet/matic-amoy/) to acquire Amoy MATIC tokens using the GetBlock faucet.
+Head over to the [GetBlock Polygon Faucet](https://getblock.io/faucet/matic-amoy/) to acquire Amoy POL tokens using the GetBlock faucet.
 
 Please register or login to request free testnet tokens.
 
diff --git a/docs/tools/wallets/metamask/overview.md b/docs/tools/wallets/metamask/overview.md
@@ -1,4 +1,4 @@
-!!! caution "Content disclaimer"
+!!! warning "Content disclaimer"
     Please view the third-party content disclaimer [here](https://github.com/0xPolygon/polygon-docs/blob/main/CONTENT_DISCLAIMER.md).
 
 [MetaMask](https://metamask.io/) is a crypto wallet for web browsers and mobile devices that interacts with the Ethereum blockchain. It allows you to run Ethereum dApps in your browser without running a full Ethereum node.
@@ -8,8 +8,8 @@
 - Ethereum connection: Infura 
 - Private key encoding: Mnemonic 
 
-!!! warning
-    - Backup your **Secret Recovery Phrase**. 
+!!! tip
+    - Backup your *Secret Recovery Phrase*. 
     - If your device breaks, is lost, stolen, or has data corruption, there is no other way to recover it. 
-    -The Secret Recovery Phrase is the only way to recover your MetaMask accounts. Check more **[Basic Safety and Security Tips for MetaMask](https://metamask.zendesk.com/hc/en-us/articles/360015489591-Basic-Safety-and-Security-Tips-for-MetaMask)**.
+    -The Secret Recovery Phrase is the only way to recover your MetaMask accounts. Check more [Basic Safety and Security Tips for MetaMask](https://metamask.zendesk.com/hc/en-us/articles/360015489591-Basic-Safety-and-Security-Tips-for-MetaMask).
 
diff --git a/mkdocs.yml b/mkdocs.yml
