feat: Refactor iApp, Protected Data, and Workerpool docs (#37)

Co-authored-by: Le-Caignec <[email protected]>

Author: 64ix

.github/styles/config/vocabularies/Technical/accept.txt

@@ -125,8 +125,10 @@ ethereum
 intel
 nano
 workerpool
+Workerpool
 protectedData
 dataProtector
+DataProtector
 iApp
 sconification
 middleware

.vitepress/sidebar.ts

@@ -56,20 +56,20 @@ export function getSidebar() {
         text: 'iExec OVERVIEW',
         items: [
           {
-            text: '❓ What is iExec ?',
+            text: 'What is iExec ?',
             link: '/get-started/overview/what-is-iexec',
           },
           {
-            text: '❓  What is Protected Data ?',
-            link: '/get-started/overview/what-is-protected-data',
+            text: 'Protected Data',
+            link: '/get-started/overview/protected-data',
           },
           {
-            text: '❓ What is an iApp ?',
-            link: '/get-started/overview/what-is-iapp',
+            text: 'iApp',
+            link: '/get-started/overview/iapp',
           },
           {
-            text: '❓ What is a Workerpool ?',
-            link: '/get-started/overview/what-is-workerpool',
+            text: 'Workerpool',
+            link: '/get-started/overview/workerpool',
           },
           {
             text: '🪙 RLC Token',

README.md

@@ -246,6 +246,7 @@ for input parameters:
 - migrate github iexec SDK doc here
 - migrate pay-per-task page into a guide
 - check pages (introduction & getting-started) for use-iapp guide
+- Schema what is iexec to do and implement
 - explain TDX vs SGX
 - Give recap of Workerpool address fo chains
 - Talk about ENS on Bellecour(it's not supported on arbitrum)

src/get-started/overview/what-is-iapp.md renamed to src/get-started/overview/iapp.md

@@ -6,7 +6,7 @@ description:
   AI, data analysis, and Web3 apps.
 ---
 
-# 🚀 What is an iApp?
+# iApp
 
 An iExec Application (iApp) brings Turnkey Privacy to your regular application
 code. Your Python scripts, AI models, or data processors can securely process
@@ -22,19 +22,15 @@ Imagine you want to build:
 <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 mb-6">
   <div class="flex flex-col gap-2.5">
     <div class="flex items-center gap-2 text-base">
-      <span>🤖</span>
       <span>An AI that analyzes personal health data</span>
     </div>
     <div class="flex items-center gap-2 text-base">
-      <span>📧</span>
       <span>An email tool that needs access to contact lists</span>
     </div>
     <div class="flex items-center gap-2 text-base">
-      <span>💰</span>
       <span>A financial advisor that processes bank statements</span>
     </div>
     <div class="flex items-center gap-2 text-base">
-      <span>🛡️</span>
       <span>A content filter that reads private messages</span>
     </div>
   </div>
@@ -105,19 +101,19 @@ the TEE execution environment.
 
 <div class="grid grid-cols-1 md:grid-cols-2 gap-4 mb-6">
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-4">
-    <h4 class="text-lg font-semibold mb-2">🏥 Healthcare</h4>
+    <h4 class="text-lg font-semibold mb-2">Healthcare</h4>
     <p class="text-sm m-0">Process medical data for AI diagnosis without exposing patient information</p>
   </div>
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-4">
-    <h4 class="text-lg font-semibold mb-2">💰 Finance</h4>
+    <h4 class="text-lg font-semibold mb-2">Finance</h4>
     <p class="text-sm m-0">Analyze financial data for credit scoring while maintaining privacy</p>
   </div>
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-4">
-    <h4 class="text-lg font-semibold mb-2">🎬 Media</h4>
+    <h4 class="text-lg font-semibold mb-2">Media</h4>
     <p class="text-sm m-0">Content recommendation engines that don't track user behavior</p>
   </div>
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-4">
-    <h4 class="text-lg font-semibold mb-2">🔬 Research</h4>
+    <h4 class="text-lg font-semibold mb-2">Research</h4>
     <p class="text-sm m-0">Collaborative research on sensitive datasets across institutions</p>
   </div>
 </div>

src/get-started/overview/what-is-protected-data.md renamed to src/get-started/overview/protected-data.md

@@ -6,7 +6,7 @@ description:
   controls, and secure data monetization.
 ---
 
-# ❓ What is Protected Data?
+# Protected Data
 
 Protected Data refers to any data encrypted using the **iExec Data Protector
 tool**. This Turnkey Privacy encryption solution enables users to protect,
@@ -18,7 +18,7 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
 
 ## Key Concepts
 
-### 👑 Data Governance
+### Data Governance
 
 <div class="mb-4"></div>
 
@@ -45,7 +45,7 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
   </div>
 </div>
 
-### 🔒 Privacy-preserving Computation
+### Privacy-preserving Computation
 
 <div class="mb-4"></div>
 
@@ -72,7 +72,7 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
   </div>
 </div>
 
-### 💰 Monetization
+### Monetization
 
 <div class="mb-4"></div>
 
@@ -141,7 +141,6 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
 <div class="grid grid-cols-1 md:grid-cols-2 gap-6 my-6">
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 flex flex-col gap-2">
     <div class="flex items-baseline gap-2 text-lg">
-      <span>👤</span>
       <h3 class="font-semibold m-0!">Personal Data</h3>
     </div>
     <ul class="list-disc ml-6">
@@ -153,7 +152,6 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
 
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 flex flex-col gap-2">
     <div class="flex items-baseline gap-2 text-lg">
-      <span>🏢</span>
       <h3 class="font-semibold m-0!">Business Intelligence</h3>
     </div>
     <ul class="list-disc ml-6">
@@ -165,7 +163,6 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
 
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 flex flex-col gap-2">
     <div class="flex items-baseline gap-2 text-lg">
-      <span>🤖</span>
       <h3 class="font-semibold m-0!">AI Training</h3>
     </div>
     <ul class="list-disc ml-6">
@@ -177,7 +174,6 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
 
   <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 flex flex-col gap-2">
     <div class="flex items-baseline gap-2 text-lg">
-      <span>🔬</span>
       <h3 class="font-semibold m-0!">Research</h3>
     </div>
     <ul class="list-disc ml-6">
@@ -197,13 +193,11 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
 <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 mb-6">
   <div class="flex flex-col gap-4">
     <div class="flex items-start gap-3">
-      <span class="text-xl">📚</span>
       <div>
         <strong>Learn More:</strong> <a href="/guides/manage-data/manage-access" class="text-fuchsia-700 hover:text-fuchsia-600">Complete DataProtector Documentation</a>
       </div>
     </div>
     <div class="flex items-start gap-3">
-      <span class="text-xl">🚀</span>
       <div>
         <strong>Getting Started:</strong> <a href="/references/dataProtector/getting-started" class="text-fuchsia-700 hover:text-fuchsia-600">DataProtector Quick Start Guide</a>
       </div>

src/get-started/overview/what-is-iexec.md

@@ -10,51 +10,88 @@ description:
 iExec is a **decentralized confidential computing toolkit** that helps
 developers build privacy-preserving applications.
 
-## 🎯 **Mission**
+## The Protocol (Simple Version)
 
-iExec democratizes **confidential computing** by providing a toolkit that
-combines:
+### Step 1: Protect Data
 
-- **🔐 Privacy Protection** - Data remains encrypted during computation
-- **⚡ Scalable Computing** - Access to distributed computing resources
-- **💰 Monetization** - Fair compensation for computing providers
-- **🌐 Decentralization** - No single point of failure or control
+Your sensitive data gets encrypted and stored online. Only you control who can
+access it.
 
-## 🏗️ **Core Architecture**
+→ **DevTool**: [DataProtector](/references/dataProtector) handles this for you
 
-### **Three Main Components:**
+### Step 2: Secure Computing (Workers)
 
-1. **🤖 iApp (iExec Applications)**
-   - Confidential computing applications
-   - Run in secure enclaves (TEEs)
-   - Process encrypted data without exposing it
+Code runs inside **secure enclaves** (TEEs) on iExec workers. The worker can
+access your data to process it, but only within the privacy-safe TEE
+environment - your data never leaves the secure bubble.
 
-2. **🔐 DataProtector**
-   - End-to-end encryption solution
-   - Manage data access and sharing
-   - Monetize protected datasets
+### Step 3: Run iApp
 
-3. **⚙️ Worker Network**
-   - Distributed computing providers
-   - Execute iApp securely
-   - Earn <TokenSymbol /> tokens for contributions
+You submit a **Task** = "Run this iApp on this protected data". The protocol
+finds available workers and executes everything confidentially.
 
-## 🚀 **Key Features**
+→ **DevTool**: [iApp Generator](/references/iapp-generator) helps you create and
+deploy iApp
 
-- **TEE (Trusted Execution Environment)** support
-- **Zero-knowledge computation**
-- **Decentralized marketplace** for computing resources
-- **<TokenSymbol /> token** for payments and governance
-- **Cross-chain compatibility**
+### Step 4: Get Results
 
-## 🔗 **Get Started**
+Results come back **encrypted to you**. Workers never see raw data, you never
+lose control.
 
-Ready to explore iExec? Check out:
+```
+Protected Data + iApp + Worker = Task → Encrypted Result
+```
 
-- [What is Protected Data?](/get-started/overview/what-is-protected-data)
-- [What is an iApp?](/get-started/overview/what-is-iapp)
-- [Hello World Tutorial](/get-started/helloWorld)
+## What Each Piece Does
 
-<script setup>
-import TokenSymbol from '@/components/TokenSymbol.vue'
-</script>
+### **Protected Data**
+
+Your data, encrypted. You set the rules: "Only these apps can use it, only for
+these purposes."
+
+### **iApp**
+
+Your code, packaged to run on workers. Can be AI models, data processing
+scripts, any computation.
+
+### **Workers (Secure Enclaves)**
+
+Computers that process your data inside privacy-safe TEE environments. They can
+access your data to work with it, but the TEE ensures it stays confidential and
+tamper-proof.
+
+### **Deals**
+
+The execution instruction that unifies the entire flow: "Run this iApp on this
+Protected Data using a TEE Worker, then return the encrypted result to me." The
+protocol takes care of worker allocation and secure coordination.
+
+## Real Example Walkthrough
+
+**AI Model Training (Private)**
+
+1. **Protect**: Medical researchers upload patient data → becomes Protected Data
+2. **Deploy**: AI company packages their model → becomes iApp
+3. **Execute**: Someone submits Task → "Train model on this data"
+4. **Result**: Model gets trained, researcher gets insights, raw data never
+   leaves enclave
+
+**Web3 Email**
+
+1. **Protect**: Users upload email contacts → Protected Data
+2. **Execute**: App submits Task → "Send email via Web3Mail iApp"
+3. **Result**: Email sent, addresses stay private, sender/receiver authenticated
+
+## Start Building
+
+Now that you get the protocol, pick your devtools:
+
+- **Quick Win**: Add [Web3Mail](/references/web3mail) or
+  [Web3Telegram](/references/web3telegram) to your project ! (uses the protocol
+  under the hood)
+- **Protect Data**: Try [DataProtector](/references/dataProtector) to encrypt
+  your first dataset
+- **Build iApp**: Create confidential compute with
+  [iApp Generator](/references/iapp-generator)
+- **Hands-On**: Follow our [Hello World](/get-started/helloWorld) to see all
+  devtools working together