docs: enhance content with clarifications and additional context

- Add links to Brasa and Fogo websites in home page
- Improve home page description for better clarity
- Add LST comparison examples (stETH, jitoSOL, mSOL, jupSOL) in stFOGO section
- Clarify "Fogo epoch" terminology throughout documentation
- Add Fogolend integration with link
- Enhance delegation strategy description (APY-adjusted basis)
- Simplify withdrawal fee security explanation
- Update terminology for lending use cases (cheaper borrowing, yield looping)
- Emphasize yield optimization benefits

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: bernatfp

content/index.mdx

@@ -7,8 +7,10 @@ description:
 
 # Welcome to Brasa Docs
 
-Brasa is a liquid staking protocol on Fogo that enables you to stake your FOGO
-tokens while maintaining liquidity through stFOGO.
+[Brasa](https://brasa.finance) is a liquid staking protocol on
+[Fogo](https://www.fogo.io/) that enables you to stake your FOGO tokens and earn
+staking rewards while staying liquid through stFOGO, so you can participate in
+DeFi and do more with your staked FOGO.
 
 ## What is Brasa?
 
@@ -17,6 +19,6 @@ Brasa is a liquid staking token (LST) protocol built on Fogo that allows you to:
 - **Stake** your FOGO and earn staking rewards
 - **Maintain liquidity** with transferable stFOGO tokens
 - **Use stFOGO in DeFi** to generate additional yield
-- **Trust institutional-grade security** with comprehensive audits
+- **Optimize your yield** through Brasa's delegation strategy
 
 Ready to learn more? Start with the [Overview](/overview).

content/overview/brasa-protocol.mdx

@@ -10,6 +10,7 @@ allowing you to:
 - **Earn staking rewards** without locking up your assets
 - **Use stFOGO in DeFi** to generate additional yield on top of staking rewards
 - **Maintain liquidity** while your FOGO continues earning rewards
+- **Optimize yield** through Brasa's active delegation strategy
 
 ## Liquid Staking
 
@@ -19,7 +20,7 @@ for other uses. Liquid staking solves this by issuing you a liquid token
 
 - Trade your staked position on decentralized exchanges
 - Use it as collateral in lending protocols
-- Provide liquidity in DeFi pools
+- Provide liquidity in DeFi pools for additional yield
 - Transfer it to other wallets
 
 All while your underlying FOGO continues earning staking rewards.
@@ -32,19 +33,20 @@ contributes to the network's security and decentralization.
 ### Delegation Strategy
 
 Brasa currently employs an equal distribution strategy across all
-well-performing validators in the network. This approach:
+well-performing (APY-adjusted basis) validators in the network. This approach:
 
 - Promotes network decentralization
 - Reduces concentration risk
 - Supports a diverse validator ecosystem
+- Delivers optimal staking yields
 
 ### Reserve Management
 
 To enable instant withdrawals, the protocol maintains a reserve of unstaked
 FOGO:
 
 - **Target**: 1% of total value locked (TVL)
-- **Rebalancing**: Automatically adjusted every epoch
+- **Rebalancing**: Automatically adjusted every Fogo epoch
 - **Epoch duration**: Currently 1 hour (subject to change as the network
   evolves)
 

content/overview/fees-unstaking.mdx

@@ -12,13 +12,13 @@ Withdraw directly from the protocol using the pool's reserves:
 - **Speed**: Instant
 - **Slippage**: None - you receive the exact exchange rate
 - **Capacity**: Limited to 1% of total pool value (TVL)
-- **Rebalancing**: Reserves are replenished every epoch to ensure sufficient
-  liquidity
+- **Rebalancing**: Reserves are replenished every Fogo epoch to ensure
+  sufficient liquidity
 - **Best for**: Quick exits when reserve capacity is available
 
 The 1% reserve is carefully maintained to balance instant liquidity with capital
 efficiency. After significant withdrawals, the reserve is automatically refilled
-during the next epoch rebalancing.
+during the next Fogo epoch rebalancing.
 
 ### 2. DEX
 
@@ -45,7 +45,7 @@ sustain protocol operations while keeping costs minimal for users.
 **10%** commission on staking rewards earned by the pool
 
 - Supports protocol development and maintenance
-- Covers validator infrastructure costs
+- Covers operational costs
 - Funds ongoing security audits and improvements
 - You still earn **90%** of all staking rewards
 
@@ -61,14 +61,8 @@ sustain protocol operations while keeping costs minimal for users.
 **0.2%** fee on withdrawals
 
 This small fee serves an important security function. Without it, attackers
-could exploit a timing edge case to extract yield from the pool:
-
-1. Deposit right before rewards are distributed
-2. Immediately withdraw after rewards are claimed
-3. Capture a portion of other users' rewards without staking
-
-The 0.2% withdrawal fee makes this attack economically unviable, protecting the
-pool and its participants. For more technical details, see the
+could exploit an edge case in the canonical SPL Stake Pool design that could
+allow them to extract yield from the pool. For more technical details, see the
 [SPL Stake Pool documentation on fees](https://www.solana-program.com/docs/stake-pool/fees#stake-deposit--withdraw).
 
 ## Summary

content/overview/stfogo.mdx

@@ -15,10 +15,11 @@ from Fogo validators.
 
 ### Auto-Compounding
 
-Unlike traditional staking tokens that maintain a 1:1 peg, stFOGO automatically
-accrues rewards, meaning its value increases over time relative to FOGO. Each
-stFOGO represents a share in the pool that steadily grows as staking yield is
-earned.
+Unlike traditional staking tokens that maintain a 1:1 peg (e.g. stETH on
+Ethereum), stFOGO automatically accrues rewards, meaning its value increases
+over time relative to FOGO (similar to how Solana LSTs like jitoSOL, mSOL or
+jupSOL work). Each stFOGO represents a share in the pool that steadily grows as
+staking yield is earned.
 
 For example:
 
@@ -52,11 +53,11 @@ Use stFOGO on DEXes such as [Valiant](https://valiant.trade) to:
 ### Lending Platforms
 
 Leverage stFOGO in lending protocols such as [Pyron](https://pyron.fi) and
-Fogolend to:
+[Fogolend](https://fogolend.com/) to:
 
-- **Borrow against stFOGO**: Use your stFOGO as collateral while your staking
+- **Cheaper FOGO borrowing**: Use your stFOGO as collateral so your staking
   yield offsets borrow costs
-- **Loop positions**: Borrow FOGO against stFOGO, stake it for more stFOGO, and
+- **Yield looping**: Borrow FOGO against stFOGO, stake it for more stFOGO, and
   repeat to amplify your staking yield exposure
 
 ### Future Integrations