Update Delegation Page

Author: MichaelMacaulay

website/pages/en/resources/glossary.mdx

@@ -22,6 +22,8 @@ title: Glossary
 
 - **Indexer's Self-Stake**: The amount of GRT that Indexers stake to participate in the decentralized network. The minimum is 100,000 GRT, and there is no upper limit.
 
+- **Delegation Capacity**: The maximum amount of GRT an Indexer can accept from Delegators. Indexers can only accept up to 16x their Indexer Self-Stake. Additional delegation results in diluted rewards. For example, if an Indexer has a Self-Stake of 1m GRT, their delegation capacity is 16m. Indexers can increase their Delegation Capacity by increasing their Indexer's Self-Stake.
+
 - **Upgrade Indexer**: An Indexer designed to act as a fallback for subgraph queries not serviced by other Indexers on the network. The upgrade Indexer is not competitive with other Indexers.
 
 - **Delegator**: Network participants who own GRT and delegate their GRT to Indexers. This allows Indexers to increase their stake in subgraphs on the network. In return, Delegators receive a portion of the Indexing Rewards that Indexers receive for processing subgraphs.

website/pages/en/resources/roles/delegating.mdx

@@ -2,17 +2,44 @@
 title: Delegating
 ---
 
-Delegators are network participants who delegate (i.e., "stake") GRT to one or more Indexers.
+# Delegating GRT on The Graph Network
 
-- They help secure the network without running a Graph Node themselves.
+Delegators play a crucial role on The Graph Network by delegating GRT to Indexers. This process supports network security and functionality without requiring Delegators to run a Graph Node.
 
-- They earn a portion of an Indexer's query fees and rewards by delegating to them.
+## Benefits of Delegating
 
-## How does this work?
+- Strengthen the network’s security and scalability by supporting Indexers.  
+- Earn a portion of rewards generated by the Indexers.
 
-The number of queries an Indexer can process depends on their own stake, **the delegated stake**, and the price the Indexer charges for each query. Therefore, the more stake allocated to an Indexer, the more potential queries an Indexer can process.
+## How Does Delegation Work?
 
-## Delegator Guide
+An Indexer's ability to process queries and earn rewards depends on three key factors:  
+
+1. The Indexer's Self-Stake (GRT staked by the Indexer).  
+2. The total GRT delegated to them by Delegators.  
+3. The price the Indexer sets for queries.
+
+The more GRT staked and delegated to an Indexer, the more queries they can serve, leading to higher potential rewards.
+
+### What is Delegation Capacity?
+
+Delegation Capacity refers to the maximum amount of GRT an Indexer can accept from Delegators, based on the Indexer's Self-Stake.
+
+The Graph Network includes a delegation ratio of 16, meaning an Indexer can accept up to 16 times their Self-Stake in delegated tokens.
+
+For example, if an Indexer has a Self-Stake of 1m GRT, their delegation capacity is 16m.
+
+### Why Does Delegation Capacity Matter?
+
+If an Indexer exceeds their Delegation Capacity, rewards for all Delegators become diluted because the excess delegated GRT cannot be used effectively within the protocol.
+
+This makes it crucial for Delegators to evaluate an Indexer's current Delegation Capacity before selecting an Indexer.
+
+Indexers can increase their Delegation Capacity by their Self-Stake, thereby raising the limit for delegated tokens.
+
+## What Delegators Need to Know
+
+<VideoEmbed youtube="xcegvXxgR4Y" />
 
 Learn how to be an effective Delegator in The Graph Network.
 
@@ -24,13 +51,13 @@ There are three sections in this guide:
 
 - The risks of delegating tokens in The Graph Network
 - How to calculate expected returns as a Delegator
-- A video guide showing the steps to delegate in the Graph Network UI
+- A video guide explaining
 
 ## Delegation Risks
 
 Listed below are the main risks of being a Delegator in the protocol.
 
-### The delegation tax
+### The Delegation Tax
 
 Delegators cannot be slashed for bad behavior, but there is a tax on Delegators to disincentivize poor decision-making that could harm the integrity of the network.
 
@@ -40,9 +67,13 @@ As a Delegator, it's important to understand the following:
 
 - In order to be safe, you should calculate your potential return when delegating to an Indexer. For example, you might calculate how many days it will take before you have earned back the 0.5% tax on your delegation.
 
-### The delegation unbonding period
+### The Delegation Unbonding Period
+
+Whene a Delegator chooses to undelegate, their tokens are subject to a 28-day unbonding period.
 
-Whenever a Delegator wants to undelegate, their tokens are subject to a 28-day unbonding period. This means they cannot transfer their tokens or earn any rewards for 28 days.
+This means they cannot transfer their tokens or earn any rewards for 28 days.
+
+After the unbonding period, GRT will return to your crypto wallet.
 
 ### Why is this important?
 
@@ -125,13 +156,6 @@ Therefore, a Delegator should always consider the Delegation Capacity of an Inde
 
 At times, attempts to delegate to Indexers via MetaMask can fail and result in prolonged periods of "Pending" or "Queued" transaction attempts.
 
-#### Example
-
-Let's say you attempt to delegate with an insufficient gas fee relative to the current prices.
-
-- This action can cause the transaction attempt to display as "Pending" in your MetaMask wallet for 15+ minutes. When this happens, you can attempt subsequent transactions, but these will only be processed until the initial transaction is mined because transactions for an address must be processed in order.
-- In such cases, these transactions can be cancelled in MetaMask, but the transactions attempts will accrue gas fees without any guarantee that subsequent attempts will be successful.
-
 A simple resolution to this bug is to restart the browser (e.g., using "abort:restart" in the address bar), which will cancel all previous attempts without gas being subtracted from the wallet. Several users who have encountered this issue have reported successful transactions after restarting their browser and attempting to delegate.
 
 ## Video Guide