Point install guidance to official docs pages

Author: vmg-dev

README.md

@@ -37,30 +37,16 @@ Docker containers share the host kernel. Gondolin runs workloads inside a VM, so
 
 ## Requirements
 
-- Bun >= 1.2
-- `e2fsprogs` (`mke2fs`, `debugfs`)
-- QEMU (for runtime smoke checks)
-- Docker (only required for `dockerfile2gondolin`)
+- Bun >= 1.2 — https://bun.com/
+- `e2fsprogs` (`mke2fs`, `debugfs`) — https://e2fsprogs.sourceforge.net/
+- QEMU (for runtime smoke checks) — https://www.qemu.org/download/
+- Docker (only required for `dockerfile2gondolin`) — https://docs.docker.com/get-docker/
 
 `docker2vm` uses `@earendil-works/gondolin@0.2.1` as a runtime dependency and resolves/downloads guest assets automatically during conversion.
 
-If you also want to run generated assets with `gondolin exec`, install the CLI separately:
-
-```bash
-bun add -g @earendil-works/gondolin@0.2.1
-```
-
-macOS helpers:
-
-```bash
-brew install e2fsprogs qemu
-```
-
-Ubuntu helpers:
-
-```bash
-sudo apt-get install -y e2fsprogs qemu-system-x86
-```
+If you also want to run generated assets with `gondolin exec`, install the Gondolin CLI:
+- CLI docs: https://earendil-works.github.io/gondolin/cli/
+- Package: https://www.npmjs.com/package/@earendil-works/gondolin
 
 > On macOS, `docker2vm` checks common Homebrew `e2fsprogs` locations automatically; updating `PATH` is usually optional.
 
@@ -93,7 +79,7 @@ The CI integration matrix currently validates:
 - `fedora:41`
 - `archlinux:latest`
 
-For each distro row, tests run a distro-specific probe command (for example `/etc/debian_version`, `/etc/fedora-release`, etc.) and also assert that probe does **not** match on the base Gondolin guest image.
+For each distro row, tests run a distro-specific probe command (for example `/etc/debian_version`, `/etc/fedora-release`, etc.), assert that probe does **not** match on the base Gondolin guest image, and verify `/bin/busybox` executes inside the converted image.
 
 ### Choosing the build platform (`--platform`)
 

docs/linux.md

@@ -6,32 +6,25 @@ This guide is for running `docker2vm` on Linux hosts.
 
 ## 1) Install required tools
 
-### Ubuntu / Debian
+Install tools using their official docs/download pages:
 
-```bash
-sudo apt-get update
-sudo apt-get install -y curl unzip e2fsprogs qemu-system-x86
-```
+- Bun: https://bun.com/
+- QEMU: https://www.qemu.org/download/
+- e2fsprogs: https://e2fsprogs.sourceforge.net/
 
-Install Bun:
+If you want Dockerfile conversion (`dockerfile2gondolin`), also install Docker + Buildx:
 
-```bash
-curl -fsSL https://bun.sh/install | bash
-export BUN_INSTALL="$HOME/.bun"
-export PATH="$BUN_INSTALL/bin:$PATH"
-```
-
-If you want Dockerfile conversion (`dockerfile2gondolin`), install Docker and Buildx.
+- Docker: https://docs.docker.com/get-docker/
+- Buildx: https://docs.docker.com/build/buildx/install/
 
 ## 2) Optional: install Gondolin CLI (for running generated assets)
 
 `docker2vm` is tested with `@earendil-works/gondolin@0.2.1` and can fetch guest assets automatically during conversion.
 
-Install the CLI globally if you want to execute generated assets via `gondolin exec`:
+Use Gondolin CLI install docs:
 
-```bash
-bun add -g @earendil-works/gondolin@0.2.1
-```
+- https://earendil-works.github.io/gondolin/cli/
+- Package page: https://www.npmjs.com/package/@earendil-works/gondolin
 
 ## 3) Verify toolchain
 

docs/macos.md

@@ -6,11 +6,14 @@ This guide is for running `docker2vm` on macOS (Apple Silicon or Intel).
 
 ## 1) Install required tools
 
-```bash
-brew install bun qemu e2fsprogs
-```
+Install tools using their official docs/download pages:
+
+- Bun: https://bun.com/
+- QEMU: https://www.qemu.org/download/
+- e2fsprogs: https://e2fsprogs.sourceforge.net/
 
-If you want Dockerfile conversion (`dockerfile2gondolin`), also install Docker Desktop.
+If you want Dockerfile conversion (`dockerfile2gondolin`), also install Docker Desktop:
+- https://docs.docker.com/desktop/setup/install/mac-install/
 
 ## 2) Optional: add `e2fsprogs` binaries to `PATH`
 
@@ -28,11 +31,11 @@ To persist it, add that `export PATH=...` line to your shell profile (`~/.zshrc`
 
 `docker2vm` is tested with `@earendil-works/gondolin@0.2.1` and can fetch guest assets automatically during conversion.
 
-Install the CLI globally if you want to execute generated assets via `gondolin exec`:
+Gondolin CLI docs:
+- https://earendil-works.github.io/gondolin/cli/
 
-```bash
-bun add -g @earendil-works/gondolin@0.2.1
-```
+Package page:
+- https://www.npmjs.com/package/@earendil-works/gondolin
 
 ## 4) Verify toolchain