refactor: update build and deploy guide for clarity and consistency

Author: Le-Caignec

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

@@ -1,23 +1,24 @@
 ---
-title: Build and Deploy an iApp
+title: Create and Deploy an iApp
 description:
-  How to build a confidential iExec application and deploy it on iExec protocol
+  How to create a confidential iExec application and deploy it on iExec protocol
 ---
 
-# Build And Deploy your iApp
-
-## iApp Generator: Your Development Tool
+# Create and Deploy an iApp
 
 Bootstrap TEE-compatible applications in minutes without any hardcoding skills,
 iApp Generator handles all the low-level complexity for you.
 
-- **Access to TEEs easily** - No need to dive into low-level requirements, build
-  iApps that connect to TEEs in minutes.
-- **Check and deploy iApps quickly** - iApp Generator checks that your iApp
-  complies with the iExec Framework and streamlines its deployment.
 - **Select your project mode & language** - Get started with either a basic or
   advanced setup, depending on your experience with the iExec framework. You can
   use Python or JavaScript—whichever you prefer!
+- **Develop your iApp effortlessly** - Write your application logic using
+  familiar programming languages while the generator handles all TEE-specific
+  configurations.
+- **Access to TEEs easily** - No need to dive into low-level requirements,
+  create iApps that connect to TEEs in minutes.
+- **Check and deploy iApps quickly** - iApp Generator checks that your iApp
+  complies with the iExec Framework and streamlines its deployment.
 
 ```bash
 # Create your iApp (Python or Node.js supported)
@@ -39,21 +40,13 @@ iapp deploy
 Here are some real-world examples of iApps to help you understand how they work
 in practice.
 
-**Email Notification iApp**
+### Email Notification iApp
 
 This iApp lets you send updates to your contacts without ever seeing their email
 addresses, privacy is preserved by design.
 
 ::: code-group
 
-```python [Python]
-# User runs: "Send updates to my contacts about my project"
-contacts = load_protecteddata()  # User's protected contact list
-for contact in contacts:
-   send_email(contact, project_update_message)
-# → Emails sent directly, you never see the addresses
-```
-
 ```js [Node.js]
 /* User runs: "Send updates to my contacts about my project" */
 const contacts = loadProtectedData(); // User's protected contact list
@@ -63,15 +56,31 @@ contacts.forEach((contact) => {
 // → Emails sent directly, you never see the addresses
 ```
 
+```python [Python]
+# User runs: "Send updates to my contacts about my project"
+contacts = load_protecteddata()  # User's protected contact list
+for contact in contacts:
+   send_email(contact, project_update_message)
+# → Emails sent directly, you never see the addresses
+```
+
 :::
 
-**Oracle Update iApp**
+### Oracle Update iApp
 
 This iApp securely updates a price oracle using private trading data, ensuring
 sensitive information stays confidential.
 
 ::: code-group
 
+```js [Node.js]
+// User runs: "Update price oracle with my private trading data"
+const tradingData = loadProtectedData(); // User's protected trading history
+const averagePrice = calculateWeightedAverage(tradingData);
+updateOracleContract(averagePrice);
+// → Oracle updated with real data, trading history stays private
+```
+
 ```python [Python]
 # User runs: "Update price oracle with my private trading data"
 trading_data = load_protecteddata()  # User's protected trading history
@@ -80,14 +89,6 @@ update_oracle_contract(average_price)
 # → Oracle updated with real data, trading history stays private
 ```
 
-```js [Node.js]
-/* User runs: "Update price oracle with my private trading data" */
-const tradingData = loadProtectedData(); // User's protected trading history
-const averagePrice = calculateWeightedAverage(tradingData);
-updateOracleContract(averagePrice);
-// → Oracle updated with real data, trading history stays private
-```
-
 :::
 
 **Automated Transactions iApp**
@@ -97,21 +98,21 @@ financial information remains private.
 
 ::: code-group
 
-```python [Python]
-# User runs: "Automate payments every month"
-payment_info = load_protecteddata()  # User's payment details
-for month in range(12):
-   process_payment(payment_info)
-# → Payments processed, payment details stay private
-```
-
 ```js [Node.js]
-/* User runs: "Automate payments every month" */
+// User runs: "Automate payments every month"
 const paymentInfo = loadProtectedData(); // User's payment details
 for (let month = 0; month < 12; month++) {
   processPayment(paymentInfo);
 }
 // → Payments processed, payment details stay private
 ```
 
+```python [Python]
+# User runs: "Automate payments every month"
+payment_info = load_protecteddata()  # User's payment details
+for month in range(12):
+   process_payment(payment_info)
+# → Payments processed, payment details stay private
+```
+
 :::

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

@@ -176,6 +176,44 @@ iexec order publish --app
 
 Your iApp is now accessible according to the conditions you defined!
 
+## Managing Orders
+
+### View Published Orders
+
+Check active orders for your app:
+
+```bash
+iexec orderbook app <your-app-address>
+```
+
+### Modify an Order
+
+To change conditions, create a new order with new parameters.
+
+### Cancel an Order
+
+Remove an order from the marketplace:
+
+```bash
+iexec order unpublish --app <orderHash>
+```
+
+Completely invalidate an order:
+
+```bash
+iexec order cancel --app <orderHash>
+```
+
+### 🛡️ **Confidential App (TEE required)**
+
+```json
+{
+  "appprice": "2000000000",
+  "volume": "500",
+  "tag": "0x0000000000000000000000000000000000000000000000000000000000000003"
+}
+```
+
 ## App Order Parameters
 
 Here's the detailed description of each parameter:
@@ -247,76 +285,6 @@ restriction)
 
 **Typical usage:** `"0x0000000000000000000000000000000000000000"` (open to all)
 
-## Managing Orders
-
-### View Published Orders
-
-Check active orders for your app:
-
-```bash
-iexec orderbook app <your-app-address>
-```
-
-### Modify an Order
-
-To change conditions, create a new order with new parameters.
-
-### Cancel an Order
-
-Remove an order from the marketplace:
-
-```bash
-iexec order unpublish --app <orderHash>
-```
-
-Completely invalidate an order:
-
-```bash
-iexec order cancel --app <orderHash>
-```
-
-## Common Use Cases
-
-### 🆓 **Free and Open App**
-
-```json
-{
-  "appprice": "0",
-  "volume": "10000",
-  "tag": "0x0000000000000000000000000000000000000000000000000000000000000000"
-}
-```
-
-### 💰 **Paid App (1 RLC per use)**
-
-```json
-{
-  "appprice": "1000000000",
-  "volume": "1000",
-  "tag": "0x0000000000000000000000000000000000000000000000000000000000000003"
-}
-```
-
-### 🔒 **Private App (specific user only)**
-
-```json
-{
-  "appprice": "0",
-  "volume": "50",
-  "requesterrestrict": "0xSpecificUserAddress"
-}
-```
-
-### 🛡️ **Confidential App (TEE required)**
-
-```json
-{
-  "appprice": "2000000000",
-  "volume": "500",
-  "tag": "0x0000000000000000000000000000000000000000000000000000000000000003"
-}
-```
-
 ## What's Next?
 
 **Your iApp is now accessible with custom conditions!**
@@ -327,20 +295,8 @@ Next steps:
 - **Adjust pricing**: Create new orders based on demand
 - **Manage revenue**: Check your earnings with `iexec account show`
 
-### Explore More iExec Guides
-
-- **[Input and Outputs](/build_iapp/guides/inputs-and-outputs)** - Handle data
-  in your iApps
-- **[Getting and Decrypting Results](/build_iapp/guides/how-to-get-and-decrypt-results)** -
-  Process execution results
-- **[Debugging Your iApp](/build_iapp/guides/debugging-your-iapp)** -
-  Troubleshoot your applications
-- **[Using TDX (Experimental)](/build_iapp/guides/using-tdx-experimental)** -
-  Advanced TEE features
-
 ### Technical Deep Dive
 
-- **[SDK Deep Dive](/deep_dive/sdk)** - Advanced SDK concepts and usage
 - **[iExec SDK Documentation](https://github.com/iExecBlockchainComputing/iexec-sdk)** -
   Complete CLI reference
 - **[Official Orders Documentation](https://protocol.docs.iex.ec/for-developers/advanced/manage-your-apporders)** -