docs: Revisions to /concepts/tokenomics pages (#24438)

## Description 

Describe the changes or additions included in this PR.

## Test plan 

How did you test the new or updated feature?

---

## Release notes

Check each box that your changes affect. If none of the boxes relate to
your changes, release notes aren't required.

For each box you select, include information after the relevant heading
that describes the impact of your changes that a user might notice and
any actions they must take to implement updates.

- [ ] Protocol: 
- [ ] Nodes (Validators and Full nodes): 
- [ ] gRPC:
- [ ] JSON-RPC: 
- [ ] GraphQL: 
- [ ] CLI: 
- [ ] Rust SDK:
- [ ] Indexing Framework:

---------

Co-authored-by: ronny-mysten <[email protected]>

Author: jessiemongeon1

docs/content/concepts.mdx

@@ -35,7 +35,7 @@ Sui introduces innovative approaches to blockchain architecture and development.
 <Card title="Staking and Unstaking" href="/concepts/tokenomics/staking-unstaking"/>
 <Card title="Gas Fees" href="/concepts/tokenomics/gas-in-sui"/>
 <Card title="SUI Bridging" href="/concepts/tokenomics/sui-bridging"/>
-<Card title="Vesting Strategies" href="/concepts/tokenomics/vesting-strategies"/>
+<Card title="Vesting Strategies" href="/guides/developer/coin/vesting-strategies"/>
 </Cards>
 
 ## Object Model

docs/content/concepts/gaming.mdx

@@ -213,7 +213,7 @@ Ongoing distribution refers to staking and vesting of GameFi tokens. Not all gam
 - Rewards active participants in the ecosystem.
 - Rewards team members over the course of their involvement. 
 
-To learn more about token vesting strategies, see [Token Vesting Strategies](./tokenomics/vesting-strategies.mdx).
+To learn more about token vesting strategies, see [Token Vesting Strategies](/guides/developer/coin/vesting-strategies.mdx).
 
 When deciding how best to launch your tokens, it's important to consider some key points:
 

docs/content/concepts/tokenomics.mdx

@@ -4,23 +4,30 @@ description: Staking and unstaking SUI with validators earns a percentage of rew
 keywords: [ token staking, token unstaking, SUI staking, SUI unstaking, unstake SUI, stake SUI, validator staking, validator unstaking ]
 ---
 
-Sui uses a Delegated-Proof-of-Stake (DPoS) system to secure and operate the network, meaning that the voting power of a validator in the network is determined by the amount of stake delegated to them by SUI token holders. The more stake delegated to a validator, the more voting power they have. In exchange for processing transactions and performing consensus, validators earn rewards based on the amount of gas fees collected. These rewards are then shared among stakers as staking rewards.
+Sui uses a delegated proof of stake (DPoS) [consensus mechanism](/concepts/sui-architecture/consensus.mdx) to secure and operate the network, meaning that the voting power of a [validator](/guides/operator/validator-index.mdx) in the network is determined by the amount of stake delegated to them by SUI token holders. The more stake delegated to a validator, the more voting power they have. In exchange for processing transactions and providing resources to the network, validators earn rewards based on the amount of gas fees collected. These rewards are then shared among stakers as [staking rewards](/guides/operator/validator/validator-rewards.mdx).
 
 ## Staking
 
-You stake your SUI tokens by sending a transaction to the network that calls the staking function implemented as part of the system Move package. This transaction wraps the SUI tokens in a self-custodial stake object. This stake object contains information including the validator staking pool ID and the activation epoch of the stake. With the introduction of [SIP-6](https://blog.sui.io/liquid-staking-coming-sui/), you can participate in liquid staking protocols using your staked objects.
+Stake SUI tokens by sending a transaction to the network that calls the <a href="/references/framework/sui_sui_system/staking_pool#sui_system_staking_pool_request_add_stake" data-noBrokenLinkCheck='true'>staking function</a> implemented as part of the <a href="/references/framework/sui_sui_system/staking_pool" data-noBrokenLinkCheck='true'>system Move package</a>. This transaction wraps the SUI tokens in a self-custodial stake [object](/concepts/object-model.mdx). This stake object contains information including the validator staking pool ID and the activation [epoch](/concepts/sui-architecture/epochs.mdx) of the stake. With the introduction of [SIP-6](https://blog.sui.io/liquid-staking-coming-sui/), you can participate in liquid staking protocols using your staked objects.
 
-Sui-compatible crypto wallets typically have functionality to initiate staking and unstaking from your Sui address. See the respective documentation for these tools to begin staking your SUI.
+[Sui-compatible crypto wallets](https://slush.app/) typically have functionality to initiate staking and unstaking from your Sui address. See the respective documentation for these tools to begin staking your SUI.
 
 ## Unstaking
 
-Similar to staking, a user withdraws stake from a validator by sending a transaction that calls the unstaking function in the system Move package. This transaction unwraps the stake object, and sends both the principal and the accumulated rewards to the user as SUI tokens. You accrue rewards only during epochs where the stake is active for the entire epoch. The rewards withdrawn from the validator's rewards pool are calculated based on the activation epoch and unstaking epoch of the stake.
+Similar to staking, a user withdraws stake from a validator by sending a transaction that calls the <a href="/references/framework/sui_sui_system/staking_pool#sui_system_staking_pool_request_withdraw_stake" data-noBrokenLinkCheck='true'>unstaking function</a> in the <a href="/references/framework/sui_sui_system/staking_pool" data-noBrokenLinkCheck='true'>system Move package</a>. This transaction unwraps the stake object, and sends both the principal and the accumulated rewards to the user as SUI tokens. You accrue rewards only during epochs where the stake is active for the entire epoch. The rewards withdrawn from the validator's rewards pool are calculated based on the activation epoch and unstaking epoch of the stake.
 
 ## Choosing a validator for staking
 
-When you stake on Sui, you have to choose a specific validator you would like to stake with. The choice of validator can potentially impact the amount of staking rewards you receive. The factors determining this amount include, but are not limited to:
+You must choose a specific validator you would like to stake your SUI in. The choice of validator can potentially impact the amount of staking rewards you receive. The factors determining this amount include, but are not limited to:
 
-- Validator commission rate: a validator can choose to set a non-zero commission rate specifying the percentage of staking rewards they are taking from the stakers. For example, if a validator has a commission rate of 10%, then 10% of every staker's staking rewards is given to the validator. Understand that a validator can choose its commission at a future moment in time without prior notice.
-- Validator performance: a validator with bad performance might be punished according to the [tallying rule](./gas-in-sui.mdx#tallying-rule). Punished validators do not receive any staking rewards for the epoch during which they are punished, and you also do not receive that epoch's rewards when you withdraw your stake from that validator. 
+- **Validator commission rate**: A validator can choose to set a non-zero commission rate specifying the percentage of staking rewards they are taking from the stakers. For example, if a validator has a commission rate of 10%, then 10% of every staker's staking rewards is given to the validator. 
 
-Sui-compatible crypto wallets and explorers typically provide validator information such as commission and APY. See the respective documentation for these tools for information on how to retrieve this data.
+:::caution 
+
+A validator can choose its commission at a future moment in time without prior notice.
+
+:::
+
+- **Validator performance**: A validator with bad performance might be punished according to the [tallying rule](/concepts/tokenomics/gas-in-sui.mdx#tallying-rule). Punished validators do not receive any staking rewards for the epoch during which they are punished, and you also do not receive that epoch's rewards when you withdraw your stake from that validator.
+
+Sui-compatible crypto wallets and [explorers](https://suiscan.xyz/mainnet/home) typically provide validator information such as commission and APY. See the respective documentation for these tools for information on how to retrieve this data.