split input-output into two files

aimen-djari · aimen-djari · commit 68a9cbaac172 · 2025-08-26T17:12:42.000+01:00
diff --git a/.vitepress/sidebar.ts b/.vitepress/sidebar.ts
@@ -137,8 +137,12 @@ export function getSidebar() {
             link: '/guides/build-iapp/manage-access',
           },
           {
-            text: 'Inputs and Outputs',
-            link: '/guides/build-iapp/inputs-and-outputs',
+            text: 'Inputs',
+            link: '/guides/build-iapp/inputs',
+          },
+          {
+            text: 'Outputs',
+            link: '/guides/build-iapp/outputs',
           },
 
           {
diff --git a/src/guides/build-iapp/advanced/access-confidential-assets.md b/src/guides/build-iapp/advanced/access-confidential-assets.md
@@ -31,7 +31,7 @@ The SMS currently supports 3 types of secrets:
    variable. It is owned by the developer of the application. It can be any kind
    of data (API key, private key, token, ..) as long as it respects the size
    limit (max. 4096 kB).
-2. [Requester secrets](/guides/build-iapp/inputs-and-outputs#access-requester-secrets):
+2. [Requester secrets](/guides/build-iapp/inputs#access-requester-secrets):
    These secrets are directly accessible from the application as environment
    variables, as long as the requester has decided to share them with it. These
    secrets can be any kind of data as long as they respect the size limit (max.
@@ -63,4 +63,4 @@ graph TD
 You now understand how these three kinds of confidential assets work on iExec,
 you can go one step further by learning how to manipulate them:
 
-- [Access to a Protected Data](/guides/build-iapp/inputs-and-outputs)
+- [Access to a Protected Data](/guides/build-iapp/inputs#protected-data)
diff --git a/src/guides/build-iapp/advanced/build-your-first-tdx-iapp.md b/src/guides/build-iapp/advanced/build-your-first-tdx-iapp.md
@@ -276,7 +276,8 @@ EXPERIMENTAL_TDX_APP=true iapp run <app-address>
 
 - **[Debugging Your iApp](/guides/build-iapp/debugging)** - Troubleshoot
   execution issues and TDX-specific problems
-- **[Inputs and Outputs](/guides/build-iapp/inputs-and-outputs)** - Handle data
+- **[Inputs](/guides/build-iapp/inputs)** - Handle data inputs
+- **[Outputs](/guides/build-iapp/outputs)** - Handle data outputs
   in TEE environment with TDX
 - **[iApp Access Control and Pricing](/guides/build-iapp/manage-access)** -
   Configure access control for your TDX applications
diff --git a/src/guides/build-iapp/debugging.md b/src/guides/build-iapp/debugging.md
@@ -169,7 +169,8 @@ except Exception as e:
 
 Continue improving your iApp:
 
-- **[Inputs and Outputs](/guides/build-iapp/inputs-and-outputs)** - Handle data
+- **[Inputs](/guides/build-iapp/inputs)** - Handle data inputs
+- **[Outputs](/guides/build-iapp/outputs)** - Handle data outputs
   in TEE
-- **[How to Get and Decrypt Results](/guides/build-iapp/inputs-and-outputs)** -
+- **[How to Get and Decrypt Results](/guides/build-iapp/outputs)** -
   Retrieve results
diff --git a/src/guides/build-iapp/inputs.md b/src/guides/build-iapp/inputs.md
@@ -1,19 +1,19 @@
 ---
-title: Inputs and Outputs
+title: Inputs
 description:
-  Understand the different input types and output formats for iApp in the TEE
+  Understand the different input types available to your iApp in the TEE
   environment
 ---
 
-# 📥📤 Inputs and Outputs
+# 📥 Inputs
 
 **Your iApp runs inside a secure TEE environment with access to different types
 of inputs.** Understanding what data you can access, how to access it, and when
 to use each type is crucial for building effective privacy-preserving
 applications.
 
-This guide covers all input types available to your iApp and how to generate
-proper outputs that users can retrieve and decrypt.
+This guide covers all input types available to your iApp and how to access them
+within the TEE environment.
 
 ## Two Perspectives on Inputs
 
@@ -356,124 +356,6 @@ const processProtectedDataResponse =
   });
 ```
 
-## Creating Outputs
-
-Your iApp must generate outputs in the `IEXEC_OUT` directory. **Every iApp must
-create a `computed.json` file** with metadata about the computation.
-
-### Basic Output Structure
-
-::: code-group
-
-```python [Python]
-import os
-import json
-
-# Get output directory
-iexec_out = os.environ['IEXEC_OUT']
-
-# Create your result file
-result_data = {
-    "analysis": "positive sentiment",
-    "confidence": 0.92,
-    "processed_at": "2024-01-15T10:30:00Z"
-}
-
-# Save main result
-with open(f"{iexec_out}/result.json", 'w') as f:
-    json.dump(result_data, f)
-
-# REQUIRED: Create `computed.json` metadata
-computed_metadata = {
-    "deterministic-output-path": f"{iexec_out}/result.json",
-    "execution-timestamp": "2024-01-15T10:30:00Z",
-    "app-version": "1.0.0"
-}
-
-with open(f"{iexec_out}/computed.json", 'w') as f:
-    json.dump(computed_metadata, f)
-```
-
-```javascript [JavaScript]
-const fs = require('fs');
-const path = require('path');
-
-// Get output directory
-const iexecOut = process.env.IEXEC_OUT;
-
-// Create your result file
-const resultData = {
-  analysis: 'positive sentiment',
-  confidence: 0.92,
-  processed_at: '2024-01-15T10:30:00Z',
-};
-
-// Save main result
-fs.writeFileSync(
-  path.join(iexecOut, 'result.json'),
-  JSON.stringify(resultData, null, 2)
-);
-
-// REQUIRED: Create computed.json metadata
-const computedMetadata = {
-  'deterministic-output-path': path.join(iexecOut, 'result.json'),
-  'execution-timestamp': '2024-01-15T10:30:00Z',
-  'app-version': '1.0.0',
-};
-
-fs.writeFileSync(
-  path.join(iexecOut, 'computed.json'),
-  JSON.stringify(computedMetadata, null, 2)
-);
-```
-
-:::
-
-### Output Best Practices
-
-1. **Always create `computed.json`** - This is mandatory
-2. **Use descriptive filenames** - `analysis_result.json`, not `output.txt`
-3. **Include metadata** - Timestamps, versions, parameters used
-4. **Structure your data** - Use JSON for structured results
-5. **Keep files reasonable** - Large outputs increase retrieval time and may hit
-   memory limits
-6. **Memory awareness** - TEE enclave memory is limited, avoid generating
-   multi-GB outputs
-
-### Example: Multi-file Output
-
-```python
-import os
-import json
-
-iexec_out = os.environ['IEXEC_OUT']
-
-# Create multiple output files
-summary = {"total_processed": 1000, "success_rate": 0.95}
-with open(f"{iexec_out}/summary.json", 'w') as f:
-    json.dump(summary, f)
-
-# Create a detailed report
-with open(f"{iexec_out}/detailed_report.txt", 'w') as f:
-    f.write("Detailed analysis results...\n")
-
-# Create visualization data
-chart_data = {"labels": ["A", "B", "C"], "values": [10, 20, 30]}
-with open(f"{iexec_out}/chart_data.json", 'w') as f:
-    json.dump(chart_data, f)
-
-# Required metadata file
-computed = {
-    "deterministic-output-path": f"{iexec_out}/summary.json",
-    "additional-files": [
-        f"{iexec_out}/detailed_report.txt",
-        f"{iexec_out}/chart_data.json"
-    ]
-}
-with open(f"{iexec_out}/computed.json", 'w') as f:
-    json.dump(computed, f)
-```
-
 ## Testing Inputs Locally
 
 Use iApp Generator to test different input types:
@@ -595,13 +477,13 @@ save_report(report)
 
 ## What's Next?
 
-**You now understand all input types and output requirements!**
+**You now understand all input types available to your iApp!**
 
 Continue building with these guides:
 
+- **[Outputs](/guides/build-iapp/outputs)** - Learn how to generate and structure
+  your iApp outputs
 - **[App Access Control and Pricing](/guides/build-iapp/manage-access)** -
   Control who can use your iApp
 - **[Debugging Your iApp](/guides/build-iapp/debugging)** - Troubleshoot
   execution issues
-- **[How to Get and Decrypt Results](/guides/build-iapp/inputs-and-outputs)** -
-  User-side result handling
diff --git a/src/guides/build-iapp/outputs.md b/src/guides/build-iapp/outputs.md
@@ -0,0 +1,148 @@
+---
+title: Outputs
+description:
+  Learn how to generate and structure outputs from your iApp in the TEE
+  environment
+---
+
+# 📤 Outputs
+
+**Your iApp must generate outputs that users can retrieve and decrypt.** Understanding
+how to structure your outputs, create the required metadata, and follow best
+practices is essential for building effective privacy-preserving applications.
+
+This guide covers how to generate outputs from your iApp and ensure they can be
+properly retrieved by users.
+
+## Creating Outputs
+
+Your iApp must generate outputs in the `IEXEC_OUT` directory. **Every iApp must
+create a `computed.json` file** with metadata about the computation.
+
+### Basic Output Structure
+
+::: code-group
+
+```python [Python]
+import os
+import json
+
+# Get output directory
+iexec_out = os.environ['IEXEC_OUT']
+
+# Create your result file
+result_data = {
+    "analysis": "positive sentiment",
+    "confidence": 0.92,
+    "processed_at": "2024-01-15T10:30:00Z"
+}
+
+# Save main result
+with open(f"{iexec_out}/result.json", 'w') as f:
+    json.dump(result_data, f)
+
+# REQUIRED: Create `computed.json` metadata
+computed_metadata = {
+    "deterministic-output-path": f"{iexec_out}/result.json",
+    "execution-timestamp": "2024-01-15T10:30:00Z",
+    "app-version": "1.0.0"
+}
+
+with open(f"{iexec_out}/computed.json", 'w') as f:
+    json.dump(computed_metadata, f)
+```
+
+```javascript [JavaScript]
+const fs = require('fs');
+const path = require('path');
+
+// Get output directory
+const iexecOut = process.env.IEXEC_OUT;
+
+// Create your result file
+const resultData = {
+  analysis: 'positive sentiment',
+  confidence: 0.92,
+  processed_at: '2024-01-15T10:30:00Z',
+};
+
+// Save main result
+fs.writeFileSync(
+  path.join(iexecOut, 'result.json'),
+  JSON.stringify(resultData, null, 2)
+);
+
+// REQUIRED: Create computed.json metadata
+const computedMetadata = {
+  'deterministic-output-path': path.join(iexecOut, 'result.json'),
+  'execution-timestamp': '2024-01-15T10:30:00Z',
+  'app-version': '1.0.0',
+};
+
+fs.writeFileSync(
+  path.join(iexecOut, 'computed.json'),
+  JSON.stringify(computedMetadata, null, 2)
+);
+```
+
+:::
+
+### Output Best Practices
+
+1. **Always create `computed.json`** - This is mandatory
+2. **Use descriptive filenames** - `analysis_result.json`, not `output.txt`
+3. **Include metadata** - Timestamps, versions, parameters used
+4. **Structure your data** - Use JSON for structured results
+5. **Keep files reasonable** - Large outputs increase retrieval time and may hit
+   memory limits
+6. **Memory awareness** - TEE enclave memory is limited, avoid generating
+   multi-GB outputs
+
+### Example: Multi-file Output
+
+```python
+import os
+import json
+
+iexec_out = os.environ['IEXEC_OUT']
+
+# Create multiple output files
+summary = {"total_processed": 1000, "success_rate": 0.95}
+with open(f"{iexec_out}/summary.json", 'w') as f:
+    json.dump(summary, f)
+
+# Create a detailed report
+with open(f"{iexec_out}/detailed_report.txt", 'w') as f:
+    f.write("Detailed analysis results...\n")
+
+# Create visualization data
+chart_data = {"labels": ["A", "B", "C"], "values": [10, 20, 30]}
+with open(f"{iexec_out}/chart_data.json", 'w') as f:
+    json.dump(chart_data, f)
+
+# Required metadata file
+computed = {
+    "deterministic-output-path": f"{iexec_out}/summary.json",
+    "additional-files": [
+        f"{iexec_out}/detailed_report.txt",
+        f"{iexec_out}/chart_data.json"
+    ]
+}
+with open(f"{iexec_out}/computed.json", 'w') as f:
+    json.dump(computed, f)
+```
+
+## What's Next?
+
+**You now understand how to generate proper outputs from your iApp!**
+
+Continue building with these guides:
+
+- **[Inputs](/guides/build-iapp/inputs)** - Learn about the different input types
+  available to your iApp
+- **[App Access Control and Pricing](/guides/build-iapp/manage-access)** -
+  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
diff --git a/src/guides/manage-data/handle-schemas-dataset-types.md b/src/guides/manage-data/handle-schemas-dataset-types.md
@@ -253,7 +253,7 @@ don't match, you'll get runtime errors when processing the data.
 :::
 
 → **Ready to build an iApp?** Check out our detailed
-[Inputs and Outputs guide](/guides/build-iapp/inputs-and-outputs) to learn how
+[Inputs guide](/guides/build-iapp/inputs) to learn how
 to access schema fields inside your iApp using the deserializer.
 
 ## Next Steps
diff --git a/src/protocol/ai.md b/src/protocol/ai.md
@@ -169,7 +169,8 @@ docker run --rm hello-pytorch
   application
 - **[Build Intel TDX App](/guides/build-iapp/advanced/build-your-first-tdx-iapp)** -
   TDX applications for AI workloads
-- **[Inputs and Outputs](/guides/build-iapp/inputs-and-outputs)** - Handle data
+- **[Inputs](/guides/build-iapp/inputs)** - Handle data inputs
+- **[Outputs](/guides/build-iapp/outputs)** - Handle data outputs
   flow in TEE environment
 
 ### Explore Examples
diff --git a/src/references/iapp-generator.md b/src/references/iapp-generator.md
diff --git a/src/references/iapp-generator/building-your-iexec-app.md b/src/references/iapp-generator/building-your-iexec-app.md

Original file line number	Diff line number	Diff line change
`@@ -137,8 +137,12 @@ export function getSidebar() {`
`137`	`137`	`link: '/guides/build-iapp/manage-access',`
`138`	`138`	`},`
`139`	`139`	`{`
`140`		`- text: 'Inputs and Outputs',`
`141`		`- link: '/guides/build-iapp/inputs-and-outputs',`
	`140`	`+ text: 'Inputs',`
	`141`	`+ link: '/guides/build-iapp/inputs',`
	`142`	`+ },`
	`143`	`+ {`
	`144`	`+ text: 'Outputs',`
	`145`	`+ link: '/guides/build-iapp/outputs',`
`142`	`146`	`},`
`143`	`147`
`144`	`148`	`{`