finalize revision of all docs for launch

docs/components/ai.md

@@ -12,7 +12,7 @@ Instead of relying on centralized servers to process data, it leverages local de
 
 Key features of this AI assistant include:
 
-- **Local Data Processing**: Your data never leaves your device or is processed within a secure, decentralized network.
+- **Local Data Processing**: Your data either never leaves your device or is processed within a secure, decentralized network.
 - **User-Controlled Models**: You decide how the AI functions, what it learns, and how it interacts with your data.
 - **Interoperability**: It connects seamlessly with other decentralized systems, ensuring autonomy without isolation.
 

docs/how_it_works.md

@@ -22,9 +22,9 @@ The grid is a decentralized Web4 infrastructure layer which allows us to build W
 ![](become-a-farmer/become_farmer.png)
 
 - Individual and commercial farmers connect hardware capacity to the ThreeFold Grid and earn rewards for doing so.
-- Over the next years, millions of nodes will be connected to the existing network. [Check the ThreeFold Dashboard](https://dashboard.grid.tf).
+- Over the next years, our aim is that millions of nodes will be connected to the existing network. [Check the ThreeFold Dashboard](https://dashboard.grid.tf).
 - Our network technology provides an end-to-end encrypted and ultra reliable connection layer.
-- Our storage technology makes sure data is never lost and privacy is guaranteed.
+- Our storage technology makes sure that data is never lost and privacy is guaranteed.
 
 
 ### Developers & System Administrators (Users)
@@ -44,10 +44,10 @@ Our platform has a lot of use cases:
 
 The ThreeFold decentralized architecture has key features.
 
-- Millions of Famers in Farmingpools (v4) deliver the compute, AI, storage and network capacity required.
+- It is possible for millions of Famers associated with Farmingpools (V4) to deliver the compute, AI, storage and network capacity required.
-- Governance is done via the ThreeFold decentralized autonomous organization (DAO).
+- Governance is done via the ThreeFold decentralized autonomous organization (TFDAO) with a token-based voting model.
 - Web 2 and 3 solution providers & hosters can use the resources on the grid. [Check the ThreeFold Dashboard.](https://dashboard.grid.tf)
-- Web 4 developers can create the apps (experiences) of the future.
+- Web 4 developers can create the apps and experiences of the future.
 
 ## Vision
 
@@ -56,7 +56,6 @@ The ThreeFold Grid aims to create a more sovereign, efficient, and evolutive Int
 > A thriving Internet is not only possible, it is being built right now.
 >
 > *ThreeFold is building Web4...*
-> 
 
 Join the grid and build with us! There are many ways to contribute and interact on the grid. 
 

docs/how_to_use_it.md

@@ -13,11 +13,11 @@ The current grid is usable for people who have some technical background and kno
 We are working on the generation 4 of the ThreeFold Grid, which will have the following additional features:
 
 - Service Level Management
-  - As a user of the Internet capacity you get a guarantee from the farmers
+  - As a user of the Internet capacity, you get a guarantee from the farmers
 - Farming Pools
-  - Pools of capacity with defined service level and pricing
+  - Pools of capacity with defined service level and pricing managed
 - Dynamic Pricing
-  - Each farmer/farming pool can define their own pricing in line to service levels and performance.
+  - Farmers and farming pools can define their own pricing in line to service levels and performance
 - Development platform for Web4
   - This will be an agent-centric paradigm of the future.
 
@@ -36,8 +36,6 @@ Developers, as well as system administrators, can use the ThreeFold Grid.
 
 Today, system administrators already have access to a large variety of tools to get started today. Read more below.
 
-> *On 12-12-2024, we will announce what developers can build on top of the ThreeFold Grid.*
-
 A true Web4 system must be flexible, enabling anyone, anywhere, to build on top of it.
 
 
@@ -50,19 +48,19 @@ ThreeFold has made the ThreeFold Grid compatible with industry standards used to
 
 You can deploy:
 
-- Virtual Machines
+- **Virtual Machines**
-- Containers
+- **Containers**
   - Compatible with Docker
-- Kubernetes Clusters
+- **Kubernetes Clusters**
   - Compatible with the world
   - With additional network capabilities
-- Multiple Network Technologies
+- **Multiple Network Technologies**
   - To connect the virtual machines & containers
-- AI Workloads
+- **AI Workloads**
   - Use GPU from the containers or virtual machines
-- Web Gateways
+- **Web Gateways**
   - Connect your running workload to the Internet
-- Web3 workloads
+- **Web3 workloads**
   - Anything which can run on Linux today can run on top of the ThreeFold Grid
     - e.g. blockchain validators, etc. 
 

docs/introduction.md

@@ -34,16 +34,16 @@ The fourth generation of ThreeFold is a decentralized and self-healing ecosystem
 ThreeFold's Web4 is composed of revolutionary tools providing a truly decentralized Internet:
 
 - **Web4 Phones**
-  - Secure smartphones built-in with decentralized apps
+  - Secure smartphones with built-in decentralized apps
 - **TF Genie**
   - AI-driven virtual assistants directly on your secure phone
 - **Web4 Nodes**
   - The backbone of the Web4 cloud offering compute and data resources
 - **Web4 Routers**
-  - Routers always finding the shortest path, linking the nodes and phones altogether
+  - Routers always finding the shortest path, linking the nodes and phones together
 
 ![](./img/web4_overview.png)
 
-Those products redefine digital autonomy in a concrete and practical manner.
+These products redefine digital autonomy in a concrete and practical manner.
 
-> Read forward to learn more about this innovative system and how you can build it with us.
+> Read on to learn more about this innovative system and how you can build it with us.

docs/legal/disclaimer.md

@@ -8,4 +8,4 @@ sidebar_position: 3
 
 > The information provided in these tutorials or any related discussion is not intended as investment advice. The purpose is to provide educational and informational content only. Investing in cryptocurrencies or any other assets carries inherent risks, and it is crucial to conduct your own research and exercise caution before making any investment decisions. 
 > 
-> **The INCA Token** is not to be considered as a traditional investment instrument. The value of cryptocurrencies can be volatile, and there are no guarantees of profits or returns. Always be aware of the risks involved and make informed choices based on your own assessment and understanding.
+> The different ThreeFold tokens (TFT, INCA, INCA-G) are not to be considered as traditional investment instruments. The value of cryptocurrencies can be volatile, and there are no guarantees of profits or returns. Always be aware of the risks involved and make informed choices based on your own assessment and understanding.

docs/litepaper.md

@@ -18,9 +18,7 @@ Web4 represents the natural evolution of the Internet, where humans and artifici
 
 ## Mission
 
-Our Mission is to create the best possible infrastructure layer for Web 4.0 [^2] with the following benefits:
+Our Mission is to create the best possible infrastructure layer for Web 4.0 with the following benefits:
-
-[^2]: Web4 - Techopedia [Link](https://www.techopedia.com/definition/web4)
 
 * Sovereignty for countries, communities and people
   * Data is close to the users in their own countries
@@ -39,7 +37,7 @@ Our Mission is to create the best possible infrastructure layer for Web 4.0 [^2]
 
 ## Web4 Possibilities
 
-Web4 allows “everyone everywhere” to:
+Web4 will allow ***everyone everywhere*** to:
 
 * Participate in private secure online meetings (voice, video, etc.)
 * Restore authenticity and determine which information can be trusted
@@ -56,7 +54,7 @@ And soooo much more…
 
 ## A Unique Project
 
-To our knowledge, we are the world’s first project approaching a fully functional Web4 infrastructure that places priority on both the planet and people. Over the past decade, we’ve tackled complex challenges in areas such as data storage, secure overlay networking, and autonomous cloud security to bring this vision to life.
+To our knowledge, we are the world’s first project approaching a fully functional Web4 infrastructure that places priority on both the planet and the people. Over the past decade, we’ve tackled complex challenges in areas such as data storage, secure overlay networking, and autonomous cloud security to bring this vision to life.
 
 ## The ThreeFold Team
 
@@ -88,7 +86,7 @@ Read the [ThreeFold V3 Manual](https://manual.grid.tf/) to learn more about the
 
 ThreeFold envisions a complete Internet infrastructure to allow Web4 to come alive.
 
-### Web4 Phones, Routers, Nodes and AI Assistants
+### Web4 Phones, Routers, Nodes and ThreeFold Genie (AI Assistants)
 
 The ThreeFold Web4 Internet infrastructure will consist of a completely sustainable, peer-to-peer, encrypted and data-sovereign network of nodes, routers and phones.
 
@@ -98,6 +96,8 @@ Consult the [Components](/docs/category/components) page for more information.
 
 To sustain this whole Web4 ecosystem, ThreeFold V4 will be rooted in a Web4 Internet currency focused on community growth and expansion.
 
+Consult the [Tokenomics](./tokens/tokenomics.md) page for more information.
+
 ## Actionable Items - Now
 
 You can pre-order ThreeFold Web4 [nodes and phones](/docs/category/components).
@@ -108,7 +108,7 @@ In Q1 2025, you will be able to pre-order a ThreeFold Web4 [router](/docs/catego
 
 ## Governance
 
-ThreeFold Web4 will be based on a cooperative model.
+ThreeFold Web4 will be based on both a [cooperative](./decentralization/coop.md) model and a [decentralized autonomous organization (DAO)](./decentralization/dao.md) model.
 
 ## The Internet as Hope for Humanity
 
@@ -116,4 +116,4 @@ At ThreeFold, we believe that the Internet represents an amazing opportunity tha
 
 We think that it is possible to collectively build and improve the Internet so as it unlocks its unlimited potential to humanity.
 
-***Let's do it.***
+***Let's do it together.***

docs/roadmap.md

@@ -29,7 +29,7 @@ ThreeFold has accomplished so much over the years: we are currently in the fourt
 - We are building a decentralized sovereign alternative to today's centralized Internet model.
 - We are making significant progress towards realizing this vision. 
 
-**We present here the currently available features as well as the features that will be available in a near future.**
+**We present here the currently available features as well as the features that will be available in the near future.**
 
 Currently, the ThreeFold Grid is in more than 50 countries with thousands of nodes online providing data, network and cloud resources to users as a working proof of concept. 
 
@@ -61,4 +61,3 @@ Many developers from everywhere over the world are creating the required pieces
 - Secure Chat
 - Secure file storage & sharing platform
 - Proof of authenticity
-- Chain of trust

docs/tech.md

@@ -17,7 +17,7 @@ Together with our partners, we have all the required parts to make it happen on
 
 ### Personal Level
 
-- **Agent Layer**: Every person owns a Personal Digital Assistant, managing their digital life.
+- **Agent Layer**: Every person owns a Personal Digital Assistant (PDA), managing their digital life.
 - **Identity Layer**: Strong reputation management, proof of authenticity, a global name system.
 - **Intelligence Layer**: Decentralized, personal AI systems for collaboration & augmented intelligence.
 - **Transaction Layer**: Fully integrated with Web3 systems and beyond, e.g. mutual credit, etc.
@@ -45,7 +45,7 @@ The following are the required components to make all this possible:
   - Self-healing and automated resource management via bare metal ThreeFold nodes.
 - **Mycelium**: End-to-end encrypted network always using the shortest path.
 - **Quantum Safe Storage**: Technology resistant to quantum computer attacks where data can never be lost.
-- **Advanced AI Agent**: Get ready to build the apps of the future in full compatibility with Web3. 
+- **Advanced AI Agent**: Creation of apps fully compatibility with Web3. 
 - **Smart Contract for IT**: Blockchain-based resource allocation with signed contracts.
   - Secure, transparent transaction mechanisms for deployment of solutions on the ThreeFold Grid.
 

docs/tokens/incag.md

@@ -8,15 +8,15 @@ sidebar_position: 3
 
 > INCA-G = INCA Generator (is a token generating INCA)
 
-An INCA-G token generates INCA over a certain period. INCA stands for Internet Capacity token, enabling individuals to buy/sell Internet & Cloud Capacity.
+An INCA-G token generates INCA over a certain period. INCA stands for **IN**ternet **CA**pacity token, enabling individuals to buy/sell Internet & cloud capacity.
 
-We can analogize the generation of Cloud/Internet capacity to the generation of electricity. In this analogy, INCA is akin to the KWH token, while INCA-G is comparable to the KW token (representing capacity to generate electricity).
+We can draw an analogy between the generation of Cloud/Internet capacity to the generation of electricity. In this analogy, INCA is akin to the KWH token, while INCA-G is comparable to the KW token, representing the capacity to generate electricity.
 
-INCA-G tokens are unique and come with metadata specifying how INCA will be generated. This metadata outlines the generation schedule of INCA over the next X months.
+INCA-G tokens are unique and come with metadata specifying how INCA will be generated. This metadata outlines the scheduled generation of INCA over a given period of time.
 
 ### How to Acquire the INCA-G Token?
 
-- Converting from TFT
+- Convert TFT to INCA-G
-- Buying from a pool as generated by a farming pool as others farm on your behalf
+- Buy INCA-G from a farming pool as the tokens are generated farmers on your behalf
-- As an investor
+- Buy INCA-G as an investor
 

docs/tokens/tokenomics.md

@@ -6,27 +6,26 @@ sidebar_position: 2
 
 ![](../img/inca_tokens.png)
 
-INCA is our utility like token empowering our ThreeFold grid.
+INCA is our utility like token empowering the ThreeFold Grid.
 
-Users use INCA tokens to deploy web solutions on top of the ThreeFold grid
+Farmers generate **IN**ternet **CA**pacity and earn INCA tokens:
 
-- compatible with any web2, web3 and web4 solution
+- **Proof of Capacity**
-- [More info see here](../how_to_use_it.md)
+  - Up to 40 million INCA are available as rewards to reward Farmers for providing capacity in strategic locations.
+- **Proof of Utilization** 
+  - 80% of the INCA as used to buy the Internet Capacity goes to Farmers and their Farming Pools (60% and 20% respectively).
 
-Farmers generate INternet CApacity and earn INCA tokens:
+Users use INCA tokens to deploy web solutions on top of the ThreeFold Grid.
-
-- Proof of Capacity: 
-  - rewards are available upto 40m INCA per month to reward Farmers to deploy capacity on strategic locations
-- Proof of Utilization: 
-  - 80% of the INCA as used to buy the Internet Capacity goes to Farmers and their Farming Pools.
 
+- It is compatible with any Web2, Web3 and Web4 solution.
+  - [Read this section to learn more about the use cases](../how_to_use_it.md)
 
 ## INCA = **IN**ternet **CA**pacity
 
 The **INCA token** allows anyone, anywhere, to access the ThreeFold ecosystem. 
 
 - **ThreeFold V4** is a self-healing data, network, and cloud Internet infrastructure laying the foundation for Web4. 
-- It is composed of nodes, routers, and phones, all connected to the **ThreeFold Network** and compatible with the current Internet.
+- It is composed of nodes, routers, and phones, all connected to the **ThreeFold Grid** and compatible with the current Internet.
 
 ### Expansion Phase of the Grid
 
@@ -42,7 +41,7 @@ ThreeFold is now entering the **expansion phase** of the grid, aiming to grow to
 
 - The technology behind ThreeFold is **rock solid**, tested for years on mainnet. With INCA, we now enter the expansion phase to grow the grid to millions of nodes.
 - **Liquidity optimization** is a key goal, enabled through an innovative, fiat-ready, and cross-chain marketplace.
-- Over **70% of TFT** is allocated to the **community**, ensuring that INCA's tokenomics support **organic expansion** and provide resources for ThreeFold community members to thrive and build.
+- Over **70% of the INCA supply** is allocated to the **community**, ensuring that the INCA tokenomics supports **organic expansion** and provides resources for ThreeFold community members to thrive and build.
 - The **INCA release** guarantees a **fair and resilient distribution**, fostering a strong and sustainable ecosystem.
 
 ThreeFold V4, powered by INCA, represents a transformative step toward a decentralized, scalable, and resilient future for the Internet. Together, we are building the foundation for **Web4**.
@@ -52,8 +51,7 @@ ThreeFold V4, powered by INCA, represents a transformative step toward a decentr
 
 ### Distribution
 
-
+The ThreeFold INCA token distribution (including the TFT distribution) is carefully crafted to ensure a major allocation to the community. There can never be more than 4 billion tokens.
-The ThreeFold INCA token distribution (includes the TFT) is carefully crafted to ensure a major allocation to the community. There can never be more than 4 billion tokens.
 
 By prioritizing community growth, we're creating a collaborative environment where everyone can benefit from their contributions and participate in the project's success. This balanced distribution ensures that a significant amount of tokens is dedicated to the community, creating opportunities for growth and development within our ecosystem.
 
@@ -84,11 +82,11 @@ pie
 - **12.5%: Team**
 
 
-> Do note this table is still under deliberation and can change
+> Do note this table is still under deliberation and can change.
 
 ## INCA Token
 
-The ThreeFold INCA tokenomics for the ThreeFold Grid 4.0 has been designed to promote an active ecosystem of cloud users, farmers, and validators. It presents a robust liquidity strategy that ensures seamless transfers and secure transactions within our cloud marketplace. Furthermore, by allocating 40 million tokens per month (averaged out) for farming grants, we're empowering individuals and organizations to contribute to the grid's growth and development.
+The ThreeFold INCA tokenomics for ThreeFold V4 has been designed to promote an active ecosystem of cloud users, farmers, and validators. It presents a robust liquidity strategy that ensures seamless transfers and secure transactions within our cloud marketplace. Furthermore, by allocating 40 million tokens per month (averaged out) for farming grants, we're empowering individuals and organizations to contribute to the grid's growth and development.
 
 The proof-of-utilization rewards are distributed in a simpler manner:
 

docs/tokens/tokens.md

@@ -7,7 +7,12 @@ sidebar_position: 1
 
 There are multiple tokens in the ThreeFold ecosystem:
 
-
+- **TFT**
-- INCA = INternet CApacity (is the token of buying/selling Internet/Cloud Capacity), max 4 billion.
+  - The creator token for the first threefold generation of the ThreeFold Grid
-- INCAG = INCA Generator token, mints token over time.
+  - Each TFT can be converted at any time in INCA or INCA-G Token, given a specific lock and release mechanism.
-- TFT = the creator token for grid 3.x. TFT can be converted at any time in INCA or INCA-G Token.
+  - The maximum supply is 1 billion TFT on Stellar Chain.
+- **INCA** = **IN**ternet **CA**pacity
+  - This token is used to buy and sell Internet and Cloud Capacity)
+  - The maximum supply is 4 billion, including the 1 billion supply of TFT that can be converted to INCA.
+- **INCA-G**
+  - The INCA Generator token mints INCA tokens over time.