From 87e813cfd912412af6ad107d87f0e5dceead20f1 Mon Sep 17 00:00:00 2001
From: mik-tf <logismos@protonmail.ch>
Date: Wed, 11 Dec 2024 21:12:17 -0500
Subject: [PATCH] update v4 status

---
 docs/decentralization/dao.md                  |  2 +-
 .../status/decentralization4.md               | 63 +++++++++----------
 2 files changed, 32 insertions(+), 33 deletions(-)

diff --git a/docs/decentralization/dao.md b/docs/decentralization/dao.md
index 1fe6304..e4977f2 100644
--- a/docs/decentralization/dao.md
+++ b/docs/decentralization/dao.md
@@ -27,7 +27,7 @@ DAOs aim to create transparency, eliminate centralized authority, and allow memb
 
 ### ThreeFold DAO
 
-The ThreeFold Cooperative promotes and manages the DAO. INCA token holders vote using the DAO on grid enhancement proposals (GEP) and utility enhancement proposals.
+The ThreeFold Cooperative promotes and manages the DAO. INCA token holders vote using the DAO on grid enhancement proposals (GEP) and grid upgrade proposals (GUP).
 
 <!--
 TODO: add links to GEP and UEP
diff --git a/docs/decentralization/status/decentralization4.md b/docs/decentralization/status/decentralization4.md
index 151507d..18bfcbf 100644
--- a/docs/decentralization/status/decentralization4.md
+++ b/docs/decentralization/status/decentralization4.md
@@ -6,67 +6,66 @@ description: ThreeFold V4 Decentralization Model
 
 ## ThreeFold V4 Decentralization Model
 
+The following is our own subjective evaluation for the TFGrid V4 and should not be construed as a guarantee or commitment. We welcome any differing opinions or feedback.
+
 ## Fully Decentralized Farming - TF Nodes
 
-Today more than 500 farmers host the nodes which make up the TF Grid Network.
+We expect to have many thousands of independent compute, storage, network farmers in the world. This is the true nature of our decentralization.
 
-None of the ThreeFold Companies or its team has the ability to break this model, its our aim to have the farmers independant completely from Threefold.
+The communication between the marketplace, 3Nodes, farming pool agents and other participants all goes over the mycelium network which leads to a fully peer-to-peer control and communication plane. All communication is end-to-end encrypted, all messages are signed by the participants.
 
-We expect to have many thousands of independent compute, storage, Network farmers in the world. This is the true nature of our decentralization.
-
-The communication between the marketplace, 3Nodes, Farming Pool Agents and other participants all goes over the mycelium network which leads to an full peer2peer control and communication plane. All communication is end2end encrypted, all messages are signed by the participants.
-
-The billing & tracking of capacity in v 4.0 will be based on a mutual credit and capacity accounting system which is carried and peer2peer executed by the farmers.
+The billing & tracking of capacity in V4 will be based on a mutual credit and capacity accounting system which is carried and executed by the farmers in a peer-to-peer fashion.
 
 ## Farming Pools
 
-Many people will want to he a hoster of capacity but not have to deal with the duties of being a farmer, they can connect to a farming pool and add their capacity to such a pool.
+Many people will want to be a hoster of capacity while not having to deal with the duties of being a farmer. In this case, they can connect to a farming pool and add their capacity to it.
 
-They can chose the farming pool they like, farming pools can be DAO's by themselves, they organize their own governance indepent of ThreeFold. A Farming pool defines the price, service levels, ... A Farming pool defines how the proceeds are split over their members.
+They can chose the farming pool they like. Farming pools can be DAOs by themselves: they organize their own governance indepently of ThreeFold. A farming pool defines the price, service levels, etc. A farming pool defines how the proceeds are split over their members.
 
-We expect that more than 80% of the capacity in the future will be provider over Farming Pools, in our opinion this leads to a super decentralized structure while making it possible to provide strong SLA's.
+We expect that more than 80% of the capacity in the future will be provided over by farming pools. In our opinion, this leads to a highly decentralized structure while making it possible to provide strong service level agreements.
 
-## Grid Enhancement Proposals (GEP's)
+## Grid Enhancement Proposals (GEPs)
 
 The decisions that shape the technology and standards of ThreeFold are driven by the community through the Grid Enhancement Proposal (GEP) program. These proposals are reviewed and approved farmers, technical steering committee as well as the cooperative, ensuring that the best ideas rise to the top. 
 
-The GEPS are proposed by the ThreeFold Cooperation.
+The GEPS are proposed by the ThreeFold Cooperative.
 
-The GEPS need to be voted for by the community (voting power based on nr of INCA in account), the exact rules of voting are still being worked on.
+The GEPS need to be voted for by the community (voting power based on the number of INCA in the voter's account), the exact rules of voting are still being worked on.
 
-GEPS deal with
+GEPs deal with:
 
-- approve functionality & roadmap (priorities)
-- approve changes in protocol or anything which has impact on fundamental working of the TGGrid
+- Functionality & roadmap approvals (e.g. priorities)
+- Approval of changes in protocol or anything which has impact on the fundamental working of the TFGrid
 
-## Grid Upgrade Proposals (GUP's)
+## Grid Upgrade Proposals (GUPs)
 
-GUPs us much more practical, its providing a control path for code changes, community members or farmers will probably lack the knowledge as required to have meaningful review capability on these proposals.
+GUPs are much more practical. They are about providing a control path for code changes. Community members or farmers will probably lack the knowledge as required to have meaningful review capability on these proposals.
 
-GUPS deal with
+GUPs deal with:
 
-- code updates on production TFGrid
+- Code updates on the TFGrid production level
 
-## TF Protectors run the TF Grid Validators
+## TF Protectors Run the TFGrid Validators
 
-We have been learning from what Hashgraph did and we like their model (see here for more [info](https://hedera.com/blog/decentralized-on-hedera)).
+We have been learning from what [Hashgraph](https://hedera.com/blog/decentralized-on-hedera) did and we like their model.
 
 ThreeFold’s validator consensus model is addressing the challenges of decentralization in a practical way. It brings together up to 9 to 30 term-limited organizations (TF Protectors) from across multiple continents, ensuring a truly global perspective. 
 
-Each TF Protector does the following
+Each TF Protector accomplishes the following:
 
-- operate a [TF Validator Clusters](../threefold_validators.md), which requires an investment and requires an operational team
-- validate the code written and sign off on the changes (validation step on code & functionality)
-- validate the GEP's and execute a VETO right if needed, the TF Protectors can stop a GEP.
-- validate and approve the GUP's
+- Operate a [TF validator clusters](../threefold_validators.md), which requires some investment and an operational team.
+- Validate the code written and sign off on the changes (validation step on code & functionality).
+- Validate the GEPs and execute a veto right if needed, the TF Protectors can stop a GEP.
+- Validate and approve the GUPs.
 
 Each Protector member has an equal vote, which prevents any single entity from gaining undue influence and keeps the governance balanced and fair.
 
-ThreeFold’s proof-of-stake model (v4.x) has been designed to prevent the concentration of power. Nodes gain influence only when $TFT or $INCA is staked to them by individual users, ensuring that the community has a direct role in the network’s governance. 
+ThreeFold’s proof-of-stake model (V4) has been designed to prevent the concentration of power. Nodes gain influence only when $TFT or $INCA is staked to them by individual users, ensuring that the community has a direct role in the network’s governance. 
 
-## TF Cooperative
+<!--
+TODO: Define ## TF Cooperative
+-->
 
+## Development & Open-Source
 
-## Development & OpenSource
-
-The development of ThreeFold is an open, collaborative process. All software powering the network, including services and developer tools, is open-sourced under an Apache 2.0 license. The decentralized development model encourages contributions from a wide range of participants, including the ThreeFold developer community. This approach improves innovation and ensures that the platform continuously evolves to meet the needs of its users.
+The development of ThreeFold is an open and collaborative process. All software powering the network, including services and developer tools, is open-sourced under an Apache 2.0 license. The decentralized development model encourages contributions from a wide range of participants, including the ThreeFold developer community. This approach improves innovation and ensures that the platform continuously evolves to meet the needs of its users.
\ No newline at end of file