refactor: Rework the 'Introduction' & 'Getting Started' page

.vitepress/sidebar.ts

@@ -188,14 +188,6 @@ export function getSidebar() {
       {
         text: 'USE AN iAPP',
         items: [
-          {
-            text: 'Introduction',
-            link: '/guides/use-iapp/introduction',
-          },
-          {
-            text: 'Getting Started',
-            link: '/guides/use-iapp/getting-started',
-          },
           {
             text: 'How to Pay the Executions',
             link: '/guides/use-iapp/how-to-pay-executions',

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

@@ -12,35 +12,37 @@
 
 ## SpeedRun The Protocol
 
-### Step 1: Protect Data
+![iExec Deal Lifecycle](/assets/overview/deal-lifecycle.png)
 
-Your sensitive data gets encrypted and stored online. Only you control who can
-access it.
+### Step 1: Prepare Resources
 
-→ **DevTool**: [DataProtector](/references/dataProtector) handles this for you
+- **Data Provider** protects sensitive data with encryption and sets access
+  rules.
+  - → **DevTool**: [DataProtector](/references/dataProtector)
+- **App Provider** deploys an iApp to process data securely.
+  - → **DevTool**: [iApp Generator](/references/iapp-generator)
 
-### Step 2: Secure Computing (Workers)
+### Step 2: Create a Deal
 
-Code runs inside **secure enclaves** (Trusted Execution Environments - 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.
+**Requester** submits a computation request. The **PoCo smart contract**
+automatically matches and brings together all required resources: the iApp,
+protected data, and available workerpool.
 
-### Step 3: Run iApp
+→ **Guides**:
+[Run iApp with ProtectedData](/guides/use-iapp/run-iapp-with-ProtectedData),
+[Run iApp without ProtectedData](/guides/use-iapp/run-iapp-without-ProtectedData)
 
-You submit a **Task** = "Run this iApp on this protected data". The protocol
-finds available workers and executes everything confidentially.
+### Step 3: Execute in TEE
 
-→ **DevTool**: [iApp Generator](/references/iapp-generator) helps you create and
-deploy iApp
+**Workers** from the selected workerpool download the iApp and execute it inside
+**secure enclaves** (TEEs). Your data is processed confidentially - workers can
+run computations but never access raw data outside the TEE.
 
-### Step 4: Get Results
+### Step 4: Deliver Results & Pay
 
-Results come back **encrypted to you**. Workers never see raw data, you never
-lose control.
-
-```
-Protected Data + iApp + Worker = Task → Encrypted Result
-```
+Results are encrypted and delivered back to the requester. **RLC tokens** are
+automatically distributed to all participants (app provider, data provider,
+workerpool) based on their contribution.
 
 ## What each piece does
 

src/guides/build-iapp/advanced/quick-start.md

@@ -18,6 +18,9 @@ test blockchain.
 
 ## Install the iExec SDK
 
+For complete installation instructions and requirements, see the
+[iExec SDK documentation](/references/sdk).
+
 Requirements:
 [![npm version](https://img.shields.io/badge/nodejs-%3E=18.0.0-brightgreen.svg)](https://nodejs.org/en/)
 

src/guides/build-iapp/advanced/result-callback.md

@@ -106,8 +106,8 @@
 After completion, the protocol calls your contract, passing the `callback-data`
 bytes.
 
-First install the iExec SDK if you have not already (see
-[Getting Started](/guides/use-iapp/getting-started)).
+First install the iExec SDK if you have not already (see the
+[iExec SDK documentation](/references/sdk)).
 
 ```ts twoslash
 import { IExec, utils } from 'iexec';

src/guides/build-iapp/build-&-test.md

@@ -29,9 +29,28 @@ iApp Generator handles all the low-level complexity for you.
 
 ## Prerequisites
 
-Before getting started, make sure you have the required tools installed. See the
-[iApp Generator Getting Started guide](/references/iapp-generator/getting-started)
-for detailed prerequisites and installation instructions.
+First, install iApp Generator in your project (for more details see
+[iApp Generator Getting Started](/references/iapp-generator/getting-started)):
+
+::: code-group
+
+```bash [npm]
+npm install -g @iexec/iapp-generator
+```
+
+```bash [yarn]
+yarn global add @iexec/iapp-generator
+```
+
+```bash [pnpm]
+pnpm add -g @iexec/iapp-generator
+```
+
+```bash [bun]
+bun add -g @iexec/iapp-generator
+```
+
+:::
 
 ## Quick Start
 

src/guides/build-iapp/inputs.md

@@ -27,7 +27,8 @@
 ::: tip
 
 You can also execute iApp outside of DataProtector using other methods. See the
-[Use an iApp guide](/guides/use-iapp/introduction) for more information.
+[Run iApp without ProtectedData](/guides/use-iapp/run-iapp-without-ProtectedData)
+guide for more information.
 
 :::
 

src/guides/build-iapp/manage-access.md

@@ -28,7 +28,7 @@
 shows you how to use the iExec SDK CLI to create and manage your app orders.
 
 For complete SDK documentation, check the
-[iExec SDK GitHub repository](https://github.com/iExecBlockchainComputing/iexec-sdk).
+[iExec SDK documentation](/references/sdk).
 
 :::
 
@@ -67,7 +67,8 @@
 ### Step 1: Install the iExec SDK
 
 Since iApp Generator doesn't handle orders yet, you need to use the iExec SDK
-CLI:
+CLI. For detailed installation instructions, see the
+[iExec SDK documentation](/references/sdk).
 
 ::: code-group
 
@@ -304,8 +305,7 @@
 
 ### Technical deep dive
 
-- **[iExec SDK Documentation](https://github.com/iExecBlockchainComputing/iexec-sdk)** -
-  Complete CLI reference
+- **[iExec SDK Documentation](/references/sdk)** - Complete CLI reference
 
 <script setup>
 import { computed } from 'vue';

src/guides/build-iapp/outputs.md

@@ -145,5 +145,3 @@ Continue building with these guides:
   Control who can use your iApp
 - **[Debugging Your iApp](/guides/build-iapp/debugging)** - Troubleshoot
   execution issues
-- **[How to Get and Decrypt Results](/guides/use-iapp/getting-started)** -
-  User-side result handling

src/guides/manage-data/manage-access.md

@@ -13,9 +13,10 @@ DataProtector lets you encrypt data and control access through orders -
 specifying who can use it, how many times, and at what price. Protected data is
 only accessible in secure enclaves (TEEs) by authorized users and iApp.
 
-## Installation
+## Prerequisites
 
-First, install DataProtector in your project:
+First, install DataProtector in your project (for more details see
+[DataProtector Getting Started](/references/dataProtector/getting-started)):
 
 ::: code-group
 

src/guides/use-iapp/run-iapp-with-ProtectedData.md

@@ -14,6 +14,31 @@ inputs that come directly from you (the requester) and can change between each
 execution: Arguments, Input Files, and Secrets. These non-persistent inputs are
 perfect for customizing the iApp's behavior for each specific run.
 
+## Prerequisites
+
+First, install DataProtector in your project (for more details see
+[DataProtector Getting Started](/references/dataProtector/getting-started)):
+
+::: code-group
+
+```bash [npm]
+npm install @iexec/dataprotector
+```
+
+```bash [yarn]
+yarn add @iexec/dataprotector
+```
+
+```bash [pnpm]
+pnpm add @iexec/dataprotector
+```
+
+```bash [bun]
+bun add @iexec/dataprotector
+```
+
+:::
+
 ## Adding Protected Data
 
 When working with protected data that contains multiple files, you can specify

src/guides/use-iapp/run-iapp-without-ProtectedData.md

@@ -16,7 +16,8 @@ configuration to enable processing and customize functionality.
 
 ## Prerequisites
 
-Before you begin, make sure you have the iExec SDK installed.
+First, install iExec SDK in your project (for more details see
+[iExec SDK documentation](/references/sdk)):
 
 ::: code-group
 

src/index.md

@@ -134,7 +134,7 @@ features:
     details:
       Execute privacy-preserving apps like Web3Mail and Web3Telegram. Use what
       others built, extend what you need.
-    link: /guides/use-iapp/introduction
+    link: /guides/use-iapp/run-iapp-with-ProtectedData
   - icon:
       <svg class="_fill" width="37" height="36" viewBox="0 0 37 36" fill="none"
       xmlns="http://www.w3.org/2000/svg"> <path d="M35.2516 10.9932C34.345