From 5b2647fad0d3b87a4151e4d8da472769a3e10dea Mon Sep 17 00:00:00 2001
From: Razvan Deaconescu <razvand@unikraft.io>
Date: Wed, 28 Jan 2026 23:13:36 +0200
Subject: [PATCH 1/2] fix(pages): Improve introduction page

Improve introduction page to make it easier to newcomers:

- Use "Unikraft Cloud" instead of "Unikraft".
- Mention the initialization of the `UKC_METRO` and `UKC_TOKEN`
  variables.
- Include step for installing Docker and optional (but recommended step)
  of using BuildKit.
- Use the `examples` repository.
- Reference the Unikraft Cloud console as the default way to create an
  account and access the token.

Signed-off-by: Razvan Deaconescu <razvand@unikraft.io>
---
 pages/introduction.mdx | 50 +++++++++++++++++++++++++++++++++++++-----
 1 file changed, 44 insertions(+), 6 deletions(-)

diff --git a/pages/introduction.mdx b/pages/introduction.mdx
index 1715659..08a0c3a 100644
--- a/pages/introduction.mdx
+++ b/pages/introduction.mdx
@@ -5,9 +5,9 @@ navigation_icon: book-check
 
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "zudoku/ui/Tabs"
 
-Unikraft is a from-first-principles virtualization solution and cloud platform based on **unikernels** which provides best-in-class performance, security, and scalability.
+Unikraft Cloud is a from-first-principles virtualization solution and cloud platform which provides best-in-class performance, security, and scalability.
 
-Running your app on Unikraft is like running a container but with hardware isolation, millisecond cold starts, and stateful scale-to-zero.
+Running your app on Unikraft Cloud is like running a container but with hardware isolation, millisecond cold starts, and stateful scale-to-zero.
 
 Expect higher server density, cost-savings, I/O performance boosts, active vCPU pricing and _much more_.
 
@@ -17,7 +17,8 @@ Expect higher server density, cost-savings, I/O performance boosts, active vCPU
 
 1. [Create a free account](https://console.unikraft.cloud/signup).
 
-1. Install the `kraft` CLI.
+1. Install the `kraft` CLI:
+
     <Tabs defaultValue="shell">
       <TabsList>
         <TabsTrigger value="shell">Shell 1-liner</TabsTrigger>
@@ -70,14 +71,51 @@ Expect higher server density, cost-savings, I/O performance boosts, active vCPU
 
    See [alternative installation instructions](https://unikraft.org/docs/cli/install) for other platforms.
 
-1. Login to your account by setting your access token (received via email):
+1. Set a metro you want to use, e.g. `fra`:
+
+   ```bash
+   export UKC_METRO=fra
+   ```
+
+1. Set your access token (from the [console](https://console.unikraft.cloud/), go to `Settings` and see the `API TOKEN`):
+
    ```bash
-   export UKC_TOKEN=
+   export UKC_TOKEN=<your_token_here>
+   ```
+
+1. Install Docker on your system, by following [the official instructions](https://docs.docker.com/get-started/get-docker/).
+   You require Docker to build the app image that you will then deploy on Unikraft Cloud.
+
+   Be sure to follow the [post-installation steps](https://docs.docker.com/engine/install/linux-postinstall/).
+
+1. (optional, but recommended) Configure BuildKit on your system.
+   BuildKit is useful to cache the Unikraft Cloud builds and reduce the build time.
+
+   See instructions [here](/platform/troubleshooting#how-can-you-cache-the-apps-filesystem-for-faster-builds).
+
+1. Clone the [`examples` repository](https://github.com/unikraft-cloud/examples):
+
+   ```bash
+   git clone https://github.com/unikraft-cloud/examples
+   cd examples/
+   ```
+
+1. Navigate to your favorite example, for example Nginx:
+
+   ```bash
+   cd nginx/
    ```
 
 1. Deploy your first scale-to-zero, serverless app with Unikraft Cloud:
+
+   ```bash
+   kraft cloud deploy --port 443:8080 --memory 256Mi .
+   ```
+
+1. Use `curl` or a browser to access the Unikraft Cloud instance of Nginx, at the address shown by the `kraft cloud deploy` command:
+
    ```bash
-   kraft cloud deploy -p 443:8080 nginx:latest
+   curl https://<address_above>
    ```
 
 </Stepper>

From 5aaf4d85786ec6441f86e86bb12ff07a098a9577 Mon Sep 17 00:00:00 2001
From: Razvan Deaconescu <razvan.deaconescu@upb.ro>
Date: Mon, 2 Feb 2026 14:22:13 +0200
Subject: [PATCH 2/2] fix(platform): Reduce sentence size

Signed-off-by: Razvan Deaconescu <razvan.deaconescu@upb.ro>
---
 pages/platform/troubleshooting.mdx | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pages/platform/troubleshooting.mdx b/pages/platform/troubleshooting.mdx
index 7f7a163..140a394 100644
--- a/pages/platform/troubleshooting.mdx
+++ b/pages/platform/troubleshooting.mdx
@@ -291,7 +291,8 @@ Here the cause is insufficient memory.
 
 If the stop reason lacks detail, enable debug tracing for the instance.
 
-To do that, in your app of choice in the [examples repository](https://github.com/unikraft-cloud/examples/), or in an app directory you created, update the `runtime` entry in the `Kraftfile` to reference the debug build of the image you use by adding `-dbg` to the name of the runtime.
+To do that, in your app of choice in the [examples repository](https://github.com/unikraft-cloud/examples/), or in an app directory you created, update the `runtime` entry in the `Kraftfile`.
+The entry should reference the debug build of the image you use by adding `-dbg` to the name of the runtime.
 For example, if you want to run the [http-go1.21 example](https://github.com/unikraft-cloud/examples/tree/main/http-go1.21) with debug output, update its `Kraftfile` as follows:
 
 ```yaml title="Kraftfile"