Update docs

Author: vshymanskyy

BUILDING.md

@@ -0,0 +1,42 @@
+
+# Build `wasm2mpy`
+
+> [!WARNING]
+> **This is a Proof-of-Concept, not optimized or ready for actual use.**
+
+You'll need:
+
+- Python 3
+  - `pip install --upgrade pyelftools ar`
+- `wasm2c` from [WABT](https://github.com/WebAssembly/wabt/releases/tag/1.0.36)
+- Latest [MicroPython](https://github.com/micropython/micropython) source code
+- Target architecture toolchain
+
+Set up the environment and build the `.mpy` module from `.wasm`:
+
+```sh
+export MPY_DIR=/path/to/micropython
+export PATH=/opt/wabt/bin:$PATH
+export PATH=/opt/xtensa-lx106-elf/bin:$PATH
+export PATH=/opt/xtensa-esp32-elf/bin:$PATH
+pip install -U pyelftools
+make ARCH=xtensawin APP=zig   # x86, x64, armv6m, armv7m, armv7emsp, armv7emdp, xtensa, xtensawin
+```
+
+Output:
+
+```log
+W2C test/zig.wasm
+GEN build/zig.config.h
+CC runtime/runtime.c
+CC runtime/wasm-rt-mem-impl.c
+CC runtime/wasm-rt-impl.c
+CC .wasm/wasm.c
+LINK build/runtime/runtime.o
+arch:         EM_XTENSA
+text size:    3524
+rodata size:  850
+bss size:     144
+GOT entries:  57
+GEN zig.mpy
+```

README.md

@@ -36,50 +36,10 @@
 - **iMXRT1062** 600MHz: `1911.437`
 - **i5-8250U** 1.6GHz: `18696.248`
 
-## Compile
-
-> [!IMPORTANT]
-> **This is a Proof-of-Concept, not optimized or ready for actual use.**
-
-You'll need:
-
-- Python 3
-  - `pip install --upgrade pyelftools ar`
-- `wasm2c` from [WABT](https://github.com/WebAssembly/wabt/releases/tag/1.0.36)
-- Latest [MicroPython](https://github.com/micropython/micropython) source code
-- Target architecture toolchain
-
-Set up the environment and build the `.mpy` module from `.wasm`:
-
-```sh
-export MPY_DIR=/path/to/micropython
-export PATH=/opt/wabt/bin:$PATH
-export PATH=/opt/xtensa-lx106-elf/bin:$PATH
-export PATH=/opt/xtensa-esp32-elf/bin:$PATH
-pip install -U pyelftools
-make ARCH=xtensawin APP=zig   # x86, x64, armv6m, armv7m, armv7emsp, armv7emdp, xtensa, xtensawin
-```
-
-Output:
-
-```log
-W2C test/zig.wasm
-GEN build/zig.config.h
-CC runtime/runtime.c
-CC runtime/wasm-rt-mem-impl.c
-CC runtime/wasm-rt-impl.c
-CC .wasm/wasm.c
-LINK build/runtime/runtime.o
-arch:         EM_XTENSA
-text size:    3524
-rodata size:  850
-bss size:     144
-GOT entries:  57
-GEN zig.mpy
-```
-
 ## Upload and Run
 
+Follow the [build instructions](BUILDING.md)
+
 ```sh
 mpremote cp zig.mpy :lib/
 mpremote exec "import zig; zig.setup()"