iExecBlockchainComputing · Le-Caignec · Aug 5, 2025 · Aug 5, 2025 · Aug 5, 2025 · Aug 5, 2025
diff --git a/.vitepress/config.mts b/.vitepress/config.mts
@@ -88,7 +88,7 @@ export default defineConfig({
       { text: 'Protect Data', link: '/manage-data/what-is-protected-data' },
       { text: 'Build iApp', link: '/build-iapp/what-is-iapp' },
       { text: 'Use iApp', link: '/use-iapp/introduction' },
-      { text: 'Core Concept', link: '/core-concept/glossary' },
+      { text: 'Protocol', link: '/protocol/sdk' },
     ],
     outline: {
       level: [2, 4],

diff --git a/.vitepress/sidebar.ts b/.vitepress/sidebar.ts
@@ -411,7 +411,6 @@ export function getSidebar() {
           { text: '🚀 Getting Started', link: '/use-iapp/getting-started' },
           {
             text: '📖 Guides',
-            link: '/use-iapp/guides',
             items: [
               {
                 text: 'Different ways to execute an iApp',
@@ -423,11 +422,11 @@ export function getSidebar() {
               },
               {
                 text: 'Use iApp with Protected Data',
-                link: '/use-iapp/use-iapp-with-protected-data',
+                link: '/use-iapp/guides/use-iapp-with-protected-data',
               },
               {
                 text: 'Find iApps to Use',
-                link: '/use-iapp/find-iapps',
+                link: '/use-iapp/guides/find-iapps',
               },
               {
                 text: 'How to pay the executions',
@@ -437,23 +436,22 @@ export function getSidebar() {
           },
           {
             text: '💰 How to Pay',
-            link: '/use-iapp/payment',
             items: [
               {
                 text: 'How to Pay for Web3mail',
-                link: '/overview/how-to-pay-for-web3mail',
+                link: '/use-iapp/how-to-pay/how-to-pay-for-web3mail',
               },
               {
                 text: 'How to Pay for Web3telegram',
-                link: '/use-iapp/web3telegram/how-to-pay-for-web3telegram',
+                link: '/use-iapp/how-to-pay/how-to-pay-for-web3telegram',
               },
               {
                 text: 'Pricing Considerations',
-                link: '/overview/pricing-considerations',
+                link: '/use-iapp/how-to-pay/pricing-considerations',
               },
               {
-                text: 'Voucher Authorization Guide',
-                link: '/use-iapp/voucher-guide',
+                text: 'Voucher',
+                link: '/use-iapp/how-to-pay/voucher',
               },
             ],
           },
@@ -563,21 +561,21 @@ export function getSidebar() {
         ],
       },
     ],
-    '/core-concept/': [
+    '/protocol/': [
       {
-        text: 'CORE CONCEPTS',
+        text: 'PROTOCOL',
         items: [
           {
             text: '🔧&nbsp;&nbsp;iExec SDK',
-            link: '/core-concept/sdk',
+            link: '/protocol/sdk',
           },
           {
             text: '⚙️&nbsp;&nbsp;Workers & Workerpools',
-            link: '/core-concept/workers',
+            link: '/protocol/workers',
           },
           {
             text: '📖&nbsp;&nbsp;Glossary',
-            link: '/core-concept/glossary',
+            link: '/protocol/glossary',
           },
         ],
       },

diff --git a/README.md b/README.md
@@ -148,6 +148,7 @@ Fork this repository and ensure you're working on the `main` branch:
 
 ## TODO
 
+- Add an audit section
 - Add Arbitrum support
 - On arbitrum hide : Oracle Factory ? , DataProtector Sharing ??
 - Adapt hardcoded address to feat with new contracts deployed on arbitrum
@@ -159,4 +160,4 @@ Fork this repository and ensure you're working on the `main` branch:
 - complete `use-iapp` section
 - complete `explorer` section
 - complete `build-iapp` section
-- complete `deep-dive`section
+- complete `Protocol`section
diff --git a/src/index.md b/src/index.md
@@ -43,11 +43,11 @@ features:
     details:
       Create revenue streams from your data while maintaining full control and
       privacy
-    link: /manage-data/guides/monetize-protected-data
+    link: /use-iapp/how-to-pay/how-to-pay-for-web3mail
   - icon: 🧠
-    title: Core Concepts
+    title: Protocols
     details:
       Deep dive into the core concepts of the protocol and understand how iExec
       enables privacy, governance, and monetization
-    link: /core-concept/sdk
+    link: /protocol/sdk
 ---
diff --git a/src/overview/helloWorld/1-overview.md b/src/overview/helloWorld/1-overview.md
@@ -84,7 +84,7 @@ Computing</a></span> technologies.
 
 iExec combines three fundamental elements that work together seamlessly:
 
-#### 1. Protect data with our devtool [DataProtector](../../tools/dataProtector/getting-started)
+#### 1. Protect data with our devtool [DataProtector](../../manage-data/dataProtector/getting-started)
 
 - Encrypt your sensitive data and store it securely on Arweave or IPFS
 - Only you control who can access it and when

diff --git a/src/overview/helloWorld/2-protectData.md b/src/overview/helloWorld/2-protectData.md
@@ -118,10 +118,26 @@ simple through our developer tools.
     <p><strong>1. Install the Developer Tool</strong></p>
     <p>Run the install command:</p>
 
-```sh
+::: code-group
+
+```sh [npm]
 npm install @iexec/dataprotector
 ```
 
+```sh [yarn]
+yarn add @iexec/dataprotector
+```
+
+```sh [pnpm]
+pnpm add @iexec/dataprotector
+```
+
+```sh [bun]
+bun add @iexec/dataprotector
+```
+
+:::
+
   </div>
   <div>
     <p><strong>2. Import and Initialize it in your project</strong></p>

diff --git a/src/overview/helloWorld/3-buildIApp.md b/src/overview/helloWorld/3-buildIApp.md
@@ -8,7 +8,7 @@ import InfoIcon from '../../components/InfoIcon.vue'
 
 <div class="bg-gradient-to-r from-[#fcd15a] to-[#ffad4d] rounded-[6px] px-8 pb-4 text-gray-800 max-w-3xl mx-auto mb-6">
   <h2 class="text-2xl font-bold mt-0 border-none!">Time to build!</h2>
-  <p>Let's build an iApp that can process protected data in a secure environment using the <a href="../../tools/iapp-generator" target="_blank">iExec iApp generator tool</a>. This tool helps you create, test and deploy iApps with just a few commands.</p>
+  <p>Let's build an iApp that can process protected data in a secure environment using the <a href="../../build-iapp/iapp-generator" target="_blank">iExec iApp generator tool</a>. This tool helps you create, test and deploy iApps with just a few commands.</p>
 </div>
 
 If you wanna explore and deep dive in the CLI. You can check the
@@ -56,33 +56,49 @@ Here are some popular use cases:
 Send privacy-preserving emails to registered Ethereum account holders without
 knowing or storing their email addresses.
 [Github](https://github.com/iExecBlockchainComputing/web3mail-sdk/tree/main/dapp)
-| [Documentation](../../tools/web3mail.md)
+| [Documentation](../../use-iapp/web3mail)
 
 ### 💬 Web3 Telegram
 
 Send privacy-preserving Telegram messages without knowing or storing their
 Telegram handles.
 [Github](https://github.com/iExecBlockchainComputing/web3telegram-sdk/tree/main/dapp)
-| [Documentation](../../tools/web3telegram.md)
+| [Documentation](../../use-iapp/web3telegram)
 
 ### 🌐 Content Delivery
 
 Transfer, sell or rent protected content to authorized users.
 [Github](https://github.com/iExecBlockchainComputing/dataprotector-sdk/tree/main/packages/protected-data-delivery-dapp)
-| [Documentation](../../tools/dataProtector/dataProtectorSharing)
+| [Documentation](../../manage-data/dataProtector/dataProtectorSharing)
 
 <div class="bg-gradient-to-r from-fuchsia-400/10 to-fuchsia-400/5 rounded-[6px] p-6 border-l-4 border-fuchsia-700 mb-6">
-  <p class="m-0!">These are just a few examples, the possibilities are endless. Want to explore iApp Generator? Check out our <a href="../../tools/iapp-generator" target="_blank">documentation</a> and see what you can build!</p>
+  <p class="m-0!">These are just a few examples, the possibilities are endless. Want to explore iApp Generator? Check out our <a href="../../build-iapp/iapp-generator" target="_blank">documentation</a> and see what you can build!</p>
 </div>
 
 ## 💾 Installation (win / mac / linux)
 
 First, you need to install the `iapp` package. Open your terminal and run:
 
-```sh
+::: code-group
+
+```sh [npm]
 npm i -g @iexec/iapp
 ```
 
+```sh [yarn]
+yarn global add @iexec/iapp
+```
+
+```sh [pnpm]
+pnpm add -g @iexec/iapp
+```
+
+```sh [bun]
+bun add -g @iexec/iapp
+```
+
+:::
+
 You can check if the installation was successful by running:
 
 ```sh

diff --git a/src/overview/helloWorld/4-manageDataAccess.md b/src/overview/helloWorld/4-manageDataAccess.md
@@ -108,7 +108,7 @@ Want to see it in action? Check out our
 - Track your earnings
 
 For more technical details, see the
-[DataProtector Sharing](../../tools/dataProtector/dataProtectorSharing.html)
+[DataProtector Sharing](../../manage-data/dataProtector/dataProtectorSharing)
 documentation.
 
 <div class="bg-gradient-to-r from-green-400/10 to-green-400/5 rounded-[6px] p-6 border-l-4 border-green-600 mb-6">

diff --git a/src/overview/how-to-pay-for-web3mail.md b/src/overview/how-to-pay-for-web3mail.md
diff --git a/src/overview/use-case-demo.md b/src/overview/use-case-demo.md
diff --git a/src/core-concept/glossary.md → src/protocol/glossary.md b/src/core-concept/glossary.md → src/protocol/glossary.md
diff --git a/src/core-concept/sdk.md → src/protocol/sdk.md b/src/core-concept/sdk.md → src/protocol/sdk.md
diff --git a/src/core-concept/workers.md → src/protocol/workers.md b/src/core-concept/workers.md → src/protocol/workers.md
diff --git a/src/use-iapp/guides.md b/src/use-iapp/guides.md
diff --git a/src/use-iapp/find-iapps.md → src/use-iapp/guides/find-iapps.md b/src/use-iapp/find-iapps.md → src/use-iapp/guides/find-iapps.md
diff --git a/src/use-iapp/use-iapp-with-protected-data.md → ...pp/guides/use-iapp-with-protected-data.md b/src/use-iapp/use-iapp-with-protected-data.md → ...pp/guides/use-iapp-with-protected-data.md