Review docs (Intro; Protocol; Governance; OPTY)

intro/how-optyfi-works.md

@@ -5,12 +5,12 @@ The OptyFi Protocol continuously monitors DeFi activity, predicting the yield of
 The yield optimization model proceeds as follows:
 
 1. **Dynamic Strategy Generation:** Strategies are dynamically composed based on the integrated protocols and blockchains.
-2. **Optimization Engine:** Constantly monitors changing conditions across DeFi pools and scores the universe of possible strategies.
+2. **Optimization Engine:** DeFi pools are constantly monitored, where the plethora of possible strategies are evaluated according to changing conditions.
 3. **Strategy Execution Engine:** Smart contracts can execute any valid yield strategy \(across integrated protocols/blockchains\) while enforcing risk constraints.
 4. **Automated Vaults:** Vault assets are automatically and continuously routed to the most optimal strategy.
 5. **Modular Design:** Specialist vaults optimize a single type of asset providing optimal yield for a specific risk level. Portfolio vaults allocate assets across specialist vaults, diversifying risk and providing optimal asset allocation.   
 
 ![OptyFi vault assets will be routed across multiple pools and protocols in real time.](../.gitbook/assets/how-it-works.svg)
 
-Capital never stays idle with OptyFi.
+By combining these elements together into a working application, OptyFi ensures capital to never stay idle.
 

intro/join-the-community.md

@@ -2,17 +2,17 @@
 
 The best way to get involved with OptyFi is to join our growing community of builders and users committed to risk-adjusted capital efficiency in DeFi. You can start by joining one or more of our community channels.
 
-### [Forum](https://forum.opty.fi)
+### [Discord](https://discord.gg/kVxKHUEpy8)
 
-Join our forum for discussions on product development, feature requests, OPTY tokenomics, and other topics.
+This is our most active community channel and the best place to learn and contribute to OptyFi.
 
-### [Discord](https://discord.gg/kVxKHUEpy8)
+### [Forum](https://forum.opty.fi)
 
-This is our most active community channel and where you can learn and contribute the most to OptyFi.
+Discuss product development, feature requests, OPTY tokenomics, and other topics by joining our Forum.
 
 ### [Twitter](https://twitter.com/optyfi)
 
-Follow us on Twitter for announcements and updates.
+Hear first about announcements and updates by following us on Twitter.
 
 ### [Medium](https://medium.com/optyfi)
 
@@ -21,4 +21,3 @@ Enjoy and stay up-to-date with our in-house research and content by following ou
 ### [GitHub](https://github.com/opty-fi)
 
 Review and contribute to our open-source code repository on GitHub.
-

intro/welcome-to-optyfi.md

@@ -2,7 +2,7 @@
 
 The OptyFi Protocol provides simplified access to optimized yield across DeFi.
 
-The Protocol ****evaluates thousands of yield strategies across hundreds of liquidity pools, dozens of protocols and multiple blockchains. OptyFi optimizes capital as assets deposited into vaults are continuously deployed into the most profitable strategies based on predefined risk profiles and preferences.
+The Protocol evaluates thousands of yield strategies across hundreds of liquidity pools, dozens of protocols and multiple blockchains. OptyFi optimizes capital deposited into vaults which function as assets that are continuously deployed into the most profitable strategies. Strategies are determined based on predefined risk profiles and preferences.
 
 This document aims to provide an overview of OptyFi including:
 

intro/why-optyfi.md

@@ -4,7 +4,7 @@
 
 Yield was the "killer application" that brought DeFi to the world's attention. But we are still at a very early stage. 
 
-The current status of DeFi yield consists of fragmented yield aggregation apps with hand-picked and inflexible yield strategies. Until DeFi is able to offer a user experience and technical sophistication comparable to TradFi, we will not achieve mainstream \(retail or institutional\) adoption.   
+The current status of DeFi yield consists of fragmented yield aggregation apps with hand-picked and inflexible yield strategies. Until DeFi is able to offer a user experience and technical sophistication comparable to TradFi, it will not achieve mainstream \(retail or institutional\) adoption.   
 
 OptyFi aims to deliver the user experience and technical sophistication of traditional asset management while preserving the ground-breaking advantages of decentralization. 
 

protocol/optyfi-protocol/README.md

@@ -1,12 +1,9 @@
 # The OptyFi Protocol
 
-The OptyFi Protocol approaches DeFi yield from a first principles perspective.  
-
-Starting with an abstracted view of liquidity pools, we define yield [strategy steps](strategy-composition.md#strategy-step) which can be combined in [sequence](strategy-composition.md#strategy-sequence) into yield strategies, which in turn can be combined in parallel into yield portfolios. The universe of possible strategies form a directed [Strategy Graph](strategy-composition.md#strategy-graph), and executing a yield strategy can be conceptualized as traversing this Strategy Graph. 
-
-Users deposit their assets into OptyFI vaults, from where these assets are continuously deployed into optimal strategies that match the [risk profile](risk-framework.md#risk-profiles) of the vault.
-
-[Strategy Execution](strategy-execution.md) contracts are able to execute any arbitrary multi-step strategy while enforcing [risk constraints](risk-framework.md). The [Optimization Engine](optimization-engine.md) continuously monitors thousands of data points across hundreds of liquidity pools in order to recommend the current optimal strategy to vaults.  
+The OptyFi Protocol approaches DeFi yield from a [first principles perspective](https://fs.blog/first-principles/).  
 
+Starting with an abstract view on liquidity pools, we define yield [strategy steps](strategy-composition.md#strategy-step), which are [sequentially combined](strategy-composition.md#strategy-sequence) into yield strategies. Multiple yield strategies can in turn be combined in parallel to obtain yield portfolios. The plethora of possible strategies form a directed [Strategy Graph](strategy-composition.md#strategy-graph), and executing a yield strategy can be conceptualized as traversing this Strategy Graph. 
 
+Users deposit their assets into OptyFi vaults. These vaults function as a liquidity pool from which assets are continuously deployed into optimal strategies that match the [risk profile](risk-framework.md#risk-profiles) of the vault.
 
+[Strategy Execution](strategy-execution.md) contracts are able to execute any arbitrary multi-step strategy while enforcing [risk constraints](risk-framework.md). The [Optimization Engine](optimization-engine.md) continuously monitors thousands of data points across hundreds of liquidity pools in order to recommend the current optimal strategy to vaults.

protocol/optyfi-protocol/optimization-engine.md

@@ -1,23 +1,22 @@
 # Optimization Engine
 
-DeFi is known to be volatile and DeFi yield markets are significantly inefficient. This means that the yields \(and risk\) of liquidity pools change continuously even for pools with the same underlying asset. The composability of DeFi protocols allows assets to be exchanged for "derivative assets" \(e.g. DAI for cDAI\) creating more potential volatility. 
+DeFi is known to be volatile and DeFi yield markets are significantly inefficient. This means that the yields \(and risk\) of liquidity pools change continuously, even for pools with the same underlying assets. The composability of DeFi protocols allows assets to be exchanged for "derivative assets" \(e.g. DAI for cDAI\), creating more potential volatility. 
 
-OptyFi is designed to allow continuous discovery of the most optimal yield strategies. Since this requires evaluation of multiple blocks of data from hundreds of liquidity pools, initially OptyFi's Optimization Engine is designed as an off-chain process that "recommends" the optimal strategy to each vault. [Strategy Execution](strategy-execution.md) smart contracts are responsible for executing this strategy, ensuring it includes only approved pools and enforcing risk constraints of the vault.
+OptyFi is designed to allow continuous discovery of the most optimal yield strategies. Since this requires evaluation of multiple blocks of data from hundreds of liquidity pools, OptyFi's Optimization Engine is initially designed as an off-chain process that "recommends" the optimal strategy for each vault. [Strategy Execution](strategy-execution.md) smart contracts are responsible for executing this strategy, ensuring it includes only approved pools and enforcing risk constraints of the vault.
 
 ![How the OptyFi optimization engine works.](../../.gitbook/assets/optimization-engine%20%281%29.svg)
 
 ## Implementation
 
-The Optimization Engine is implemented in a custom developed python library Opty.py which will be open-sourced and shared with the community. Key functions include:   
+The Optimization Engine is implemented in a custom python library (Opty.py) developed by the OptyFi team. This library will be open-sourced and shared with the community. Key functions include:   
 
-| Component | Function |
+| **Component** | **Function** |
 | :--- | :--- |
-| **getPoolData** | Fetches liquidity pool data from the OptyFi API server. Currently, automated jobs capture pool data from the blockchain on an ongoing basis and make this data available to the Optimization Engine. However, this should be replaced by the Graph Protocol prior to launch.  |
-| **predictRates** | Uses fetched pool data to predict the deposit, borrow and reward rates for liquidity pools for the upcoming rebalancing window. This component incorporates pool data modelling;  time series modelling and prediction and price impact modelling.  |
-| **buildStrategies** | Dynamically generates all possible strategies given the enabled pools.  |
-| **scoreStrategies** | Provides a score to each generated strategy based on the predicted rates.   |
+| getPoolData | Fetches liquidity pool data from the OptyFi API server. Currently, automated jobs capture pool data from the blockchain on an ongoing basis and make this data available to the Optimization Engine. However, this should be replaced by the Graph Protocol prior to launch.  |
+| predictRates | Uses fetched pool data to predict the deposit, borrow and reward rates for liquidity pools for the upcoming rebalancing window. This component incorporates pool data modelling;  time series modelling and prediction and price impact modelling.  |
+| buildStrategies | Dynamically generates all possible strategies given the enabled pools.  |
+| scoreStrategies | Provides a score to each generated strategy based on the predicted rates.   |
 
 ## Decentralization
 
-The OptyFi road map includes the decentralization of the Optimization Engine. Possible approaches include implementation on an L2 chain or the development of a custom and efficient OptyFi Yield Chain.  
-
+The OptyFi road map includes the decentralization of the Optimization Engine. Possible approaches include implementation on an L2 chain or the development of a custom and efficient OptyFi Yield Chain.

protocol/optyfi-protocol/risk-framework.md

@@ -12,11 +12,11 @@ Currently the OptyFi Protocol implements three pool ratings:
 
 The system is flexible to accommodate an arbitrary number of pool ratings without modification to smart contract code. 
 
-Each liquidity pool integrated with the OptyFi Protocol is assigned a pool rating. This rating is currently established by governance vote. However in the future, governance may vote to use an external service \(such as [defiscore.io](www.defiscore.io)\), or subscribe to pool ratings from community [risk analysts](../participants.md#risk-analysts).  
+Each liquidity pool integrated with the OptyFi Protocol is assigned a pool rating. This rating is currently established through governance voting. However, in the future, governance voting may result in the use of external services \(such as [defiscore.io](www.defiscore.io)\) or community [risk analysts](../participants.md#risk-analysts) to determine the risk of a pool.  
 
 Currently, all pools for a given protocol are assigned the same rating, as follows: 
 
-| Protocol | Pool Rating |
+| **Protocol** | **Pool Rating** |
 | :--- | :--- |
 | Aave | T1 |
 | Compound | T1 |
@@ -29,9 +29,9 @@ Currently, all pools for a given protocol are assigned the same rating, as follo
 
 ## Risk Profiles
 
-Each strategy is assigned a risk profile based on the ratings of pools involved in the strategy along with the complexity of the strategy. Currently, the following risk profiles are defined:
+Each strategy is assigned a risk profile based on the ratings of the pools involved in the strategy along with the complexity of the strategy. Currently, the following risk profiles are defined:
 
-| Risk Profile | Description | Pool Ratings | Strategy Complexity |
+| **Risk Profile** | **Description** | **Pool Ratings** | **Strategy Complexity** |
 | :--- | :--- | :--- | :--- |
 | RP0 | Default | N/A | Hold In Vault |
 | RP1 | Basic | T1 | Multi-Step, No Borrow |
@@ -56,7 +56,7 @@ The limits work as follows:
 
 To better understand the application of these investment limits, take a look at the examples below.
 
-| Protocol | Protocol Investment Limit Mode | Protocol Max Percent | Pool | Pool Max Percent | Pool Max Amount |
+| **Protocol** | **Protocol Investment Limit Mode** | **Protocol Max Percent** | **Pool** | **Pool Max Percent** | **Pool Max Amount** |
 | :--- | :--- | :--- | :--- | :--- | :--- |
 | Compound | Percent | 500% | cDAI | 100% | N/A |
 | Compound | Percent | 500% | cBTC | Null \(defaults to 500%\) | N/A |

protocol/optyfi-protocol/strategy-composition.md

@@ -2,11 +2,11 @@
 
 Yield strategies are the fundamental building block of the OptyFi Protocol and its most compelling innovation.
 
-Conceptually, yield strategies are generated dynamically based on the structure of DeFi liquidity pools. The building blocks for strategies are strategy steps and strategy sequences. The universe of possible strategy sequences together form a strategy graph.  
+Conceptually, yield strategies are generated dynamically based on the structure of existing DeFi liquidity pools. The building blocks for strategies are [strategy steps](strategy-composition.md#strategy-step) and [strategy sequences](strategy-composition.md#strategy-sequence). Put together, the entirety of strategy sequences form the [strategy graph](strategy-composition.md#strategy-graph).
 
 ## Strategy Step
 
-A strategy step is the fundamental building block of a strategy. A strategy step may consist of a deposit step or a borrow step. 
+A strategy step is a fundamental building block of a strategy. A strategy step can be categorized as a deposit step or a borrow step. 
 
 ### Deposit Step 
 
@@ -22,19 +22,18 @@ Depositing an underlying token into a pool as collateral and then borrowing an u
 
 ## Strategy Sequence
 
-A strategy sequence is comprised of multiple strategy steps. 
+A strategy sequence is composed of multiple strategy steps. 
 
 If a token is deposited into a pool and the LP token you receive in return can be deposited into a second pool, then you can "string together" two strategy steps to form a two-step strategy sequence.
 
 ![A Two-Step Strategy Sequence.](../../.gitbook/assets/strategy-sequence.svg)
 
 This process can be generalized into n-steps based on the condition `outputToken(step[n-1]) = inputToken(step[n])`. 
 
-In today's DeFi reality, strategy sequences are usually limited to a maximum of two deposit steps or two deposit steps with a borrow step.
+In today's DeFi reality, strategy sequences are usually limited to two deposit steps or two deposit steps with a borrow step.
 
 ## Strategy Graph
 
-The universe of possible strategy sequences forms a directed \(possibly cyclic\) graph which we refer to as the Strategy Graph. The nodes of the Strategy Graph represent liquidity pools and inbound edges represent deposits into those liquidity pools.
-
-OptyFi's Strategy Graph is determined by liquidity pools integrated with the Protocol. Integrating a new liquidity pool to the Protocol creates a new node which potentially generates many more possible strategies.  
+The entirety of possible strategy sequences form a directed \(possibly cyclic\) graph which we refer to as the Strategy Graph. The nodes of the Strategy Graph represent liquidity pools and the inbound edges represent deposits into those liquidity pools.
 
+OptyFi's Strategy Graph is determined by liquidity pools integrated within the Protocol. Integrating a new liquidity pool to the Protocol creates therefore updates the Strategy Graph, potentially generating multiple new strategies.