update docs with revised content based on kristof changes

docs/components/3AI.md

@@ -8,13 +8,13 @@ description: 'Personal AI Agent'
 
 The **3AI** is a AI-driven agent designed to empower individuals with a **private, secure, and decentralized AI experience** on the **3Phone**. 
 
->This system uses [Morpheus AI](https://mor.org/) underneith.
+>This system uses [Morpheus AI](https://mor.org/) underneath.
 
-#### **Key Features of 3AI**
+## Key Features of 3AI
 
 1. **Privacy-First AI**  
 
-   - Your source data is private on your 3Phone
+   - Your source data is private on your 3Phone.
    - Your personal information is processed locally, ensuring **complete privacy**.
 
 2. **Always-On Assistant**  
@@ -25,7 +25,7 @@ The **3AI** is a AI-driven agent designed to empower individuals with a **privat
 3. **Decentralized Intelligence**  
 
    - Leverages the **ThreeFold Grid** for distributed AI capabilities.  
-   - Connects securely to your MycoVerse apps for personalized digital living.
+   - Connects securely to your MyVerse apps for personalized digital living.
    - The Morpheus Decentralized AI system is also used as source of GPU capacity.
 
 4. **Sustainability Built-In**  
@@ -33,16 +33,13 @@ The **3AI** is a AI-driven agent designed to empower individuals with a **privat
    - Runs efficiently using the decentralized resources of the **ThreeFold Grid**, reducing environmental impact.  
    - Designed to minimize power consumption on the **3Phone**.
 
----
+## What Can 3AI Do?
-
-#### **What Can 3AI Do?**
 
 - Organize and prioritize tasks based on your preferences.  
 - Automate repetitive activities, giving you more time for what matters.  
 - Assist with secure, private communication through encrypted tools.  
 - Provide insights and recommendations tailored specifically to you.
 
-
 ## Timing
 
-- 3AI Agents are free for every 3Phone owner (only the highest end version) and included as pre-installed app on the 3Phone.
+- 3AI Agents are free for every 3Phone owner (only the highest end version) and included as a pre-installed app on the 3Phone.

docs/components/3bot.md

@@ -12,7 +12,7 @@ The 3Bot is an innovative AI agent designed to run seamlessly on the 3Phone, off
 
 With its intuitive capabilities, 3Bot makes managing decentralized applications effortless, empowering users with complete control over their digital ecosystem.
 
-### Key Features of 3Bot:
+## Key Features of 3Bot
 
 1. **Deploy Decentralized Apps**
 
@@ -34,13 +34,13 @@ With its intuitive capabilities, 3Bot makes managing decentralized applications
 
     - Benefit from robust monitoring and visibility into your applications, ensuring peace of mind.
 
-### How It Works:
+## How It Works
 
 Using natural chat or voice commands, you can communicate directly with your private 3Bot to request tasks or make adjustments.
 
 No technical expertise is needed, 3Bot simplifies everything for you.
 
-### Example Applications Managed by 3Bot:
+## Example Applications Managed by 3Bot
 
 - **Social Media Network**: Privacy-focused platforms to connect with your network.
 - **Secure Chat**: Encrypted messaging for secure communication.
@@ -49,7 +49,7 @@ No technical expertise is needed, 3Bot simplifies everything for you.
 - **YouTube Alternative**: Decentralized video sharing and streaming.
 - **Google Drive Alternative**: Private, distributed file storage and sharing.
 
-### Why 3Bot?
+## Why 3Bot?
 
 By taking the complexity out of managing digital services, 3Bot empowers you to:
 
@@ -59,4 +59,4 @@ By taking the complexity out of managing digital services, 3Bot empowers you to:
 
 ## Timing
 
-- 3Bots are free for every 3Phone owner and included as pre-installed app on the 3Phone.
+- 3Bots are free for every 3Phone owner and included as a pre-installed app on the 3Phone.

docs/components/3cloud.md

@@ -7,6 +7,8 @@ description: 'Our Secure Private Cloud.'
 
 ![](../howtouse/img/users_all.png)
 
+## 3Cloud Use Cases
+
 Our platform supports a lot of use cases:
 
 - Web2 system administrators can deploy any application on the grid with the tools they are used to work with.

docs/components/3node.md

@@ -5,7 +5,7 @@ sidebar_position: 2
 
 ![](../img/become_farmer.png)
 
-## Empowering the New Internet by hosting your own 3Nodes
+## Empowering the New Internet by Hosting Your Own 3Nodes
 
 The Internet as we know it has become centralized, fragile, and monopolized by a few powerful corporations. 
 
@@ -18,6 +18,7 @@ By hosting a node, you become a vital part of this revolutionary shift.
 ## How to Host a Node
 
 Getting started is simple. Choose the option that works for you:
+
 1. **Buy a Plug-and-Play Node**:
    Get a ready-to-go device that you can set up at home or in your office.
 2. **Use Existing Hardware**:
@@ -29,7 +30,7 @@ Getting started is simple. Choose the option that works for you:
 
 The ThreeFold V4 nodes are available now and you can buy them directly on our official partners' websites:
 
-- [HostService](https://hostservice.nl/en/) (America)
+- [HostService](https://hostservice.nl/en/) (Europe, Asia, Africa, Australia)
-- [Duck Farm Data](https://duckfarmdata.com/) (Europe, Asia, Africa, Australia)
+- [Duck Farm Data](https://duckfarmdata.com/) (America)
 
-Join the Network, more than 60,000 vCPU are already active today.
+Join the Network, where more than 60,000 vCPU are already active today.

docs/components/bitcoin.md

@@ -25,4 +25,4 @@ The ability to use BTC throughout the ecosystem will create a seamless experienc
 
 ## Link to INCA
 
-Please note that INCA ofcourse stays the underlying utility like token of the ThreeFold Ecosystem, BTC gets seamless swapped into and out of INCA using Atomic swapps.
+Please note that INCA stays the underlying utility-like token of the ThreeFold Ecosystem. BTC gets seamlessly swapped with INCA using atomic swaps.

docs/howitworks/_category_.json

@@ -3,6 +3,6 @@
   "position": 2,
   "link": {
     "type": "generated-index",
-    "description": "How does it all work."
+    "description": "We cover how the ThreeFold ecosystem works."
   }
 }

docs/howitworks/compare.md

@@ -5,7 +5,9 @@ title: 'Unique Approach'
 
 ![](../img/compare.png)
 
-### **With a *planet and people-first* philosophy, ThreeFold proposes a new way forward:**
+## Planet and People First
+
+With a *planet and people-first* philosophy, ThreeFold proposes a new way forward:
 
 1. **Privacy**: Direct control over personal data
 2. **Global Accessibility**: Internet infrastructure for underserved regions

docs/howitworks/participants.md

@@ -3,31 +3,32 @@ sidebar_position: 2
 title: Participants
 ---
 
-### The Users
+## The Users
 
 In our **Web4 enabled Internet**, powered by ThreeFold, **normal users become active participants**. 
 
 By using a **ThreeFold Phone** or apps hosted on the **ThreeFold Grid**, you can create and control your own **digital life**. 
 
-Your data stays private, stored securely on a decentralized infrastructure, while you access personalized apps and services tailored to your needs. With ThreeFold, you’re empowered to own your digital identity, interact in peer-to-peer ecosystems, and contribute to a more sustainable, user-driven internet.
+Your data stays private, stored securely on a decentralized infrastructure, while you access personalized apps and services tailored to your needs. With ThreeFold, you’re empowered to own your digital identity. You can interact in peer-to-peer ecosystems and contribute to a more sustainable, user-driven internet.
 
-We collaborate with other projects to make the experience complete
+We collaborate with other projects to make the experience complete:
 
-- BTC for payments (Bitcoin)
+- **BTC** for payments (Bitcoin)
-- Morpheus AI for decentralized AI
+- **Morpheus AI** for decentralized AI
-- Volla Phone for secure phone
+- **Volla Phone** for secure phone
 
-We also are first class host for following apps
+We are also a first-class host for the following apps:
 
-- Nostr for social network app
+- **Nostr** for social network app
-- Peertube for youtube alternative
+- **Peertube** for youtube alternative
-- Matrix as chat protocol
+- **Matrix** as chat protocol
-- Holochain for web4 blockchain capabilities (installed on 3Phone as well)
+- **Holochain** for Web4 blockchain capabilities (installed on the 3Phone as well)
-- ... (let us know if you want other apps as well)
+- And more?
+  - Let us know if you want other apps as well!
 
 ThreeFold provides the secure network, cloud and data layer.
 
-### Cloud Providers (Farmers)
+## Cloud Providers (Farmers)
 
 ![](../img/become_farmer.png)
 
@@ -35,16 +36,15 @@ ThreeFold provides the secure network, cloud and data layer.
 - In the coming years, our goal is to connect millions of nodes to the network.  
 - Our network technology delivers an end-to-end encrypted and highly reliable connection layer.  
 - Our storage technology ensures data is never lost and privacy is fully protected.  
-- [Explore the ThreeFold Dashboard](https://dashboard.grid.tf).
+- For more information on the current grid, [explore the ThreeFold Dashboard](https://dashboard.grid.tf).
 
-### Network Providers (Farmers)
+## Network Providers (Farmers)
 
 - Buy a [3Router](../components/3router.md) and allow everyone to get access to the ThreeFold Network.
 - Earn rewards by doing so.
 - ThreeFold will only create the 3Routers once we have sold at least 10,000 of them.
 
-
+## Cloud Users (Developers, Sysadmins)
-### Cloud Users (developers, sysadmins)
 
 ![](../howtouse/img/users_all.png)
 

docs/howtouse/2_user.md

@@ -10,22 +10,22 @@ In our **Web4 enabled Internet**, powered by ThreeFold, **normal users become ac
 
 By using a **ThreeFold Phone** or apps hosted on the **ThreeFold Grid**, you can create and control your own **digital life**. 
 
-Your data stays private, stored securely on a decentralized infrastructure, while you access personalized apps and services tailored to your needs. With ThreeFold, you’re empowered to own your digital identity, interact in peer-to-peer ecosystems, and contribute to a more sustainable, user-driven internet.
+Your data stays private, stored securely on a decentralized infrastructure, while you access personalized apps and services tailored to your needs. With ThreeFold, you’re empowered to own your digital identity. You can interact in peer-to-peer ecosystems and contribute to a more sustainable, user-driven Internet.
 
-We collaborate with other projects to make the experience complete
+We collaborate with other projects to make the experience complete:
 
-- BTC for payments (Bitcoin)
+- **BTC** for payments (Bitcoin)
-- Morpheus AI for decentralized AI
+- **Morpheus AI** for decentralized AI
-- Volla Phone for secure phone
+- **Volla Phone** for secure phone
 
-We also are first class host for following apps
+We are also a first-class host for the following apps:
 
-- Nostr for social network app
+- **Nostr** for social network app
-- Peertube for youtube alternative
+- **Peertube** for youtube alternative
-- Matrix as chat protocol
+- **Matrix** as chat protocol
-- Holochain for web4 blockchain capabilities (installed on 3Phone as well)
+- **Holochain** for Web4 blockchain capabilities (installed on the 3Phone as well)
-- ... (let us know if you want other apps as well)
+- And more?
+  - Let us know if you want other apps as well!
 
 ThreeFold provides the secure network, cloud and data layer.
 
-

docs/howtouse/4_web2_developers.md

@@ -6,11 +6,13 @@ sidebar_position: 4
 
 ![](img/compatible.png)
 
-### How Developers Can Use Containers, Docker, and Kubernetes for Web2 Solutions
+## Containers, Docker and Kubernetes
 
-Containers and container orchestration tools have become fundamental in modern software development. Here's how developers can leverage them to build Web2 solutions while maintaining compatibility with existing systems:
+Developers can use containers, Docker and Kubernetes for Web2 solutions.
 
-#### **Containers and Docker**
+Containers and container orchestration tools have become fundamental in modern software development. Let's see how developers can leverage them to build Web2 solutions while maintaining compatibility with existing systems.
+
+### Containers and Docker
 
 - **Containers** encapsulate applications and their dependencies, ensuring consistency across development, testing, and production environments. They enable developers to:
   - Package applications with all their dependencies.
@@ -18,23 +20,23 @@ Containers and container orchestration tools have become fundamental in modern s
   - Easily distribute and deploy applications across any infrastructure.
 
 - **Docker** simplifies container creation and management:
-  - Provides tools to build, ship, and run containers efficiently.
+  - It provides tools to build, ship, and run containers efficiently.
-  - Allows developers to version their applications and collaborate seamlessly.
+  - It allows developers to version their applications and collaborate seamlessly.
 
-#### **Helm**
+### Helm
 - **Helm** is a package manager for Kubernetes that streamlines the deployment of complex applications:
   - Developers can define applications using Helm charts, which package multiple Kubernetes manifests into a reusable format.
-  - Facilitates version control and easy updates of deployments.
+  - It facilitates version control and easy updates of deployments.
 
-#### **Kubernetes**
+### Kubernetes
 - **Kubernetes** is an open-source platform for automating deployment, scaling, and managing containerized applications:
   - It abstracts infrastructure complexity and provides tools to ensure high availability, scalability, and self-healing.
-  - Compatible with all major cloud providers and on-premises systems, making it easy to integrate with existing setups.
+  - It is compatible with all major cloud providers and on-premises systems, making it easy to integrate with existing setups.
 
-### Compatibility with the Rest of the World
+## Compatibility with the Rest of the World
 Developers can use their existing skills in programming languages, DevOps practices, and infrastructure management to work with containers, Docker, Helm, and Kubernetes. These tools adhere to open standards, ensuring:
 - Compatibility with virtually all operating systems and infrastructure environments.
-- Seamless integration with traditional Web2 technologies like REST APIs, relational databases, and microservices architectures.
+- It offers seamless integration with traditional Web2 technologies like REST APIs, relational databases, and microservices architectures.
 
 By leveraging these tools, developers can build robust Web2 applications that are portable, efficient, and compatible with global technology ecosystems.
 

docs/howtouse/5_web3_developers.md

@@ -6,17 +6,15 @@ sidebar_position: 5
 
 The ThreeFold Grid offers a decentralized and sustainable alternative to traditional cloud infrastructure. 
 
-
 It aligns perfectly with Web3 principles like decentralization, privacy, and self-sovereignty.
 
-#### **Key Features of the ThreeFold Grid**
+## Key Features of the ThreeFold Grid
 - **Decentralization:** Workloads are distributed across independent nodes owned by individuals or organizations, avoiding reliance on centralized cloud providers.
 - **Sustainability:** Built on energy-efficient hardware and a commitment to environmental sustainability.
 - **Data Sovereignty:** Users retain full control over their data, with no intermediaries involved.
 
-
+<!--
-
 > TODO: explain how its easy to deploy e.g. validators, blockchains on top of the TFGrid.
-
+-->
 
 > [All required information can be found in our ThreeFold V3 Manual.](https://manual.grid.tf/documentation/system_administrators/system_administrators.html)

docs/howtouse/_category_.json

@@ -3,6 +3,6 @@
   "position": 6,
   "link": {
     "type": "generated-index",
-    "description": "How can use the ThreeFold Grid."
+    "description": "How to use the ThreeFold Grid."
   }
 }

docs/tech.md

@@ -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**
+- **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.