Expanded README.md to provide insight into each section and make it a bit more welcoming. Updted some page titles and references in SUMMARY.md to make them user friendly. Example - Data Farming 101

SUMMARY.md

@@ -55,10 +55,10 @@
   * [Projects using Ocean Protocol](building-with-ocean/projects-using-ocean.md)
 * [veOCEAN & Data Farming](veocean-data-farming/README.md)
   * [veOCEAN](veocean-data-farming/veocean.md)
-  * [Data Farming Intro](veocean-data-farming/df-intro.md)
-  * [Data Farming Advanced](veocean-data-farming/df-details.md)
+  * [Data Farming 101](veocean-data-farming/df-intro.md)
+  * [Data Farming Background](veocean-data-farming/df-background.md)
   * [Emissions & APYs](veocean-data-farming/emissions-apys.md)
-  * [Contracts & Formuls](veocean-data-farming/contracts-formulas.md)
+  * [Contracts & Formulas](veocean-data-farming/contracts-formulas.md)
   * [FAQ](veocean-data-farming/faq.md)
 * [Tutorials](tutorials/veOcean-Data-Farming-Tutorial.md)
 * [API References](api-references/README.md)

veocean-data-farming/README.md

@@ -1 +1,36 @@
-# veOCEAN & Data Farming
+---
+description: An overview of Ocean Protocol's governance and incentives mechanisms
+---
+# veOCEAN & Data Farming
+
+veOCEAN is a fork of veCRV, and enables you to become a governance participant, eligible to receive rewards and engage with different protocol mechanisms.
+
+The following docs should provide you with sufficient intuition to access, utilize, and build upon the protocol's core incentive and reward system: Data Farming.
+
+![](./images/df_rewards_page.png)
+
+## veOCEAN
+
+Learning about [veOCEAN](veocean.md) will help you answer the question `"What can I do with my veOCEAN?"` and give you insights on how to access the reward programs.
+
+It will teach you everything you need to know about why it exists and how it works.
+
+## Data Farming
+
+[Data Farming 101](df-intro.md) will teach you about the different reward systems, how they work, and how to access them. You will become proficient and understand them in detail.
+
+[Data Farming Background](df-background.md) will provide you with more intuitions about Data Farming, the Reward Function, and the evolution of the program over time.
+
+## Further Reading
+
+Finally, if you want to continue expanding your knowledge on OCEAN token emissions, APY studies, and specific formulas on key numbers that are reported, you can read the following sections:
+
+[Emissions & APYs](emissions-apys.md) will provide you will information about how OCEAN will be released over time through the Data Farming program and provide you with APY studies.
+
+[Contracts & Formulas](contracts-formulas.md) guides you to where the contracts are deployed, and will break down every number in our ecosystem and how they are calculated.
+
+Our [FAQ](faq.md) is 
+
+## Reference
+
+All content within has been assembled via reference of the (Ocean Data Farming Series)[https://blog.oceanprotocol.com/ocean-data-farming-series-c7922f1d0e45], official (Ocean Protocol github repositories)[https://github.com/oceanprotocol/], and [v4 Whitepapers](https://oceanprotocol.com/tech-whitepaper.pdf).

veocean-data-farming/df-background.md

@@ -1,9 +1,14 @@
 ---
-description: Granular details on the Data Farming program.
+description: Intuition and background on the Data Farming program.
 ---
+# Data Farming Background
+
+It rewards OCEAN to liquidity providers (stakers) as a function of consume volume and liquidity. It’s like DeFi liquidity mining, but tuned for data consumption. DF’s aim is to achieve a minimum supply of data for network effects to kick in, and once the network flywheel is spinning, to increase growth rate.
+
+
 ## Active Work to Drive APY
 
-Data Farming is not a wholly passive activity. The name of the game is to drive data consume volume (DCV). High APYs happen only when there is sufficiently high DCV. High DCV means publishing and consuming truly useful datasets (or algorithms).
+Data Farming is not a wholly passive activity. The name of the game is to drive Data Consume Volume (DCV). High APYs happen only when there is sufficiently high DCV. High DCV means publishing and consuming truly useful datasets (or algorithms).
 
 Thus, if you really want to max out your APY:
 - create & publish datasets (and make $ in selling them) — or work with people who can

veocean-data-farming/df-intro.md

@@ -1,11 +1,11 @@
 ---
-description: An introduction to Data Farming and Ocean's core incentive streams.
+description: An introduction to Data Farming and Ocean Protocol's key incentives.
 ---
-# Data Farming & Rewards
+# Data Farming 101
 
 Data Farming (DF) incentivizes for growth of Data Consume Volume (DCV) in the Ocean ecosystem.
 
-It rewards OCEAN to pool liquidity providers (stakers) as a function of consume volume and liquidity. It’s like DeFi liquidity mining, but tuned for data consumption. DF’s aim is to achieve a minimum supply of data for network effects to kick in, and once the network flywheel is spinning, to increase growth rate.
+It rewards OCEAN to liquidity providers (stakers) as a function of consume volume and liquidity. It’s like DeFi liquidity mining, but tuned for data consumption. DF’s aim is to achieve a minimum supply of data for network effects to kick in, and once the network flywheel is spinning, to increase growth rate.
 
 ## Reward Categories
 Rewards are paid in OCEAN and distributed every week on Thursday as follow:
@@ -14,7 +14,7 @@ Rewards are paid in OCEAN and distributed every week on Thursday as follow:
 | ---- | ------- |
 | 50%    | 50%    |
 
-Active Rewards are governed and defined by the [Reward Function](df-details.md#reward-function).
+Active Rewards are governed and defined by the [Reward Function](df-background.md#reward-function).
 
 **Final Caveat:** We reserve the right to make reasonable changes to these plans, if unforeseen circumstances emerge.
 
@@ -82,4 +82,10 @@ We explored dozens of possible ways to do it. In the end, we arrived at this app
 
 For Data Farming, we want to incentivize publishers to create more data sets, build more token-gated product, innovate how builders can consume Data-tokens.
 
-*All the veOCEAN a publisher has allocated to an asset they’ve published (“staked”) is treated as 2x the stake for rewards calculation.*
+*All the veOCEAN a publisher has allocated to an asset they’ve published (“staked”) is treated as 2x the stake for rewards calculation.*
+1. As a staker, due to their staked veOCEAN on their own assets (1x).
+1. As a publisher, for having veOCEAN staked on their own asset(1x).
+
+The final reward is then calculated and bundled together to be distributed.
+
+You can read more about the implementation [in this blog post](https://blog.oceanprotocol.com/data-farming-publisher-rewards-f2639525e508).

veocean-data-farming/veocean.md

@@ -15,12 +15,12 @@ After creating your lock you will be credited veOCEAN. We sometimes refer to veO
 
 ## What can I do with veOCEAN?
 
-veOCEAN allows you to engage with the protocol and benefit from the reward programs available.
+veOCEAN allows you to engage with different protocol mechanisms and benefit from the reward programs available.
 
 There are 4 things you can do with veOCEAN.
 1. **Hold it** veOCEAN pays **Passive Rewards** every week.
 2. **Allocate it** veOCEAN pays **Active Rewards** every week to the top performing Datasets, Algorithms, dApps, and more.
-3. **Delegate it** You can delegate veOCEAN to other Data Farmers who can curate Datasets for you. In return for their services, these farmers may charge you a fee for helping you receive APY on **Active Rewards**. The Delegate feature has just been recently released and enables veOCEAN holders to more easily access rewards. 
+3. **Delegate it** You can delegate veOCEAN to other Data Farmers who can curate Datasets for you. In return for their services, these farmers may charge you a fee for helping you receive APY on **Active Rewards**. The Delegate feature has just been recently released and enables veOCEAN holders to more easily access Active Rewards.
 4. **2x Stake** If you are a publisher, allocating veOCEAN to your own Dataset gives your veOCEAN a 2x Bonus. This is an incentive for publishers to engage with their assets and benefit from from the protocol further.
 
 ## What is time locking?
@@ -102,8 +102,6 @@ The veOCEAN design is in accordance with the Web3 Sustainability Loop, which Oce
 
 The veOCEAN code was forked from the veCRV code. veCRV parameters will be the starting point. To minimize risk, tweaks will be circumspect.
 
-This is the current design. We expect changes based on feedback from the community, and learnings during implementation.
-
 ## Security
 
 [veOCEAN core contracts](https://github.com/oceanprotocol/contracts/tree/main/contracts/ve) use [veCRV contracts](https://curve.readthedocs.io/dao-vecrv.html) with zero changes, on purpose: the veCRV contracts have been battle-tested for two years and have not had security issues.