Rewriting df-docs.md files so they are more self-descriptive... starting to fix poor linking, enriching the right pages, and improving references...

.gitbook.yaml

@@ -56,7 +56,7 @@ redirects:
     veocean-data-farming: rewards/README.md
     veocean-data-farming/veocean: rewards/df-veocean.md
     veocean-data-farming/df-intro: rewards/df-intro.md
-    veocean-data-farming/df-background: rewards/df-max-out-yield.md
+    veocean-data-farming/df-background: rewards/df-volumedf.md.md
     veocean-data-farming/emissions-apys: rewards/df-emissions-apys.md
     veocean-data-farming/delegation: rewards/README.md
     rewards/veOcean-Data-Farming-Tutorial: user-guides/data-farming/how-to-veocean.md

SUMMARY.md

@@ -119,8 +119,8 @@
 * [💰 Data Farming](rewards/README.md)
   * [Farming 101](rewards/df-intro.md)
   * [veOCEAN](rewards/df-veocean.md)
-  * [Curate Data](rewards/df-max-out-yield.md)
-  * [Prediction Challenges](rewards/df-challenges.md)
+  * [Curate Data](rewards/df-volumedf.md.md)
+  * [Prediction Challenges](rewards/df-challengedf.md)
   * [Complete User Guides](rewards/df-guides.md)
   * [Emissions & APYs](rewards/df-emissions-apys.md)
 * [🤝 Contribute](contribute/README.md)

discover/explore.md

@@ -114,7 +114,7 @@ Furthermore, provider fees are not restricted to data consumption; they can also
 
 <details>
 
-<summary><mark style="color:purple;">Earn Rewards</mark><br><br>The <a href="../rewards/df-max-out-yield.md">Data Farming</a> initiative is a key feature of Ocean Protocol that empowers participants to earn <a href="../rewards/">rewards</a> while contributing to a decentralized data economy. By staking Ocean tokens and actively participating in data markets, users play a vital role in enhancing the availability and accessibility of valuable data assets</summary>
+<summary><mark style="color:purple;">Earn Rewards</mark><br><br>The <a href="../rewards/df-volumedf.md.md">Data Farming</a> initiative is a key feature of Ocean Protocol that empowers participants to earn <a href="../rewards/">rewards</a> while contributing to a decentralized data economy. By staking Ocean tokens and actively participating in data markets, users play a vital role in enhancing the availability and accessibility of valuable data assets</summary>
 
 Through the Data Farming initiative, you are incentivized to lock Ocean tokens for [veOcean](../rewards/df-veocean.md). By staking your tokens, you not only support the growth and sustainability of the ecosystem but also earn a share of the generated incentives💰. The Data Farming initiative offers participants a unique opportunity to earn [rewards](../rewards/README.md) while making a meaningful impact in the data marketplace.
 

discover/faq.md

@@ -206,7 +206,7 @@ Checkout our [roadmap](https://oceanprotocol.com/technology/roadmap) to see what
 
 <summary>What assets are eligible for Data Farming?</summary>
 
-The data asset may be of any type — dataset (for static URIs), algorithm for Compute-to-Data, or any other Datatoken token-gated system. The data asset may be fixed price or free price. You can find more details in the [DF Background page](../rewards/df-max-out-yield.md#assets-that-qualify-for-data-farming)
+The data asset may be of any type — dataset (for static URIs), algorithm for Compute-to-Data, or any other Datatoken token-gated system. The data asset may be fixed price or free price. You can find more details in the [DF Background page](../rewards/df-volumedf.md.md#assets-that-qualify-for-data-farming)
 
 </details>
 

rewards/README.md

@@ -27,7 +27,7 @@ veOCEAN is a fork of veCRV. This enables participants to become a governance del
 
 [Farming 101](df-intro.md) introduces the different reward systems, how they work, and how to access them. By the end of the page, you should be more familiar with how Data Farming works and able to take next steps to curate assets.
 
-[Data Farming Background](df-max-out-yield.md) will provide you with more intuitions about Data Farming, briefly explain the Reward Function, and how the program evolved over time.
+[Data Farming Background](df-volumedf.md.md) will provide you with more intuitions about Data Farming, briefly explain the Reward Function, and how the program evolved over time.
 
 ## Delegation
 

rewards/df-challengedf.md

@@ -1,18 +1,17 @@
 ---
 description: >-
-  If you are a data scientist or simply enthusiastic about extracting value from datasets 📊, we have an exciting opportunity waiting for you! Not only will you gain valuable insights and knowledge, but you'll also have the chance to compete for enticing weekly rewards. However, keep in mind that these rewards must be earned by competing with other participants! 🏆
+  Weekly prediction challenges for data scientists to compete, launch algorithms, and start earning. 🏆
 ---
 
-# Participage in Data Farming Challenges (Red Belt)
+# Participage in ChallengeDF
 
 <figure><img src="../.gitbook/assets/rewards/gif/eat-data.gif" alt=""><figcaption><p>Let's consume some data.</p></figcaption></figure>
 
-## Get extra rewards by competing in data challenges!
+## Get extra rewards by competing in prediction challenges!
 
 If you're eager to consume data and create valuable assets for publishing but unsure of where to begin, fear not! We've got you covered.
 
-Data Farming offers rewards to data scientists who participate in weekly challenges.
-We provide the rules and rewards, allowing you to focus on delivering high-quality results. With challenges taking place on a weekly basis, there's always an opportunity for you to join in, so you're never too late to get started.
+Data Farming offers rewards to data scientists who participate in weekly challenges. We provide the rules and rewards, allowing you to focus on delivering high-quality results. With challenges taking place on a weekly basis, there's always an opportunity for you to join in, so you're never too late to get started.
 
 ### What are the base rules?
 
@@ -23,7 +22,7 @@ We provide the rules and rewards, allowing you to focus on delivering high-quali
 
 ### What do I gain from this?
 
-- Earn OCEAN rewards.
+- Earn OCEAN rewards, [claimable inside our app](https://df.oceandao.org/rewards)
 - Gain in-depth knowledge of the Ocean Protocol stack.
 - Increase your visibility by achieving a place on the podium.
 - Create valuable assets that can be monetized on the Ocean Marketplace.
@@ -31,7 +30,7 @@ We provide the rules and rewards, allowing you to focus on delivering high-quali
 
 ### Where to start?
 
-Head over to the [Data Farming dapp](https://df.oceandao.org/rewards) and explore the new **ChallengeDF substream** section, which is now part of the Active Rewards. The dapp itself will serve as your guide moving forward!
+Head over to the [Challenges Page](https://df.oceandao.org/challenges) to learn more about ChallengeDF, and see previous results.
 
 If you're looking for a step-by-step guide on everything from understanding what a challenge entails to claiming your well-deserved rewards, be sure to check out [how to farm ChallengeDF rewards](../user-guides/data-farming/how-to-challengedf.md) section. It will provide you with all the necessary information you need to make the most out of the challenges.
 

rewards/df-intro.md

@@ -54,7 +54,7 @@ VolumeDF rewards Data Farmers that allocate their veOCEAN tokens to Ocean ecosys
 
 You can visit the follow tutorial learn how to [access VolumeDF](../user-guides/data-farming/how-to-volumedf.md)
 
-VolumeDF rewards are governed and defined by the [Reward Function](df-max-out-yield.md#reward-schedule).
+VolumeDF rewards are governed and defined by the [Reward Function](df-volumedf.md.md#reward-schedule).
 
 #### What is ChallengeDF
 

rewards/df-volumedf.md

@@ -1,7 +1,6 @@
 ---
 description: >-
-  If you've gotten this far, then you're half way to becoming a pro in
-  Ocean Protocol's Data Farming dApp!
+  If you've gotten this far, then you're half way to becoming a pro in Ocean Protocol's Data Farming dApp!
 ---
 
 # Mastering VolumeDF

user-guides/data-farming/how-to-estimate-apy.md

@@ -37,6 +37,6 @@ Having said this, we do provide a thorough dashboard that provides historical an
 
 <figure><img src="../../.gitbook/assets/rewards/curate-datasets.png" alt=""><figcaption><p>Curate like a Pro.</p></figcaption></figure>
 
-You can also [learn how rewards are calculated here](../rewards/df-max-out-yield.md#how-rewards-are-calculated) to understand more about what's happening behind the scenes of each Data Farming round.
+You can also [learn how rewards are calculated here](../rewards/df-volumedf.md.md#how-rewards-are-calculated) to understand more about what's happening behind the scenes of each Data Farming round.
 
 Finally, you can [review the implementation inside df-web](https://github.com/oceanprotocol/df-web/blob/main/src/utils/rewards.js) to understand how APYs are calculated at the frontend/UI level.