refactor: apply copywriting checklist

Author: chainsona

src/get-started/helloWorld/1-overview.md

@@ -11,13 +11,13 @@ description:
 > Reading time 🕒 8 min
 
 <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!">Let's start with the basics</h2>
-  <p>and explore how iExec can help you build Privacy-preserving applications and securely manage sensitive data.</p>
+  <h2 class="text-2xl font-bold mt-0 border-none!">Start with the basics</h2>
+  <p>and explore how iExec can help you build Privacy-preserving apps and securely manage sensitive data.</p>
 </div>
 
 ## 👨‍💻 Building Privacy-preserving iApp with iExec
 
-<p>Imagine you're building a decentralized application (iApp) that needs to <strong> handle sensitive user data</strong>, for example:</p>
+<p>Imagine you're building a decentralized app (iApp) that needs to <strong> handle sensitive user data</strong>, for example:</p>
 <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">
@@ -60,7 +60,7 @@ description:
 </div>
 
 <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!">This is where <span class="text-fuchsia-700 font-semibold">iExec</span> comes in! We provide tools to easily add <span class="text-fuchsia-700 font-semibold">privacy</span> and <span class="text-fuchsia-700 font-semibold">monetization</span> features into your iApp.</p>
+  <p class="m-0!">This is where <span class="text-fuchsia-700 font-semibold">iExec</span> comes in. iExec provides tools to easily add <span class="text-fuchsia-700 font-semibold">privacy</span> and <span class="text-fuchsia-700 font-semibold">monetization</span> features into your iApp.</p>
 </div>
 
 ## 👷 How do we Solve it?
@@ -76,7 +76,7 @@ Execution Environment (TEE)</a></span> and
 Computing</a></span> technologies.
 
 <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!">Our technology allows users to control the <span class="text-fuchsia-700 font-semibold">ownership</span>,
+  <p class="m-0!">The technology allows users to control the <span class="text-fuchsia-700 font-semibold">ownership</span>,
   <span class="text-fuchsia-700 font-semibold">confidentiality</span>, and <span class="text-fuchsia-700 font-semibold">monetization</span> of their data and digital assets within the <span class="text-fuchsia-700 font-semibold">Web3</span> ecosystem.</p>
 </div>
 
@@ -104,7 +104,7 @@ iExec combines three fundamental elements that work together seamlessly:
 - Provides transparent governance rules for data access
 
 <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!">By merging <span class="text-fuchsia-700 font-semibold">blockchain technology</span> with <span class="text-fuchsia-700 font-semibold">confidential computing</span>, we've pioneered <span class="text-fuchsia-700 font-semibold"><a target="_blank" href="https://www.iex.ec/academy/iexec-decentralized-confidential-computing">DeCC</a></span> (Decentralized Confidential Computing) to take <span class="text-fuchsia-700 font-semibold">privacy</span> and <span class="text-fuchsia-700 font-semibold">security</span> to the next level in <span class="text-fuchsia-700 font-semibold">Web3</span> ecosystems.</p>
+  <p class="m-0!">By merging <span class="text-fuchsia-700 font-semibold">blockchain technology</span> with <span class="text-fuchsia-700 font-semibold">confidential computing</span>, iExec pioneered <span class="text-fuchsia-700 font-semibold"><a target="_blank" href="https://www.iex.ec/academy/iexec-decentralized-confidential-computing">DeCC</a></span> (Decentralized Confidential Computing) to take <span class="text-fuchsia-700 font-semibold">privacy</span> and <span class="text-fuchsia-700 font-semibold">security</span> to the next level in <span class="text-fuchsia-700 font-semibold">Web3</span> ecosystems.</p>
 </div>
 
 ### 🧸 DeCC Explained Like You're 5
@@ -174,10 +174,10 @@ And many other use cases...
   </div>
   <div class="flex items-center gap-3">
     <span class="text-xl">🔌</span>
-    <p class="m-0"><strong>Wide Application:</strong> From AI to finance, enabling confidential data processing across various industries</p>
+    <p class="m-0"><strong>Wide application:</strong> From AI to finance, enabling confidential data processing across various industries</p>
   </div>
 </div>
 
 <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">
-  <p class="m-0!">Now that you understand the fundamentals, let's dive into protecting your first piece of data! With Alice!</p>
+  <p class="m-0!">Now that you understand the fundamentals, dive into protecting your first piece of data with Alice.</p>
 </div>

src/get-started/helloWorld/2-protectData.md

@@ -1,25 +1,25 @@
 ---
-title: Let's Protect Data
+title: Protect Data
 description:
-  Learn how to protect your data using iExec's DataProtector SDK in this
+  Learn how to protect your data using iExec's DataProtector Software Development Kit (SDK) in this
   hands-on tutorial step.
 ---
 
 <script setup>
 import ProtectData from '@/modules/helloWorld/ProtectData.vue';
 </script>
 
-# 🛡️ Let's Protect Data
+# 🛡️ Protect Data
 
 > Reading time: 6 minutes
 
 <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 get practical</h2>
-  <p>Let's follow Alice as she learns how to protect her data using DataProtector on Bob's iApp, our developer tool for protecting data creation and management.</p>
+  <p>Follow Alice as she learns how to protect her data using DataProtector on Bob's iApp, the developer tool for protecting data creation and management.</p>
 </div>
 
 <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!"><strong>Protected data</strong> is encrypted data that remains confidential throughout its entire lifecycle - during storage, transfer and processing.</p>
+  <p class="m-0!"><strong>Protected data</strong> refers to encrypted data that remains confidential throughout its entire lifecycle - during storage, transfer and processing.</p>
 </div>
 
 ## 🧩 DataProtector, Key Features
@@ -45,7 +45,7 @@ their DApp with these key features:
   Features an SDK for easy integration into your DApp, enhancing functionality
   and user experience.
 
-## 🧩 Let's Create Protected Data
+## 🧩 Create protected data
 
 <ProtectData />
 
@@ -77,12 +77,12 @@ const { address: protectedDataAddress } = await dataProtectorCore.protectData({
 
 For this tutorial, you can try out the code directly in our interactive
 CodeSandbox demo
-[here](https://codesandbox.io/p/github/iExecBlockchainComputing/dataprotector-sandbox/main?file=%2Fsrc%2FApp.tsx&preventWorkspaceRedirect=true).
+[try the interactive DataProtector sandbox](https://codesandbox.io/p/github/iExecBlockchainComputing/dataprotector-sandbox/main?file=%2Fsrc%2FApp.tsx&preventWorkspaceRedirect=true).
 Here's a quick overview of what happened when you clicked the **Protect Data**
 button:
 
-![alt](/assets/hello-world/dataprotector_light.png){.light-only}
-![alt](/assets/hello-world/dataprotector_dark.png){.dark-only}
+![DataProtector workflow diagram showing the 4-step process: SDK called, data encrypted with symmetric key, protected data address returned to user, and protected data encrypted and stored on decentralized storage](/assets/hello-world/dataprotector_light.png){.light-only}
+![DataProtector workflow diagram showing the 4-step process: SDK called, data encrypted with symmetric key, protected data address returned to user, and protected data encrypted and stored on decentralized storage](/assets/hello-world/dataprotector_dark.png){.dark-only}
 
 <div class="flex flex-col gap-2.5 my-6">
   <div class="flex items-center gap-3">
@@ -91,7 +91,7 @@ button:
   </div>
   <div class="flex items-center gap-3">
     <span class="bg-gray-950 text-sm text-white w-6 h-6 rounded-full flex items-center justify-center font-medium">2</span>
-    <span>The data is encrypted with a symmetric key</span>
+    <span>DataProtector encrypts the data with a symmetric key</span>
   </div>
   <div class="flex items-center gap-3">
     <span class="bg-gray-950 text-sm text-white w-6 h-6 rounded-full flex items-center justify-center font-medium">3</span>
@@ -107,7 +107,7 @@ button:
   </div>
   <div class="flex items-center gap-3">
     <span class="bg-gray-950 text-sm text-white w-6 h-6 rounded-full flex items-center justify-center font-medium">6</span>
-    <span>The protected data address is returned to the user</span>
+    <span>The system returns the protected data address to the user</span>
   </div>
 </div>
 
@@ -177,13 +177,13 @@ const { address: protectedDataAddress } = await dataProtectorCore.protectData({
 
 - 🔒 **DataProtector** ensures data protection, management, and confidentiality
 
-- 📦 **Protected Data** is encrypted and stored on decentralized storage
+- 📦 **Protected Data** - DataProtector encrypts and stores data on decentralized storage
 
 - ⛓️ **Ownership** iExec's protocol writes ownership on the blockchain and links
   it to your wallet
 
 - 🔌 **Integration** is simple with our developer tools
 
 <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">
-  <p class="m-0!">In the next chapter, we'll show you how to build, deploy, and run an iApp to process your protected data. Let's go! 🚀</p>
+  <p class="m-0!">In the next chapter, learn how to build, deploy, and run an iApp to process your protected data.</p>
 </div>

src/get-started/helloWorld/3-buildIApp.md

@@ -5,18 +5,18 @@ description:
   processing protected data in this comprehensive tutorial.
 ---
 
-# 🛠️ Build and Deploy your First iApp
+# 🛠️ Build and deploy your first iApp
 
 > Reading time 🕒 10 min
 
 <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="/references/iapp-generator" target="_blank" class="!text-gray-900 !font-bold underline hover:!text-black">iExec iApp generator tool</a>. This tool helps you create, test and deploy iApp with just a few commands.</p>
+  <h2 class="text-2xl font-bold mt-0 border-none!">Time to build</h2>
+  <p>Build an iApp that can process protected data in a secure environment using the <a href="/references/iapp-generator" target="_blank" class="!text-gray-900 !font-bold underline hover:!text-black">iExec iApp generator tool</a>. This tool helps you create, test, and deploy iApp with just a few commands.</p>
 </div>
 
-If you wanna explore and deep dive in the CLI. You can check the
-[iApp-CLI](https://github.com/iExecBlockchainComputing/iapp/tree/main/cli)
-github repository. Follow the instructions carefully for a smooth development
+If you wanna explore and deep dive in the command-line tool. You can check the
+[iApp-CLI (Command Line Interface)](https://github.com/iExecBlockchainComputing/iapp/tree/main/cli)
+GitHub repository. Follow the instructions carefully for a smooth development
 experience.
 
 ## 📋 Prerequisites
@@ -46,29 +46,29 @@ Before getting started, make sure you have:
 </div>
 
 <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!">Don't worry! All secrets used in this tutorial stay on your machine and aren’t shared with anyone. You’ll only need them to run the <code>iapp run</code> command.</p>
+  <p class="m-0!">Don't worry. All secrets used in this tutorial stay on your machine and aren't shared with anyone. You'll only need them to run the <code>iapp run</code> command.</p>
 </div>
 
-## 🚀 Types of iApp you Can Build
+## 🚀 Types of iApp you can build
 
 iExec enables you to build various types of Privacy-preserving applications.
 Here are some popular use cases:
 
-### 📧 Web3 Mail
+### 📧 Web3 mail
 
 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](/references/web3mail)
 
-### 💬 Web3 Telegram
+### 💬 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](/references/web3telegram)
 
-### 🌐 Content Delivery
+### 🌐 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)
@@ -171,7 +171,7 @@ You will be prompted with the following message:
     '🐳 Added Dockerfile',
     '⚙️ Added iExec configuration'
   ]"
-  :successMessage="'Your iApp is ready!'"
+  :successMessage="'Your iApp is ready'"
 />
 
 <div class="flex flex-col gap-2.5 my-6">
@@ -196,7 +196,7 @@ You will be prompted with the following message:
 </div>
 
 <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!">We recommend selecting <span class="text-fuchsia-700 font-semibold">"Hello World"</span> to quickly discover how iApp works! use <span class="text-fuchsia-700 font-semibold">advanced</span> only if you are familiar with iExec.</p>
+  <p class="m-0!">We recommend selecting <span class="text-fuchsia-700 font-semibold">"Hello World"</span> to quickly discover how iApp works. Use <span class="text-fuchsia-700 font-semibold">advanced</span> only if you are familiar with iExec.</p>
 </div>
 
 - An iApp project is setup with the selected language
@@ -288,7 +288,7 @@ simulating how it will run in the iExec network's TEE environment.
   <p class="m-0!">- If you get <code>Error: Failed to locate iApp project root</code>: Ensure you are in your project folder before proceeding.</p>
 </div>
 
-### 🧩 Using Arguments
+### 🧩 Using arguments
 
 You can pass arguments to your iApp using the `--args` option. This allows you
 to provide necessary inputs during runtime (you can use your name for example).
@@ -297,7 +297,7 @@ to provide necessary inputs during runtime (you can use your name for example).
 iapp test --args your-name
 ```
 
-### 🔒 Using Protected Data
+### 🔒 Using protected data
 
 You can pass a protectedData that you are authorized to process to your iApp
 using the `--protectedData` option.
@@ -370,7 +370,7 @@ Once you have your token, you can deploy your iApp.
 </template>
 
 <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!">📝 Make sure to save your <span class="text-fuchsia-700 font-semibold">iApp address</span> after deployment - you'll need it later!</p>
+  <p class="m-0!">📝 Make sure to save your <span class="text-fuchsia-700 font-semibold">iApp address</span> after deployment - you'll need it later.</p>
   <p class="m-0!">You can find your iApp address in the <code>iexec-app.json</code> file in your project folder.</p>
   <br>
   <p class="m-0!">⚠️  If you encounter issues during deployment, make sure the Docker BuildKit feature is enabled and supports AMD64 architecture:</p>
@@ -401,7 +401,7 @@ allowing it to run securely in a **Trusted Execution Environment (TEE)** for
   <p class="m-0!">🎉 Congratulations! You've successfully deployed and run your first iApp on iExec. This is a significant milestone - your application is now ready to securely process confidential data in a trusted environment.</p>
 </div>
 
-## 🎯 Key Takeaways
+## 🎯 Key takeaways
 
 - 🔒 **iApp:** Special applications that run in TEEs to process protected data
 - 🛠️ **iApp CLI:** Command-line tool for building, testing, and deploying iApp
@@ -410,7 +410,7 @@ allowing it to run securely in a **Trusted Execution Environment (TEE)** for
   environments
 
 <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">
-  <p class="m-0!">Next up: Alice will learn how to authorize the iApp and Bob to access and use her protected data!  🚀</p>
+  <p class="m-0!">Next up: Alice will learn how to authorize the iApp and Bob to access and use her protected data.</p>
 </div>
 
 <script setup>

src/get-started/overview/iapp.md

@@ -65,7 +65,7 @@ Turnkey Privacy iApp, they will.**
 ## How it Works
 
 Your code runs in a Trusted Execution Environment (TEE). This secure area exists
-inside specific processors (Intel SGX/TDX chipset). Everything stays private and
+inside specific processors (Intel Software Guard Extensions (SGX)/Trust Domain Extensions (TDX) chipset). Everything stays private and
 protected there, even from the operating system.
 
 Authorized users trigger iApp that process protected data inside this private
@@ -148,7 +148,7 @@ the TEE execution environment.
 - **Docker**: Your application must be containerized
 - **Input/Output**: Define clear input and output schemas
 - **TEE Compatibility**: Ensure your code runs in secure enclaves
-- **Network Access**: Configure any external API calls or dependencies
+- **Network Access**: Configure any external Application Programming Interface (API) calls or dependencies
 
 ## Next Steps
 

src/get-started/overview/protected-data.md

@@ -6,7 +6,7 @@ description:
   controls, and secure data monetization.
 ---
 
-# 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,
@@ -16,9 +16,9 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
   <p class="m-0!">Unlike standard datasets, Protected Data exposes its <span class="text-fuchsia-700 font-semibold">data types on-chain</span> (indicating types like email addresses or photos). This lets anyone <span class="text-fuchsia-700 font-semibold">identify entries with matching types</span>.</p>
 </div>
 
-## Key Concepts
+## Key concepts
 
-### Data Governance
+### Data governance
 
 <div class="mb-4"></div>
 
@@ -112,7 +112,7 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
     <div class="flex items-center gap-3">
       <span class="text-xl font-bold text-fuchsia-700">2.</span>
       <div>
-        <strong>Share:</strong> Authorize specific users and applications to access your data
+        <strong>Share:</strong> Authorize specific users and apps to access your data
       </div>
     </div>
     <div class="flex items-center gap-3">
@@ -136,7 +136,7 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
   </div>
 </div>
 
-## Use Cases
+## Use cases
 
 <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">
@@ -188,7 +188,7 @@ manage and monetize their data within the Web3 ecosystem effortlessly.
   <p class="m-0!">Ready to protect your data? Start with our <span class="text-green-700 font-semibold">DataProtector guides</span>. Learn how to secure sensitive information while unlocking its value.</p>
 </div>
 
-## Next Steps
+## Next steps
 
 <div class="bg-[var(--vp-c-bg-soft)] rounded-[6px] p-6 mb-6">
   <div class="flex flex-col gap-4">