From fe1598c890a22fbebdfdc054a265927ce9a624de Mon Sep 17 00:00:00 2001
From: casjay <git-admin@casjaysdev.pro>
Date: Sun, 21 Jun 2026 18:02:47 -0400
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Fix=20README=20accuracy=20and=20?=
 =?UTF-8?q?section=20order=20=F0=9F=93=9D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Audit found three accuracy bugs and one section ordering violation:
- Add wasm-opt (binaryen) to WASM tools table — installed via pkmgr
in 05-custom.sh but was missing from the tools reference entirely
- Fix wasm32-emscripten → wasm32-unknown-emscripten in cross-compile
targets table (wrong triple name)
- Move "Install and run container" (dockermgr) from position 10 to
immediately after "Pull" — both are production install paths and must
appear before the Development section per canonical section order rules
- Rename "Build the image locally" → "Development" to match canonical
section naming; it is the last substantive section before License
- README.md: add binaryen/wasm-opt row to WASM tools table
- README.md: correct wasm32-unknown-emscripten triple
- README.md: move Install and run container section to top (after Pull)
- README.md: rename build section to Development; move to end

README.md
---
 README.md | 63 ++++++++++++++++++++++++++++---------------------------
 1 file changed, 32 insertions(+), 31 deletions(-)

diff --git a/README.md b/README.md
index 04b4bfa..54f7e19 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,35 @@ docker pull casjaysdev/rust:latest
 
 ---
 
+## 🚀 Install and run container
+
+```shell
+dockermgr update rust
+```
+
+Or manually:
+
+```shell
+dockerHome="/var/lib/srv/$USER/docker/casjaysdevdocker/rust/rust/latest/volumes"
+mkdir -p "$dockerHome"
+git clone "https://github.com/dockermgr/rust" "$HOME/.local/share/CasjaysDev/dockermgr/rust"
+cp -Rfva "$HOME/.local/share/CasjaysDev/dockermgr/rust/rootfs/." "$dockerHome/"
+docker run -d \
+  --restart always \
+  --privileged \
+  --name casjaysdevdocker-rust-latest \
+  --hostname rust \
+  -e TZ=${TIMEZONE:-America/New_York} \
+  -v "$dockerHome/data:/data:z" \
+  -v "$dockerHome/config:/config:z" \
+  -v rust-cargo:/usr/local/share/cargo \
+  -v rust-rustup:/usr/local/share/rustup \
+  -v rust-sccache:/root/.cache/sccache \
+  casjaysdev/rust:latest
+```
+
+---
+
 ## ⚡ rust-workflow
 
 **`rust-workflow`** is a four-step pipeline included in the image. It must
@@ -250,6 +279,7 @@ Run miri with: `cargo +nightly miri test`
 | `wasm-bindgen-cli` | Generate JS/TS bindings for Rust WASM modules |
 | `wasm-tools` | Low-level WASM binary toolkit — validate, transform, component model |
 | `trunk` | Rust/WASM bundler for web frontends — live-reload dev server |
+| `wasm-opt` (binaryen) | WASM binary optimiser — shrinks and speeds up `.wasm` output |
 
 ### Docs
 
@@ -419,7 +449,7 @@ Convenience symlinks so standard tools find their home:
 | Windows GNU | `x86_64-gnu`, `i686-gnu`, `aarch64-gnullvm` |
 | macOS | `x86_64-apple-darwin`, `aarch64-apple-darwin` |
 | BSD | `x86_64-unknown-freebsd` |
-| WASM | `wasm32-unknown-unknown`, `wasm32-wasip1`, `wasm32-wasip2`, `wasm32-emscripten` |
+| WASM | `wasm32-unknown-unknown`, `wasm32-wasip1`, `wasm32-wasip2`, `wasm32-unknown-emscripten` |
 | Embedded ARM | `thumbv6m-none-eabi`, `thumbv7em-none-eabihf`, `thumbv8m.main-none-eabi` |
 | Embedded RISC-V | `riscv32imc-unknown-none-elf`, `riscv32imac-unknown-none-elf` |
 | Android | `aarch64-linux-android` |
@@ -493,36 +523,7 @@ after a refactor rather than in the default CI path.
 
 ---
 
-## 🚀 Install and run container
-
-```shell
-dockermgr update rust
-```
-
-Or manually:
-
-```shell
-dockerHome="/var/lib/srv/$USER/docker/casjaysdevdocker/rust/rust/latest/volumes"
-mkdir -p "$dockerHome"
-git clone "https://github.com/dockermgr/rust" "$HOME/.local/share/CasjaysDev/dockermgr/rust"
-cp -Rfva "$HOME/.local/share/CasjaysDev/dockermgr/rust/rootfs/." "$dockerHome/"
-docker run -d \
-  --restart always \
-  --privileged \
-  --name casjaysdevdocker-rust-latest \
-  --hostname rust \
-  -e TZ=${TIMEZONE:-America/New_York} \
-  -v "$dockerHome/data:/data:z" \
-  -v "$dockerHome/config:/config:z" \
-  -v rust-cargo:/usr/local/share/cargo \
-  -v rust-rustup:/usr/local/share/rustup \
-  -v rust-sccache:/root/.cache/sccache \
-  casjaysdev/rust:latest
-```
-
----
-
-## 🛠️ Build the image locally
+## 🛠️ Development
 
 ```shell
 git clone "https://github.com/dockersrc/rust" "$HOME/Projects/github/dockersrc/rust"