chore: update documentation to standardize terminology and improve clarity

Author: Le-Caignec

.github/styles/config/vocabularies/Technical/accept.txt

@@ -0,0 +1,190 @@
+# Technical terms for iExec documentation
+
+# Function Names
+protectData
+grantAccess
+revokeAllAccess
+revokeOneAccess
+transferOwnership
+createCollection
+removeCollection
+removeProtectedDataFromCollection
+sendEmail
+sendTelegram
+getValue
+deserializer
+deserialize
+consumeProtectedData
+rentProtectedData
+subscribeToCollection
+buyProtectedData
+setProtectedDataForSale
+setProtectedDataToRenting
+setProtectedDataToSubscription
+setProtectedDataRentingParams
+setSubscriptionParams
+addToCollection
+removeProtectedDataFromCollection
+removeProtectedDataFromRenting
+removeProtectedDataForSale
+addAppToAddOnlyAppWhitelist
+createAddOnlyAppWhitelist
+getUserAddOnlyAppWhitelist
+getGrantedAccess
+getProtectedData
+getResultFromCompletedTask
+getCollectionOwners
+getCollectionsByOwner
+getCollectionSubscriptions
+getProtectedDataInCollections
+getProtectedDataPricingParams
+getRentals
+fetchMyContacts
+fetchUserContacts
+unpublish
+
+# Function Parameters
+authorizedApp
+authorizedUser
+grantedAccess
+collectionId
+appsWhitelist
+userWhitelist
+useVoucher
+voucherAddress
+voucherOwner
+subscriberAddress
+renterAddress
+apporder
+datasetorder
+workerpoolorder
+requestorder
+requesters
+workerpools
+apporders
+appmaxprice
+datasetmaxprice
+workerpoolmaxprice
+apprestrict
+requesterrestrict
+workerpoolrestrict
+datasetprice
+taskId
+dealId
+userAddress
+resultHash
+resultSeal
+enclaveSign
+workerpoolSign
+inputFiles
+zipFile
+encryptionKey
+multiaddr
+ipfsNode
+ipfsGateway
+emailSubject
+emailContent
+contentType
+senderName
+telegramContent
+//TODO: check
+param
+params
+args
+environnement
+pageSize
+subgraphUrl
+subgraph
+iexecOptions
+uploadMode
+allowDebug
+requiredSchema
+keypair
+collectionOwner
+isRentable
+isDistributed
+NFTs
+creationTimestamp
+transactionHash
+txHash
+boolean
+bigint
+newOwner
+maxPrice
+workerpoolorders
+
+# iExec/Web3 Terms
+iExec
+CPUs
+LLMs
+Agentic
+DApp
+DApps
+blockchain
+ethereum
+intel
+nano
+workerpool
+protectedData
+dataProtector
+iApp
+sconification
+middleware
+oracle
+MREnclave
+Gramine
+//TODO: check
+permissioning
+Permissioning
+arithmetics
+webservers
+Javascript
+Dockerizable
+Dockerize
+Dockerhub
+dockerized
+keystore
+Webpack
+json
+polyfills
+Buildx
+hardcoding
+npm
+Arweave
+cryptocurrency
+cryptocurrencies
+crypto
+onchain
+offchain
+//TODO: check
+mainchain
+Sidechain
+Bellecour
+Mainnet
+Testnet
+Metamask
+Binance
+Coinbase
+Uniswap
+Szabo
+presale
+presigned
+untrusted
+dev
+cryptocurrecny
+Unmatching
+incentivized
+Whitepaper
+deserialization
+enclaveChallenge
+Borsh
+Arbitrum
+Stargate
+Github
+subgraphs
+hackathons
+tokenization
+chipset
+auditable
+Composable
+Activable

.github/styles/config/vocabularies/Technical/reject.txt

@@ -0,0 +1,2 @@
+# Terms to reject - currently empty
+# Add terms here that should always be flagged as errors

.gitignore

@@ -14,4 +14,5 @@ components.d.ts
 .DS_Store
 
 #vale
-.github/styles/*
+.github/styles/config/*
+!.github/styles/config/vocabularies/

.vale.ini

@@ -2,9 +2,15 @@ StylesPath = .github/styles
 MinAlertLevel = suggestion
 Packages = Google
 
+# Define the Technical vocabulary for custom terminology
+Vocab = Technical
+
 [formats]
 md = markdown
 
 [*.md]
 BasedOnStyles = Vale, Google
 IgnorePatterns = README.md
+
+# Disable Vale.Terms to avoid case sensitivity issues
+Vale.Terms = NO

src/get-started/helloWorld.md

@@ -2,7 +2,7 @@
 title: Hello World Tutorial
 description:
   Kickstart your Web3 journey with iExec. In just 30 minutes, learn how to build
-  privacy-focused dApps, protect sensitive data, and manage data access.
+  privacy-focused DApp, protect sensitive data, and manage data access.
 ---
 
 <script setup>
@@ -12,7 +12,7 @@ import ChainSelector from '@/components/ChainSelector.vue'
 
 # 👋 Welcome to iExec
 
-> Reading time 🕒 2 mins
+> Reading time 🕒 2 min
 
 <div class="mb-0 p-6 bg-[var(--vp-c-bg-soft)] rounded-lg border border-[var(--vp-c-divider)]">
   <div class="flex">
@@ -23,7 +23,7 @@ import ChainSelector from '@/components/ChainSelector.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!">Start Your Web3 Privacy Journey</h2>
-  <p>And learn how to build Privacy-preserving decentralized applications (dApps) with iExec in this interactive guide.</p>
+  <p>And learn how to build Privacy-preserving decentralized applications (DApp) with iExec in this interactive guide.</p>
   <div class="mt-6 flex items-center gap-4">
     <span class="bg-gray-900 text-white px-4 py-2 rounded-full font-medium">☕ 30 minutes journey</span>
     <p>Perfect for hackathons 😊</p>

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

@@ -2,22 +2,22 @@
 title: iExec Overview
 description:
   Explore how iExec's confidential computing toolkit helps developers build
-  privacy-preserving dApps. Learn how DataProtector and iApps let users control,
+  privacy-preserving iApp. Learn how DataProtector and iApp let users control,
   protect, and monetize sensitive data.
 ---
 
 # 🧐 iExec Overview
 
-> Reading time 🕒 8 mins
+> 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>
 </div>
 
-## 👨‍💻 Building Privacy-preserving dApps with iExec
+## 👨‍💻 Building Privacy-preserving iApp with iExec
 
-<p>Imagine you're building a decentralized application (dApp) that needs to <strong> handle sensitive user data</strong>, for example:</p>
+<p>Imagine you're building a decentralized application (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 dApp.</p>
+  <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>
 </div>
 
 ## 👷 How do we Solve it?
@@ -84,14 +84,14 @@ Computing</a></span> technologies.
 
 iExec combines three fundamental elements that work together seamlessly:
 
-#### 1. Protect Data with our Devtool [DataProtector](/references/dataProtector/getting-started)
+#### 1. Protect Data with our DevTool [DataProtector](/references/dataProtector/getting-started)
 
 - Encrypt your sensitive data and store it securely on Arweave or IPFS
 - Only you control who can access it and when
 - Perfect for private information like research data, business analytics, or
   personal records
 
-#### 2. Compute Data with iExec Apps (iApps) Running in Secure Environment
+#### 2. Compute Data with iExec Apps (iApp) Running in Secure Environment
 
 - Special applications that can work with protected data
 - Run in secure environments (called TEEs) that keep your data private
@@ -115,17 +115,17 @@ inside stays **safe** and **private**.
 With a tool called **DataProtector**, your data becomes **protected** and can
 only be read and processed inside this secure room.
 
-Special applications called **iApps** (applications built to run in secure
+Special applications called **iApp** (applications built to run in secure
 environments) can enter the room to work with your data. You stay in **control**
 by setting **access rules** that only you can modify about who can access it and
 when.
 
-## 🔍 Building your First Privacy-preserving dApp
+## 🔍 Building your First Privacy-preserving iApp
 
 Let's meet Bob and Alice to understand how iExec enables Privacy-preserving
 applications:
 
-### 1. Meet Bob: the dApp Developer 👨‍💻
+### 1. Meet Bob: the iApp Developer 👨‍💻
 
 Bob is building a decentralized application that uses iExec's technology. His
 platform consists of:
@@ -135,7 +135,7 @@ platform consists of:
 - Thanks to DataProtector, end users can protect their data, manage access, and
   process it seamlessly.
 
-### 2. Meet Alice: the dApp User 👩‍💼
+### 2. Meet Alice: the iApp User 👩‍💼
 
 When using Bob's platform, Alice can:
 
@@ -144,7 +144,7 @@ When using Bob's platform, Alice can:
 - Authorize specific iExec Apps and persons like Bob to use her data in a secure
   environment
 
-Depending on the dApp's use case, Alice could:
+Depending on the iApp's use case, Alice could:
 
 - Apply algorithms to her data and get results confidentially
 - Share her data with other users privately (and get paid for it)
@@ -166,7 +166,7 @@ And many other use cases...
   </div>
   <div class="flex items-center gap-3">
     <span class="text-xl">📦</span>
-    <p class="m-0"><strong>iApps (iExec App):</strong> Special applications that can process protected data</p>
+    <p class="m-0"><strong>iApp (iExec App):</strong> Special applications that can process protected data</p>
   </div>
   <div class="flex items-center gap-3">
     <span class="text-xl">⛓️</span>

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

@@ -15,7 +15,7 @@ import ProtectData from '@/modules/helloWorld/ProtectData.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 get practical</h2>
-  <p>Let's follow Alice as she learns how to protect her data using DataProtector on Bob's dApp, our developer tool for protecting data creation and management.</p>
+  <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>
 </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">
@@ -26,7 +26,7 @@ import ProtectData from '@/modules/helloWorld/ProtectData.vue';
 
 DataProtector is a developer tool built on top of our technology. It helps
 developers easily add data protection, management, and monetization features to
-their dApps with these key features:
+their DApp with these key features:
 
 - 🔐 **Data Privacy and Security**
 
@@ -40,7 +40,7 @@ their dApps with these key features:
   Allows users to manage access, enabling flexible control and monetization of
   data assets.
 
-- 🔌 **Seamless dApp Integration**
+- 🔌 **Seamless iApp Integration**
 
   Features an SDK for easy integration into your DApp, enhancing functionality
   and user experience.