Skip to content

Conversation

Le-Caignec
Copy link
Collaborator

No description provided.

akugone added 5 commits August 5, 2025 10:42
…clarity

- Updated the iApp Generator section to emphasize ease of access to TEEs and quick deployment.
- Added details on project mode selection and language options for better user guidance.
…ructure

- Changed the section title from "The Technical Reality" to "The Workflow" for better alignment with user understanding.
- Enhanced the FAQ section by restructuring questions and answers for improved readability and clarity, ensuring users can easily find information about building, speed, security, deployment, and programming language support for iApps.
…ution features

- Revised the "Why This Changes Everything" section to improve clarity and emphasis on key features such as True Privacy, Verifiable Execution, Decentralized Infrastructure, and Zero Trust Architecture.
- Consolidated information for better readability and user understanding of iApp's secure processing capabilities.
Copy link

vercel bot commented Aug 5, 2025

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
documentation ✅ Ready (Inspect) Visit Preview 💬 Add feedback Aug 7, 2025 3:31pm

@Le-Caignec Le-Caignec changed the title Feature/build iapp martin feat: build iapp martin Aug 5, 2025
@Le-Caignec Le-Caignec changed the title feat: build iapp martin feat: build iapp by martin Aug 5, 2025
@Le-Caignec Le-Caignec marked this pull request as draft August 5, 2025 14:28
- Updated the "Why iApps Matter?" section to emphasize the importance of processing sensitive data securely.
- Enhanced the workflow explanation with a clearer, step-by-step visual format for better user understanding.
- Improved the presentation of key features and use cases with visually distinct sections for better readability.
- Added notes on iApp Generator capabilities and supported languages in a more accessible format.
…otected data

- Reintroduced the section on how users provide protected data, ensuring clear instructions and code examples for executing iApps.
- Improved the formatting and structure of the documentation to align with recent updates, enhancing overall readability and user understanding.
- Introduced a new section addressing potential dataset type mismatches between the frontend and iApp, outlining causes and solutions for better user guidance.
- Enhanced overall documentation clarity to assist users in debugging their iApps effectively.
…ration details

- Added a new comparison table highlighting key differences between Intel SGX and Intel TDX, including release year, enclave scope, memory size, and integration complexity.
- Enhanced the guide to clarify the benefits of TDX for heavier workloads and legacy applications, improving user understanding of its capabilities.
- Updated the section on enabling TDX in the iApp Generator for better guidance on integration.
- Added a warning section detailing the syntax for setting environment variables on different operating systems (Mac/Linux and Windows) to enhance user understanding and ensure proper configuration for TDX applications.
- Changed the Docker requirement to specify the need for a Docker hub account, enhancing user understanding of prerequisites for using the iApp Generator.
…on details

- Added instructions for configuring the iExec DataProtector SDK with the correct SMS endpoint for TDX support.
- Included a warning about changing the default worker pool in the protected Data declaration to ensure proper functionality.
to run inside secure enclaves.
An iExec Application (iApp) is your regular application code (Python script, AI
model, data processor) that can securely process protected data (created by
DataProtector) inside a privacy-safe environment called TEE (a Trusted Execution
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
DataProtector) inside a privacy-safe environment called TEE (a Trusted Execution
DataProtector) inside a confidential computing environment called TEE (a Trusted Execution

Comment on lines 15 to 17
<div class="bg-gradient-to-r from-purple-400/10 to-purple-400/5 rounded-[6px] p-6 border-l-4 border-fuchsia-700 mb-6">
<p class="m-0!"><strong>iApps let you process sensitive data while keeping it private and secure.</strong></p>
</div>
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
<div class="bg-gradient-to-r from-purple-400/10 to-purple-400/5 rounded-[6px] p-6 border-l-4 border-fuchsia-700 mb-6">
<p class="m-0!"><strong>iApps let you process sensitive data while keeping it private and secure.</strong></p>
</div>
iApps let you process sensitive data while keeping it private and secure.

it - all without you ever seeing the raw data.
<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!">An authorized user can trigger an iApp that processes someone's protected data inside this private environment. The data is used, but never exposed, not even to the person running the app.</p>
</div>

## iApp Generator: Your Development Tool
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This content shouldn’t be on this page — it’s not related to the topic in my opinion. We should move it to a guide instead.

@Le-Caignec Le-Caignec marked this pull request as ready for review August 7, 2025 08:59
- Added a new section detailing the trust benefits for users and builders, emphasizing control over data and the advantages of privacy-preserving features.
- Improved the presentation of key concepts with clearer formatting and visual elements for better user understanding.
- Deleted the section outlining trust benefits for users and builders, which included details on data control and privacy features.
- This change aims to streamline the documentation and focus on more relevant content for users.
- Updated the description of iApps to include a link to DataProtector for better context.
- Added a comma in the "How It Works" section to enhance readability and ensure proper sentence structure.
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR significantly refactors the iApp documentation structure and content to improve clarity and user experience. The changes modernize the documentation with enhanced visual elements and reorganized information flow.

Key Changes

  • Complete redesign of the "What Is an iApp?" documentation with improved visual components
  • Addition of a new "Build and Deploy an iApp" guide with practical examples
  • Enhanced TDX documentation with comparison tables and clearer configuration instructions

Reviewed Changes

Copilot reviewed 7 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
src/build-iapp/what-is-iapp.md Major redesign with modern UI components, restructured content flow, and enhanced visual elements
src/build-iapp/guides/build-&-deploy-iapp.md New comprehensive guide for building and deploying iApps with practical examples
src/build-iapp/guides/using-tdx-experimental.md Enhanced with SGX vs TDX comparison table and improved configuration instructions
src/build-iapp/guides/inputs-and-outputs.md Minor restructuring of protected data section
src/build-iapp/guides/debugging-your-iapp.md Added dataset type mismatch troubleshooting
src/build-iapp/iapp-generator/getting-started.md Updated Docker requirements to include Docker Hub account
.vitepress/sidebar.ts Added new guide to navigation structure

@@ -77,6 +95,30 @@ EXPERIMENTAL_TDX_APP=true iapp debug <taskId>
iexec app show <app-address>
```

###
Copy link
Preview

Copilot AI Aug 7, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Empty heading section detected. This appears to be an incomplete markdown heading that should either be completed with descriptive text or removed.

Suggested change
###

Copilot uses AI. Check for mistakes.

- Revised the initial task scheduling description to specify that it takes a few seconds, improving clarity.
- Corrected the link path for the iApp Generator section to ensure accurate navigation.
- Changed the "Start Building" section to "Next Steps" and restructured the content to enhance readability and user engagement, including new links to relevant guides and documentation.
- Revised the iApp Generator section to clarify the process of building TEE-compatible applications, emphasizing ease of access and deployment.
- Improved the language for selecting project modes and languages, making it more user-friendly and accessible for developers of varying experience levels.
- Changed "Verifiable Execution" to "Trusted Execution" to reflect the use of Trusted Execution Environments (TEEs) for secure code execution.
- Revised the description of "Zero Trust Architecture" to emphasize hardware-based TEEs for data protection.
- Updated terminology from "personal data" to "private data" for consistency and clarity.
- Enhanced real-world examples of iApps with additional context and code snippets in both Python and Node.js, ensuring better understanding of their functionality and privacy preservation.
@akugone akugone merged commit 332e7ad into feature/build-iapp Aug 7, 2025
2 of 3 checks passed
@akugone akugone deleted the feature/build-iapp-martin branch August 7, 2025 15:30
This was referenced Aug 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants