docs: improve Linux Desktop and Desktop Template documentation

- Add explanatory prose before code blocks per documentation standards
- Fix TypeScript code block labels to use "JavaScript & TypeScript"
- Add external links for sharp, SSE, noVNC, xdotool, x11vnc, and Xvfb
- Fix GitHub link to point to Surf repo instead of cookbook
- Add introduction and section headers to desktop template page

Author: beran-t

docs/template/examples/desktop.mdx

@@ -3,6 +3,17 @@ title: "Desktop"
 description: "Sandbox with Ubuntu Desktop and VNC access"
 ---
 
+This template creates a sandbox with a full Ubuntu 22.04 desktop environment, including the XFCE desktop, common applications, and VNC streaming for remote access. It's ideal for building AI agents that need to interact with graphical user interfaces.
+
+The template includes:
+- **Ubuntu 22.04** with XFCE desktop environment
+- **VNC streaming** via [noVNC](https://novnc.com/) for browser-based access
+- **Pre-installed applications**: LibreOffice, text editors, file manager, and common utilities
+- **Automation tools**: [xdotool](https://github.com/jordansissel/xdotool) and scrot for programmatic desktop control
+
+## Template Definition
+
+The template installs the desktop environment, sets up VNC streaming via [x11vnc](https://github.com/LibVNC/x11vnc) and noVNC, and configures a startup script.
 
 <CodeGroup>
 
@@ -131,6 +142,9 @@ template = (
 
 </CodeGroup>
 
+## Startup Script
+
+The startup script initializes the virtual display using [Xvfb](https://www.x.org/releases/X11R7.6/doc/man/man1/Xvfb.1.xhtml) (X Virtual Framebuffer), launches the XFCE desktop session, starts the VNC server, and exposes the desktop via noVNC on port 6080. This script runs automatically when the sandbox starts.
 
 ```bash start_command.sh
 #!/bin/bash
@@ -156,6 +170,9 @@ cd /opt/noVNC/utils && ./novnc_proxy --vnc localhost:5900 --listen 6080 --web /o
 sleep 2
 ```
 
+## Building the Template
+
+Build the template with increased CPU and memory allocation to handle the desktop environment installation. The build process may take several minutes due to the size of the packages being installed.
 
 <CodeGroup>
 

docs/use-cases/linux-desktop.mdx

@@ -30,13 +30,15 @@ This guide is a demo version of [E2B Surf](https://github.com/e2b-dev/surf), an
 </CardGroup>
 
 <Note>
-  Full source code available on [GitHub](https://github.com/e2b-dev/e2b-cookbook).
+  Full source code available on [GitHub](https://github.com/e2b-dev/surf).
 </Note>
 
 ## Project Structure
 
+This starter project follows a standard Next.js App Router structure with additional directories for AI services, utilities, and type definitions. The separation keeps concerns modular and makes the codebase easy to navigate.
+
 <CodeGroup>
-```ts TypeScript
+```typescript JavaScript & TypeScript
 surf-starter/
 ├── app/
 │   ├── api/chat/
@@ -79,7 +81,7 @@ This application creates an autonomous AI loop that enables natural language con
 6. **Feedback Loop** - A new screenshot is taken and sent back to the AI
 7. **Iteration** - The loop continues until the task is complete (maximum 15 iterations)
 
-All updates stream to your browser in real-time via Server-Sent Events (SSE), giving you live visibility into what the AI is thinking and doing.
+All updates stream to your browser in real-time via [Server-Sent Events (SSE)](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events), giving you live visibility into what the AI is thinking and doing.
 
 ---
 
@@ -105,7 +107,7 @@ Initialize a new Next.js project and install the required dependencies.
     **Dependencies explained:**
     - `@e2b/desktop` - E2B Desktop SDK for controlling virtual Linux desktops
     - `openai` - OpenAI SDK for Computer Use API integration
-    - `sharp` - Fast image processing library for screenshot optimization
+    - [`sharp`](https://sharp.pixelplumbing.com/) - Fast image processing library for screenshot optimization
   </Step>
 </Steps>
 
@@ -130,7 +132,7 @@ Set up your API keys and create environment validation utilities.
   <Step title="Environment Validation">
     Create `lib/env.ts` to validate environment variables:
 
-    ```typescript
+    ```typescript JavaScript & TypeScript
     // lib/env.ts
     export function getEnv() {
       const E2B_API_KEY = process.env.E2B_API_KEY;
@@ -156,7 +158,7 @@ Define TypeScript interfaces for type safety throughout the application.
 
 Create `types/index.ts` with core application types:
 
-```typescript
+```typescript JavaScript & TypeScript
 // types/index.ts
 
 // Message structure for chat interface
@@ -203,7 +205,7 @@ Centralize all configuration values for easy management.
 
 Create `lib/constants.ts` with application-wide constants:
 
-```typescript
+```typescript JavaScript & TypeScript
 // lib/constants.ts
 
 // Sandbox configuration
@@ -248,7 +250,7 @@ Build helper functions for screenshot processing, streaming, and action executio
   <Step title="Screenshot Processing">
     Create `lib/utils/screenshot.ts` to optimize screenshots:
 
-    ```typescript
+    ```typescript JavaScript & TypeScript
     // lib/utils/screenshot.ts
     import sharp from 'sharp';
     import { SCREENSHOT_CONFIG } from '@/lib/constants';
@@ -274,7 +276,7 @@ Build helper functions for screenshot processing, streaming, and action executio
   <Step title="Safe Stream Controller">
     Create `lib/utils/stream.ts` for SSE streaming:
 
-    ```typescript
+    ```typescript JavaScript & TypeScript
     // lib/utils/stream.ts
     export function createSafeStreamController(
       controller: ReadableStreamDefaultController
@@ -316,7 +318,7 @@ Build helper functions for screenshot processing, streaming, and action executio
   <Step title="Action Execution">
     Create `lib/utils/actions.ts` to map AI actions to E2B SDK calls:
 
-    ```typescript
+    ```typescript JavaScript & TypeScript
     // lib/utils/actions.ts
     import type { Sandbox } from '@e2b/desktop';
     import type { ComputerAction } from '@/types';
@@ -389,7 +391,7 @@ Define the system instructions that guide the AI agent's behavior.
 
 Create `lib/ai/instructions.ts` with the AI agent prompt:
 
-```typescript
+```typescript JavaScript & TypeScript
 // lib/ai/instructions.ts
 export const SYSTEM_INSTRUCTIONS = `You are Surf, an AI assistant that controls a Linux desktop to help users with tasks.
 
@@ -436,7 +438,7 @@ Implement the core AI execution loop that powers desktop control.
 
 Create `lib/services/openai.ts` with the computer use loop:
 
-```typescript
+```typescript JavaScript & TypeScript
 // lib/services/openai.ts
 import OpenAI from 'openai';
 import type { Sandbox } from '@e2b/desktop';
@@ -558,7 +560,7 @@ Create the backend API endpoint that orchestrates sandbox creation and AI execut
 
 Create `app/api/chat/route.ts` for the SSE streaming endpoint:
 
-```typescript
+```typescript JavaScript & TypeScript
 // app/api/chat/route.ts
 import { Sandbox } from '@e2b/desktop';
 import { NextRequest } from 'next/server';
@@ -666,7 +668,7 @@ Add Next.js server actions for sandbox management from the client.
 
 Create `app/actions.ts` for server-side operations:
 
-```typescript
+```typescript JavaScript & TypeScript
 // app/actions.ts
 'use server';
 
@@ -722,7 +724,7 @@ These server actions allow the client to:
 Create `app/page.tsx` with a chat interface, real-time status tracking, VNC viewer, and countdown timer with timeout management.
 
 <Accordion title="View complete app/page.tsx implementation">
-      ```typescript
+      ```typescript JavaScript & TypeScript
       'use client';
 
       import { useState, useRef, useEffect, useCallback } from 'react';
@@ -1763,7 +1765,7 @@ Create `styles/globals.css` with E2B branding, animations, and responsive design
 
 Create `app/layout.tsx` to import the global styles and configure metadata.
 
-```typescript
+```typescript JavaScript & TypeScript
 // app/layout.tsx
 import type { Metadata } from 'next';
 import '../styles/globals.css';
@@ -1846,7 +1848,7 @@ Start the development server and test your AI desktop control application.
 
   <Accordion title="Screenshot quality issues">
     Adjust the screenshot dimensions in `lib/constants.ts`:
-    ```typescript
+    ```typescript JavaScript & TypeScript
     export const SCREENSHOT_CONFIG = {
       MAX_WIDTH: 1280,   // Increase for better quality
       MAX_HEIGHT: 960,   // Increase for better quality