From 63545ed9182e6429d7a0ed09fd5d782fed336e0d Mon Sep 17 00:00:00 2001
From: hanez <you@hanez.org>
Date: Wed, 15 Apr 2026 01:25:17 +0200
Subject: [PATCH] Documentation refactoring. No code changes. (0.40.5)

---
 lib/ui/tk.fun                                 |  60 -----
 web/documentation/{ => arrays}/arrays.md      |  46 ++--
 web/documentation/{ => asyncio}/asyncio.md    |   8 +-
 web/documentation/{ => build}/build.md        |   6 +-
 .../{ => bytecode-format}/bytecode-format.md  |   2 +-
 web/documentation/{ => cli}/cli.md            |  24 +-
 .../{ => contributing}/contributing.md        |  12 +-
 web/documentation/documentation.md            |  77 +++---
 .../{ => embedding}/embedding.md              |  10 +-
 .../errors-and-diagnostics.md                 |   2 +-
 web/documentation/examples/README.md          | 246 ------------------
 .../examples/builtins_extended.md             |  28 --
 .../examples/builtins_maps_and_more.md        |  27 --
 web/documentation/examples/byte_for_demo.md   |  24 --
 .../examples/byte_overflow_try_catch.md       |  24 --
 web/documentation/examples/cast_demo.md       |  24 --
 .../examples/class_constructor.md             |  24 --
 web/documentation/examples/class_test.md      |  27 --
 .../examples/class_without_object.md          |  24 --
 web/documentation/examples/classes_demo.md    |  24 --
 web/documentation/examples/cli_argv_dump.md   |  24 --
 .../examples/conversions_showcase.md          |  24 --
 web/documentation/examples/cpp_add.md         |  27 --
 .../examples/data/htdocs/counter.md           |  33 ---
 .../examples/data/htdocs/form_post.md         |  33 ---
 .../examples/data/htdocs/hello.md             |  33 ---
 .../examples/data/htdocs/info.md              |  33 ---
 .../examples/data/htdocs/json_like_api.md     |  33 ---
 .../examples/data/htdocs/redirect.md          |  33 ---
 web/documentation/examples/datetime_basic.md  |  24 --
 .../examples/datetime_extended.md             |  24 --
 web/documentation/examples/datetime_timer.md  |  24 --
 web/documentation/examples/echo_example.md    |  24 --
 web/documentation/examples/env_all.md         |  24 --
 web/documentation/examples/error_handling.md  |  24 --
 web/documentation/{ => examples}/examples.md  |   2 +-
 .../examples/expressions_test.md              |  24 --
 web/documentation/examples/features.md        |  24 --
 .../file_print_for_file_line_by_line.md       |  24 --
 web/documentation/examples/floats.md          |  24 --
 web/documentation/examples/for_range_test.md  |  24 --
 web/documentation/examples/functions_test.md  |  24 --
 web/documentation/examples/have_fun.md        |  24 --
 .../examples/have_fun_function.md             |  24 --
 web/documentation/examples/hex_example.md     |  24 --
 web/documentation/examples/if_else_test.md    |  24 --
 web/documentation/examples/include_lib.md     |  24 --
 web/documentation/examples/include_local.md   |  24 --
 .../examples/include_local_util.md            |  24 --
 .../examples/inheritance_demo.md              |  24 --
 .../examples/loops_break_continue.md          |  24 --
 web/documentation/examples/maps.md            |  31 ---
 web/documentation/examples/match.md           |  24 --
 web/documentation/examples/namespaced_mod.md  |  24 --
 web/documentation/examples/nested_loops.md    |  24 --
 .../examples/net/http_mt_server.md            |  36 ---
 .../examples/net/http_mt_server_cgi.md        |  38 ---
 web/documentation/examples/net/http_server.md |  40 ---
 .../examples/net/http_server_cgi.md           |  38 ---
 .../examples/net/http_server_cgi_lib.md       |  38 ---
 .../examples/net/http_static_server.md        |  36 ---
 web/documentation/examples/net/httpserver.md  | 155 -----------
 web/documentation/examples/objects_basic.md   |  24 --
 web/documentation/examples/objects_more.md    |  24 --
 web/documentation/examples/os_env.md          |  24 --
 web/documentation/examples/process_example.md |  24 --
 web/documentation/examples/progress.md        |  24 --
 web/documentation/examples/progress_inline.md |  24 --
 web/documentation/examples/random_demo.md     |  24 --
 .../examples/random_number_example.md         |  24 --
 web/documentation/examples/regex_demo.md      |  27 --
 .../examples/regex_procedural.md              |  27 --
 web/documentation/examples/rust_hello.md      |  27 --
 web/documentation/examples/rust_hello_args.md |  27 --
 .../examples/rust_hello_args_return.md        |  27 --
 web/documentation/examples/serial_demo.md     |  27 --
 .../examples/short_circuit_test.md            |  24 --
 web/documentation/examples/signed_ints.md     |  24 --
 web/documentation/examples/stdlib_showcase.md |  24 --
 web/documentation/examples/strings_test.md    |  24 --
 web/documentation/examples/tcp_http_get.md    |  27 --
 .../examples/tcp_http_get_class.md            |  27 --
 web/documentation/examples/test_bits.md       |  24 --
 web/documentation/examples/test_dec_to_hex.md |  24 --
 web/documentation/examples/test_hex_to_dec.md |  24 --
 web/documentation/examples/test_include.md    |  24 --
 web/documentation/examples/test_rol.md        |  24 --
 web/documentation/examples/test_serial.md     |  27 --
 web/documentation/examples/test_shl.md        |  24 --
 web/documentation/examples/test_types.md      |  24 --
 web/documentation/examples/test_xor.md        |  24 --
 .../examples/thread_class_example.md          |  24 --
 web/documentation/examples/threads_demo.md    |  24 --
 .../examples/try_catch_finally.md             |  24 --
 web/documentation/examples/type_safety.md     |  24 --
 .../examples/type_safety_fails.md             |  24 --
 web/documentation/examples/typeof.md          |  24 --
 web/documentation/examples/typeof_features.md |  24 --
 web/documentation/examples/types_integers.md  |  24 --
 web/documentation/examples/types_overview.md  |  24 --
 web/documentation/examples/uint_types.md      |  24 --
 .../examples/unix_socket_echo.md              |  27 --
 web/documentation/examples/version.md         |  24 --
 web/documentation/examples/while_test.md      |  24 --
 web/documentation/external/{ => curl}/curl.md |   3 +-
 .../external/{ => external}/external.md       |   2 +-
 web/documentation/external/{ => ini}/ini.md   |   2 +-
 web/documentation/external/{ => json}/json.md |   2 +-
 .../external/{ => openssl}/openssl.md         |   2 +-
 .../external/{ => pcre2}/pcre2.md             |   2 +-
 web/documentation/external/{ => pcsc}/pcsc.md |   2 +-
 .../external/{ => sqlite}/sqlite.md           |   2 +-
 web/documentation/external/{ => xml2}/xml2.md |   2 +-
 web/documentation/{ => faq}/faq.md            |  10 +-
 web/documentation/{ => fun}/fun.md            |  39 +--
 web/documentation/{ => funstx}/funstx.md      |  19 +-
 web/documentation/{ => handbook}/handbook.md  |   1 -
 web/documentation/{ => includes}/includes.md  |  14 +-
 .../{ => internals}/internals.md              |  41 ++-
 web/documentation/{ => maps}/maps.md          |  46 ++--
 web/documentation/{ => numbers}/numbers.md    |  55 ++--
 web/documentation/{ => opcodes}/opcodes.md    |   1 -
 .../{ => performance}/performance.md          |   5 +-
 web/documentation/{ => repl}/repl.md          |  36 +--
 web/documentation/{ => roadmap}/roadmap.md    |  12 +-
 web/documentation/{ => rust}/rust.md          |  45 ++--
 .../security-and-sandboxing.md                |   4 +-
 web/documentation/{ => stdlib}/stdlib.md      |  34 ++-
 web/documentation/{ => strings}/strings.md    |  36 +--
 .../{ => style-guide}/style-guide.md          |   1 -
 web/documentation/{ => testing}/testing.md    |  17 +-
 .../{ => troubleshooting}/troubleshooting.md  |  19 +-
 web/documentation/{ => types}/types.md        |  35 +--
 web/documentation/{ => vm}/vm.md              |  14 +-
 web/documentation/{ => website}/website.md    |   9 +-
 .../{ => writing-tests}/writing-tests.md      |   5 +-
 136 files changed, 374 insertions(+), 3163 deletions(-)
 delete mode 100644 lib/ui/tk.fun
 rename web/documentation/{ => arrays}/arrays.md (88%)
 rename web/documentation/{ => asyncio}/asyncio.md (96%)
 rename web/documentation/{ => build}/build.md (96%)
 rename web/documentation/{ => bytecode-format}/bytecode-format.md (97%)
 rename web/documentation/{ => cli}/cli.md (82%)
 rename web/documentation/{ => contributing}/contributing.md (83%)
 rename web/documentation/{ => embedding}/embedding.md (69%)
 rename web/documentation/{ => errors-and-diagnostics}/errors-and-diagnostics.md (96%)
 delete mode 100644 web/documentation/examples/README.md
 delete mode 100644 web/documentation/examples/builtins_extended.md
 delete mode 100644 web/documentation/examples/builtins_maps_and_more.md
 delete mode 100644 web/documentation/examples/byte_for_demo.md
 delete mode 100644 web/documentation/examples/byte_overflow_try_catch.md
 delete mode 100644 web/documentation/examples/cast_demo.md
 delete mode 100644 web/documentation/examples/class_constructor.md
 delete mode 100644 web/documentation/examples/class_test.md
 delete mode 100644 web/documentation/examples/class_without_object.md
 delete mode 100644 web/documentation/examples/classes_demo.md
 delete mode 100644 web/documentation/examples/cli_argv_dump.md
 delete mode 100644 web/documentation/examples/conversions_showcase.md
 delete mode 100644 web/documentation/examples/cpp_add.md
 delete mode 100644 web/documentation/examples/data/htdocs/counter.md
 delete mode 100644 web/documentation/examples/data/htdocs/form_post.md
 delete mode 100644 web/documentation/examples/data/htdocs/hello.md
 delete mode 100644 web/documentation/examples/data/htdocs/info.md
 delete mode 100644 web/documentation/examples/data/htdocs/json_like_api.md
 delete mode 100644 web/documentation/examples/data/htdocs/redirect.md
 delete mode 100644 web/documentation/examples/datetime_basic.md
 delete mode 100644 web/documentation/examples/datetime_extended.md
 delete mode 100644 web/documentation/examples/datetime_timer.md
 delete mode 100644 web/documentation/examples/echo_example.md
 delete mode 100644 web/documentation/examples/env_all.md
 delete mode 100644 web/documentation/examples/error_handling.md
 rename web/documentation/{ => examples}/examples.md (95%)
 delete mode 100644 web/documentation/examples/expressions_test.md
 delete mode 100644 web/documentation/examples/features.md
 delete mode 100644 web/documentation/examples/file_print_for_file_line_by_line.md
 delete mode 100644 web/documentation/examples/floats.md
 delete mode 100644 web/documentation/examples/for_range_test.md
 delete mode 100644 web/documentation/examples/functions_test.md
 delete mode 100644 web/documentation/examples/have_fun.md
 delete mode 100644 web/documentation/examples/have_fun_function.md
 delete mode 100644 web/documentation/examples/hex_example.md
 delete mode 100644 web/documentation/examples/if_else_test.md
 delete mode 100644 web/documentation/examples/include_lib.md
 delete mode 100644 web/documentation/examples/include_local.md
 delete mode 100644 web/documentation/examples/include_local_util.md
 delete mode 100644 web/documentation/examples/inheritance_demo.md
 delete mode 100644 web/documentation/examples/loops_break_continue.md
 delete mode 100644 web/documentation/examples/maps.md
 delete mode 100644 web/documentation/examples/match.md
 delete mode 100644 web/documentation/examples/namespaced_mod.md
 delete mode 100644 web/documentation/examples/nested_loops.md
 delete mode 100644 web/documentation/examples/net/http_mt_server.md
 delete mode 100644 web/documentation/examples/net/http_mt_server_cgi.md
 delete mode 100644 web/documentation/examples/net/http_server.md
 delete mode 100644 web/documentation/examples/net/http_server_cgi.md
 delete mode 100644 web/documentation/examples/net/http_server_cgi_lib.md
 delete mode 100644 web/documentation/examples/net/http_static_server.md
 delete mode 100644 web/documentation/examples/net/httpserver.md
 delete mode 100644 web/documentation/examples/objects_basic.md
 delete mode 100644 web/documentation/examples/objects_more.md
 delete mode 100644 web/documentation/examples/os_env.md
 delete mode 100644 web/documentation/examples/process_example.md
 delete mode 100644 web/documentation/examples/progress.md
 delete mode 100644 web/documentation/examples/progress_inline.md
 delete mode 100644 web/documentation/examples/random_demo.md
 delete mode 100644 web/documentation/examples/random_number_example.md
 delete mode 100644 web/documentation/examples/regex_demo.md
 delete mode 100644 web/documentation/examples/regex_procedural.md
 delete mode 100644 web/documentation/examples/rust_hello.md
 delete mode 100644 web/documentation/examples/rust_hello_args.md
 delete mode 100644 web/documentation/examples/rust_hello_args_return.md
 delete mode 100644 web/documentation/examples/serial_demo.md
 delete mode 100644 web/documentation/examples/short_circuit_test.md
 delete mode 100644 web/documentation/examples/signed_ints.md
 delete mode 100644 web/documentation/examples/stdlib_showcase.md
 delete mode 100644 web/documentation/examples/strings_test.md
 delete mode 100644 web/documentation/examples/tcp_http_get.md
 delete mode 100644 web/documentation/examples/tcp_http_get_class.md
 delete mode 100644 web/documentation/examples/test_bits.md
 delete mode 100644 web/documentation/examples/test_dec_to_hex.md
 delete mode 100644 web/documentation/examples/test_hex_to_dec.md
 delete mode 100644 web/documentation/examples/test_include.md
 delete mode 100644 web/documentation/examples/test_rol.md
 delete mode 100644 web/documentation/examples/test_serial.md
 delete mode 100644 web/documentation/examples/test_shl.md
 delete mode 100644 web/documentation/examples/test_types.md
 delete mode 100644 web/documentation/examples/test_xor.md
 delete mode 100644 web/documentation/examples/thread_class_example.md
 delete mode 100644 web/documentation/examples/threads_demo.md
 delete mode 100644 web/documentation/examples/try_catch_finally.md
 delete mode 100644 web/documentation/examples/type_safety.md
 delete mode 100644 web/documentation/examples/type_safety_fails.md
 delete mode 100644 web/documentation/examples/typeof.md
 delete mode 100644 web/documentation/examples/typeof_features.md
 delete mode 100644 web/documentation/examples/types_integers.md
 delete mode 100644 web/documentation/examples/types_overview.md
 delete mode 100644 web/documentation/examples/uint_types.md
 delete mode 100644 web/documentation/examples/unix_socket_echo.md
 delete mode 100644 web/documentation/examples/version.md
 delete mode 100644 web/documentation/examples/while_test.md
 rename web/documentation/external/{ => curl}/curl.md (91%)
 rename web/documentation/external/{ => external}/external.md (100%)
 rename web/documentation/external/{ => ini}/ini.md (91%)
 rename web/documentation/external/{ => json}/json.md (89%)
 rename web/documentation/external/{ => openssl}/openssl.md (96%)
 rename web/documentation/external/{ => pcre2}/pcre2.md (92%)
 rename web/documentation/external/{ => pcsc}/pcsc.md (92%)
 rename web/documentation/external/{ => sqlite}/sqlite.md (90%)
 rename web/documentation/external/{ => xml2}/xml2.md (92%)
 rename web/documentation/{ => faq}/faq.md (74%)
 rename web/documentation/{ => fun}/fun.md (80%)
 rename web/documentation/{ => funstx}/funstx.md (97%)
 rename web/documentation/{ => handbook}/handbook.md (99%)
 rename web/documentation/{ => includes}/includes.md (98%)
 rename web/documentation/{ => internals}/internals.md (99%)
 rename web/documentation/{ => maps}/maps.md (90%)
 rename web/documentation/{ => numbers}/numbers.md (87%)
 rename web/documentation/{ => opcodes}/opcodes.md (99%)
 rename web/documentation/{ => performance}/performance.md (99%)
 rename web/documentation/{ => repl}/repl.md (93%)
 rename web/documentation/{ => roadmap}/roadmap.md (58%)
 rename web/documentation/{ => rust}/rust.md (84%)
 rename web/documentation/{ => security-and-sandboxing}/security-and-sandboxing.md (99%)
 rename web/documentation/{ => stdlib}/stdlib.md (59%)
 rename web/documentation/{ => strings}/strings.md (87%)
 rename web/documentation/{ => style-guide}/style-guide.md (99%)
 rename web/documentation/{ => testing}/testing.md (94%)
 rename web/documentation/{ => troubleshooting}/troubleshooting.md (93%)
 rename web/documentation/{ => types}/types.md (89%)
 rename web/documentation/{ => vm}/vm.md (93%)
 rename web/documentation/{ => website}/website.md (93%)
 rename web/documentation/{ => writing-tests}/writing-tests.md (99%)

diff --git a/lib/ui/tk.fun b/lib/ui/tk.fun
deleted file mode 100644
index ca062b5..0000000
--- a/lib/ui/tk.fun
+++ /dev/null
@@ -1,60 +0,0 @@
-#!/usr/bin/env fun
-
-/*
- * This file is part of the Fun programming language.
- * https://fun-lang.xyz/
- *
- * Copyright 2025 Johannes Findeisen <you@hanez.org>
- * Licensed under the terms of the Apache-2.0 license.
- * https://opensource.org/license/apache-2-0
- *
- * Added: 2025-12-09
- */
-
-// Tk stdlib helper wrapping the Tk VM builtins.
-// No raw Tcl is exposed; this class provides a tiny, safe GUI surface.
-
-class TK()
-  // Set the window title
-  fun title(this, title)
-    return tk_title(to_string(title))
-
-  // Create or update a label widget with id and text
-  fun label(this, id, text)
-    return tk_label(to_string(id), to_string(text))
-
-  // Create or update a button widget with id and text
-  fun button(this, id, text)
-    return tk_button(to_string(id), to_string(text))
-
-  // Pack a widget by id
-  fun pack(this, id)
-    return tk_pack(to_string(id))
-
-  // Create a listbox widget
-  fun listbox(this, id)
-    return tk_eval("listbox ." + to_string(id))
-
-  // Insert text into a widget (like listbox) at index
-  fun insert(this, id, index, text)
-    return tk_eval("." + to_string(id) + " insert " + to_string(index) + " {" + to_string(text) + "}")
-
-  // Clear a widget (like listbox)
-  fun clear(this, id)
-    return tk_eval("." + to_string(id) + " delete 0 end")
-
-  // Bind an event to a command
-  fun bind(this, id, event, cmd)
-    return tk_bind(to_string(id), to_string(event), to_string(cmd))
-
-  // Evaluate raw Tcl script
-  fun eval(this, script)
-    return tk_eval(to_string(script))
-
-  // Get last Tcl result
-  fun result(this)
-    return tk_result()
-
-  // Enter the Tk event loop (blocks until windows are closed)
-  fun loop(this)
-    return tk_loop()
diff --git a/web/documentation/arrays.md b/web/documentation/arrays/arrays.md
similarity index 88%
rename from web/documentation/arrays.md
rename to web/documentation/arrays/arrays.md
index c1b54f7..2342dd3 100644
--- a/web/documentation/arrays.md
+++ b/web/documentation/arrays/arrays.md
@@ -20,7 +20,6 @@ tags:
 - slicing
 ---
 
-
 This guide focuses on arrays: creation, indexing, mutation, iteration, slicing, and common gotchas. It complements the quick overview in types.md with a deeper, example‑driven treatment.
 
 ## What is an array?
@@ -40,8 +39,7 @@ empty = []
 grid = [[1,2], [3,4]]
 
 print(typeof(a))   // "array"
-print(len(a))      // 3
-</pre>
+print(len(a))      // 3</pre>
 
 Tip: Prefer square‑bracket literals for clarity and performance versus building via repeated push in a hot loop.
 
@@ -53,9 +51,10 @@ print(a[2])   // 30
 
 // update in place
 a[1] = 42
-print(a)      // [10, 42, 30]
-</pre>
+print(a)      // [10, 42, 30]</pre>
+
 Notes:
+
 - Valid indices are 0..len(a)-1. Using an invalid index raises a runtime error.
 - Assignment updates the existing array; references pointing to it observe the change.
 
@@ -74,8 +73,8 @@ a = [1, 2, 3]
 insert(a, 1, 99)    // a => [1, 99, 2, 3]
 
 // remove at index (shifts left)
-remove(a, 2)        // a => [1, 99, 3]
-</pre>
+remove(a, 2)        // a => [1, 99, 3]</pre>
+
 ## Slicing and concatenation
 
 <pre>a = [0,1,2,3,4]
@@ -86,8 +85,8 @@ mid  = slice(a, 1, 4)   // [1,2,3]
 
 // concat: join two arrays
 b = ["x", "y"]
-ab = concat(a, b)       // [0,1,2,3,4,"x","y"]
-</pre>
+ab = concat(a, b)       // [0,1,2,3,4,"x","y"]</pre>
+
 Slicing returns a new array. The original is unchanged.
 
 ## Iteration patterns
@@ -105,8 +104,8 @@ for pair in it.enumerate(a) {
   idx = pair[0]
   val = pair[1]
   print(to_string(idx) + ":" + val)
-}
-</pre>
+}</pre>
+
 ## Copying vs. referencing
 
 Arrays are reference types. Assigning just copies the reference, not the contents:
@@ -120,15 +119,15 @@ print(orig)         // [9, 2]
 copy = slice(orig, 0, len(orig))
 copy[1] = 7
 print(orig)         // [9, 2]
-print(copy)         // [9, 7]
-</pre>
+print(copy)         // [9, 7]</pre>
+
 Shallow copies duplicate the top‑level array but not nested structures.
 
 ## Equality
 
 <pre>print([1,2] == [1,2])   // true
-print([1,2] == [2,1])   // false
-</pre>
+print([1,2] == [2,1])   // false</pre>
+
 Array equality compares length and element‑wise equality recursively.
 
 ## Common utilities
@@ -148,9 +147,10 @@ Check your lib directory (e.g., lib/utils) for additional helpers.
 ## Error handling and bounds
 
 <pre>a = [0]
-// a[1] is out of range → runtime error
-</pre>
+// a[1] is out of range → runtime error</pre>
+
 Tips:
+
 - Guard indices: if i < 0 or i >= len(a) { /* handle */ }
 - Use remove/insert carefully inside loops; indices of following items change.
 
@@ -163,8 +163,8 @@ print(users[1]["name"])    // Lin
 // split/join patterns depend on your stdlib
 #include <utils/strings.fun> as su  // adjust if present in your tree
 parts = su.split("a,b,c", ",")    // ["a","b","c"]
-csv   = su.join(parts, ",")       // "a,b,c"
-</pre>
+csv   = su.join(parts, ",")       // "a,b,c"</pre>
+
 ## Performance tips
 
 - Preallocate by building from literals or chunked appends rather than one‑by‑one in very tight loops.
@@ -191,9 +191,9 @@ for i = 0; i < len(nested); i = i + 1 {
     push(flat, row[j])
   }
 }
-print(flat) // [1,2,3,4,5]
-</pre>
+print(flat) // [1,2,3,4,5]</pre>
+
 ## See also
 
-- types.md — broader overview of core types with quick array examples.
-- examples/ — many scripts operate on arrays; try play.fun to explore.
+- [../types/](../types/) — broader overview of core types with quick array examples.
+- [../examples/](../examples/) — many scripts operate on arrays; try play.fun to explore.
diff --git a/web/documentation/asyncio.md b/web/documentation/asyncio/asyncio.md
similarity index 96%
rename from web/documentation/asyncio.md
rename to web/documentation/asyncio/asyncio.md
index 6dcfc06..64b5385 100644
--- a/web/documentation/asyncio.md
+++ b/web/documentation/asyncio/asyncio.md
@@ -214,7 +214,7 @@ A: You can prototype small non-blocking fragments in the REPL, but full networki
 
 ## See also
 
-- [examples.md](./examples/) — Running bundled examples
-- [includes.md](./includes/) — Include paths and library discovery
-- [opcodes.md](./opcodes/) — VM opcodes overview
-- [troubleshooting.md](./troubleshooting/) — Common issues and quick fixes
+- [../examples/](../examples/) — Running bundled examples
+- [../includes/](../includes/) — Include paths and library discovery
+- [../opcodes/](../opcodes/) — VM opcodes overview
+- [../troubleshooting/](../troubleshooting/) — Common issues and quick fixes
diff --git a/web/documentation/build.md b/web/documentation/build/build.md
similarity index 96%
rename from web/documentation/build.md
rename to web/documentation/build/build.md
index 5b7e0e3..6c7bb5a 100644
--- a/web/documentation/build.md
+++ b/web/documentation/build/build.md
@@ -61,6 +61,8 @@ These are defined as `CACHE` variables, so they will persist in your `CMakeCache
 
 When configuring, the build prints a summary like:
 
+See [../vm/](../vm/) for more information.
+
 <pre>==== Fun build options ====
   FUN_DEBUG: ENABLED|DISABLED
   FUN_USE_MUSL: ENABLED|DISABLED
@@ -97,7 +99,7 @@ If `FUN_WITH_OPENSSL` is enabled, CMake must detect your system OpenSSL (libcryp
 
 ## Running
 - CLI: run the `fun` executable from your build directory.
-- REPL: `fun -i` or just run `fun` without a script, depending on your CLI version (see [cli.md](./cli/)).
-- Examples: see [examples.md](./examples/).
+- REPL: `fun -i` or just run `fun` without a script, depending on your CLI version (see [../cli/](../cli/)).
+- Examples: see [../examples/](../examples/).
 
 Tip: When running from the repository without installation, set `FUN_LIB_DIR` to the local `./lib` so includes can find the stdlib.
diff --git a/web/documentation/bytecode-format.md b/web/documentation/bytecode-format/bytecode-format.md
similarity index 97%
rename from web/documentation/bytecode-format.md
rename to web/documentation/bytecode-format/bytecode-format.md
index 1011692..b28dcff 100644
--- a/web/documentation/bytecode-format.md
+++ b/web/documentation/bytecode-format/bytecode-format.md
@@ -20,7 +20,7 @@ tags:
 ---
 
 
-This document summarizes the Fun bytecode format. For deep VM details, see [internals.md](./internals/).
+This document summarizes the Fun bytecode format. For deep VM details, see [internals](./internals/).
 
 ## Goals
 - Compact representation for fast loading and dispatch
diff --git a/web/documentation/cli.md b/web/documentation/cli/cli.md
similarity index 82%
rename from web/documentation/cli.md
rename to web/documentation/cli/cli.md
index 8b8fcb8..ac63ec4 100644
--- a/web/documentation/cli.md
+++ b/web/documentation/cli/cli.md
@@ -23,17 +23,18 @@ tags:
 - synopsis
 ---
 
-
 Reference for the `fun` command-line interface.
 
-For a complete usage guide (including REPL details, environment variables, include paths, examples, and install locations), see [fun.md](./fun/).
+For a complete usage guide (including REPL details, environment variables, include paths, examples, and install locations), see [fun](./fun/).
 
 ## Synopsis
-<pre>fun [options] <script.fun> [-- args...]
-</pre>
-If no script is supplied and interactive mode is available, `fun` starts a REPL (see [repl.md](./repl/)).
+
+<pre>fun [options] [script.fun] [-- args...]</pre>
+
+If no script is supplied and interactive mode is available, `fun` starts a REPL (see [../repl/](../repl/)).
 
 ## Common options
+
 - `-i`, `--repl` - start an interactive REPL
 - `-v`, `--version` - print version and exit
 - `-h`, `--help` - show help and exit
@@ -41,19 +42,22 @@ If no script is supplied and interactive mode is available, `fun` starts a REPL
 Options may vary between versions; run `fun --help` to see what your build supports.
 
 ## Exit codes
+
 - `0` - success
 - non-zero - error during parse, compile, or runtime
 
 ## Includes and library paths
+
 - `FUN_LIB_DIR` - environment variable that points to the stdlib location; when running from the repo, set this to `./lib`.
 - `DEFAULT_LIB_DIR` - compiled-in fallback path determined at build/install time.
 
-See also: [includes.md](./includes/) for namespaced includes and search order.
+See also: [../includes/](../includes/) for namespaced includes and search order.
 
 ## Examples
+
 Run a script:
-<pre>FUN_LIB_DIR=./lib ./build/fun examples/hello.fun
-</pre>
+<pre>FUN_LIB_DIR=./lib ./build/fun examples/hello.fun</pre>
+
 Start the REPL:
-<pre>./build/fun -i
-</pre>
\ No newline at end of file
+
+<pre>./build/fun -i</pre>
diff --git a/web/documentation/contributing.md b/web/documentation/contributing/contributing.md
similarity index 83%
rename from web/documentation/contributing.md
rename to web/documentation/contributing/contributing.md
index 957f988..caa638f 100644
--- a/web/documentation/contributing.md
+++ b/web/documentation/contributing/contributing.md
@@ -25,9 +25,9 @@ tags:
 Thanks for your interest in contributing! This guide covers the basics to get you productive quickly.
 
 ## Getting started
-- Clone the repo and build (see [build/](../build/)).
-- Run tests locally (see [testing/](../testing/)).
-- Explore examples (see [examples/](../examples/)).
+- Clone the repo and build (see [../build/](../build/)).
+- Run tests locally (see [../testing/](../testing/)).
+- Explore examples (see [../examples/](../examples/)).
 
 ## Project structure
 - `src/` - C core, VM, and opcode implementations ([https://git.xw3.org/fun/fun/src/branch/main/src/](https://git.xw3.org/fun/fun/src/branch/main/src/){:class="git"}).
@@ -42,11 +42,11 @@ Thanks for your interest in contributing! This guide covers the basics to get yo
 ## Code style
 - C: C99, two-space indent, no tabs. Keep functions short and focused.
 - Fun: two-space indent, snake_case for functions, PascalCase for classes/constructors.
-- Prefer clear names over abbreviations. See [style-guide/](../style-guide/).
+- Prefer clear names over abbreviations. See [../style-guide/](../style-guide/).
 
 ## Development workflow
 1. Create a small, focused branch.
-2. Add/adjust tests for behavior changes (see [writing-tests](../writing-tests/)).
+2. Add/adjust tests for behavior changes (see [../writing-tests](../writing-tests/)).
 3. Update docs if user-visible behavior changes.
 4. Submit a PR with a clear description and rationale.
 
@@ -62,4 +62,4 @@ Please include:
 - `fun --version` output
 
 ## Code of Conduct
-Be respectful and inclusive. See [https://git.xw3.org/fun/fun/src/branch/main/CODE_OF_CONDUCT.md](https://git.xw3.org/fun/fun/src/branch/main/CODE_OF_CONDUCT.md){:class="git"} in the repository root.
+Be respectful and inclusive. See [https://git.xw3.org/fun/fun/src/branch/main/CODE_OF_CONDUCT.md](https://git.xw3.org/fun/fun/src/branch/main/CODE_OF_CONDUCT/){:class="git"} in the repository root.
diff --git a/web/documentation/documentation.md b/web/documentation/documentation.md
index 3c73cac..d7638e7 100644
--- a/web/documentation/documentation.md
+++ b/web/documentation/documentation.md
@@ -15,17 +15,16 @@ tags:
 - programming
 ---
 
-
 This file serves as an index of the documents in this directory. Links are relative and can be opened directly on Git hosting or locally.
 
 ## Basics
 
-- [handbook/](./handbook/) - Comprehensive handbook for the Fun language and VM: install/build, configuration flags, usage, and full feature overview.
-- [Fun REPL Guide](./repl/) - REPL guide: how to build/launch, editing and history, completions, REPL-on-error, and tips.
-- [Specification v0.4](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.4.md){:class="git"}
-- [Specification v0.3](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.3.md){:class="git"}
-- [Specification v0.2](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.2.md){:class="git"}
-- [Specification v0.1](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.1.md){:class="git"}
+- [./handbook/](./handbook/) - Comprehensive handbook for the Fun language and VM: install/build, configuration flags, usage, and full feature overview.
+- [./repl/](./repl/) - REPL user guide: how to build/launch, editing and history, completions, REPL-on-error, and tips.
+- [Specification v0.4](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.4/){:class="git"}
+- [Specification v0.3](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.3/){:class="git"}
+- [Specification v0.2](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.2/){:class="git"}
+- [Specification v0.1](https://git.xw3.org/fun/fun/src/branch/main/spec/v0.1/){:class="git"}
 - [Examples](https://git.xw3.org/fun/fun/src/branch/main/examples){:class="git"}
 - [Standard Library](https://git.xw3.org/fun/fun/src/branch/main/lib){:class="git"}
 
@@ -33,43 +32,43 @@ The examples directory contains demonstrations of most Fun features, from basic
 
 ## Overview
 
-- [types/](./types/) - Core types (numbers, strings, arrays, maps, nil/bool), common operations, patterns, and interop notes.
-- [numbers/](./numbers/) - Working with integers and floats: arithmetic, conversions, clamping, bitwise ops, and patterns.
-- [strings/](./strings/) - Working with strings: literals/escaping, concatenation, substr/find, split, and conversions.
-- [arrays/](./arrays/) - Working with arrays: creation, indexing/slicing, iteration patterns, helpers, and idioms.
-- [maps/](./maps/) - Working with maps: construction, lookup/update, merging, iteration, and common patterns.
-- [includes/](./includes/) - Using local vs. system includes, FUN_LIB_DIR, DEFAULT_LIB_DIR, and namespaced includes with `as`.
-- [opcodes/](./opcodes/) - VM opcodes overview grouped by domain with brief behavior/stack notes.
-- [internals/](./internals/) - Implementation details: bytecode format, VM architecture, stacks/frames, parser, and dispatch.
-- [vm/](./vm/) - VM configuration constants: maximum stack depth, local/global variable limits, and output buffer size.
-- [rust/](./rust/) - Writing Rust-backed opcodes and wiring them into the C VM; build/setup notes.
-- [examples/](./examples/) - How to run the examples and the interactive showcase script, with environment tips.
-- [testing/](./testing/) - How to build and run tests/targets with CMake/CTest, and where to add new tests.
-- [troubleshooting/](./troubleshooting/) - Common issues and quick fixes for build, includes, and REPL usage.
+- [./types/](./types/) - Core types (numbers, strings, arrays, maps, nil/bool), common operations, patterns, and interop notes.
+- [./numbers/](./numbers/) - Working with integers and floats: arithmetic, conversions, clamping, bitwise ops, and patterns.
+- [./strings/](./strings/) - Working with strings: literals/escaping, concatenation, substr/find, split, and conversions.
+- [./arrays/](./arrays/) - Working with arrays: creation, indexing/slicing, iteration patterns, helpers, and idioms.
+- [./maps/](./maps/) - Working with maps: construction, lookup/update, merging, iteration, and common patterns.
+- [./includes/](./includes/) - Using local vs. system includes, FUN_LIB_DIR, DEFAULT_LIB_DIR, and namespaced includes with `as`.
+- [./opcodes/](./opcodes/) - VM opcodes overview grouped by domain with brief behavior/stack notes.
+- [./internals/](./internals/) - Implementation details: bytecode format, VM architecture, stacks/frames, parser, and dispatch.
+- [./vm/](./vm/) - VM configuration constants: maximum stack depth, local/global variable limits, and output buffer size.
+- [./rust/](./rust/) - Writing Rust-backed opcodes and wiring them into the C VM; build/setup notes.
+- [./examples/](./examples/) - How to run the examples and the interactive showcase script, with environment tips.
+- [./testing/](./testing/) - How to build and run tests/targets with CMake/CTest, and where to add new tests.
+- [./troubleshooting/](./troubleshooting/) - Common issues and quick fixes for build, includes, and REPL usage.
 
 ## New and supplemental guides
 
-- [build/](./build/) - How to build Fun with CMake, available targets, and build options (FUN_DEBUG, FUN_USE_MUSL, FUN_WITH_CPP, FUN_WITH_RUST, FUN_WITH_OPENSSL).
-- [cli/](./cli/) - Command-line usage of the `fun` executable: synopsis, options, exit codes, includes and library paths.
-- [fun/](./fun/) - Full usage guide for the `fun` executable: invocation patterns, REPL, env vars, include paths, examples, and install locations.
-- [asyncio/](./asyncio/) - Async I/O primitives and patterns: non-blocking sockets, fd polling, examples, and best practices.
-- [funstx/](./funstx/) - Syntax checker for .fun files with optional --fix auto-corrections; usage, exit codes, and limitations.
-- [contributing/](./contributing/) - How to contribute: project structure, coding style, running tests, and PR guidelines.
-- [style-guide/](./style-guide/) - Coding conventions for C and Fun (indentation, naming, idioms).
-- [stdlib/](./stdlib/) - Overview of the standard library modules under ./lib with one-line summaries.
-- [embedding/](./embedding/) - Embedding the VM from C/Rust, lifecycle, and host integration tips.
-- [errors-and-diagnostics/](./errors-and-diagnostics/) - Understanding parser/runtime errors and enabling diagnostics.
-- [performance/](./performance/) - Build/runtime tuning tips and patterns for better performance.
-- [security-and-sandboxing/](./security-and-sandboxing/) - Trust boundaries, I/O expectations, and capability restrictions.
-- [faq/](./faq/) - Frequently asked questions and quick answers.
-- [website/](./website/) - Documentation for the [fun-lang.xyz](https://fun-lang.xyz) website in the `./web/` directory.
-- [writing-tests/](./writing-tests/) - How to author new tests for Fun and opcode components.
-- [bytecode-format/](./bytecode-format/) - Reference for the bytecode format (split out from internals for convenience).
-- [roadmap/](./roadmap/) - High-level direction, planned features, and pointers to issues.
+- [./build/](./build/) - How to build Fun with CMake, available targets, and build options (FUN_DEBUG, FUN_USE_MUSL, FUN_WITH_CPP, FUN_WITH_RUST, FUN_WITH_OPENSSL).
+- [./cli/](./cli/) - Command-line usage of the `fun` executable: synopsis, options, exit codes, includes and library paths.
+- [./fun/](./fun/) - Full usage guide for the `fun` executable: invocation patterns, REPL, env vars, include paths, examples, and install locations.
+- [./asyncio/](./asyncio/) - Async I/O primitives and patterns: non-blocking sockets, fd polling, examples, and best practices.
+- [./funstx/](./funstx/) - Syntax checker for .fun files with optional --fix auto-corrections; usage, exit codes, and limitations.
+- [./contributing/](./contributing/) - How to contribute: project structure, coding style, running tests, and PR guidelines.
+- [./style-guide/](./style-guide/) - Coding conventions for C and Fun (indentation, naming, idioms).
+- [./stdlib/](./stdlib/) - Overview of the standard library modules under ./lib with one-line summaries.
+- [./embedding/](./embedding/) - Embedding the VM from C/Rust, lifecycle, and host integration tips.
+- [./errors-and-diagnostics/](./errors-and-diagnostics/) - Understanding parser/runtime errors and enabling diagnostics.
+- [./performance/](./performance/) - Build/runtime tuning tips and patterns for better performance.
+- [./security-and-sandboxing/](./security-and-sandboxing/) - Trust boundaries, I/O expectations, and capability restrictions.
+- [,/faq/](./faq/) - Frequently asked questions and quick answers.
+- [./website/](./website/) - Documentation for the [fun-lang.xyz](https://fun-lang.xyz) website in the `./web/` directory.
+- [./writing-tests/](./writing-tests/) - How to author new tests for Fun and opcode components.
+- [./bytecode-format/](./bytecode-format/) - Reference for the bytecode format (split out from internals for convenience).
+- [./roadmap/](./roadmap/) - High-level direction, planned features, and pointers to issues.
 
 ## Examples
 
- - [examples/](./examples/) - Catalog of all example scripts under [https://git.xw3.org/fun/fun/src/branch/main/examples](https://git.xw3.org/fun/fun/src/branch/main/examples){:class="git"}: what each area contains, how to run them, required env vars, and extension requirements.
+ - [./examples/](./examples/) - Catalog of all example scripts under [https://git.xw3.org/fun/fun/src/branch/main/examples](https://git.xw3.org/fun/fun/src/branch/main/examples){:class="git"}: what each area contains, how to run them, required env vars, and extension requirements.
 
 ## External extensions
 
@@ -81,6 +80,6 @@ Documentation for optional, build-time selectable integrations lives in [externa
 ## Tips
 
 - When building from the repo without installing, set `FUN_LIB_DIR` to the local `./lib` directory so examples and the REPL can locate the stdlib.
-- For a broader project overview and quickstart, see the repository root [README/](../../README/).
+- For a broader project overview and quickstart, see the repository root [README/](./../README/).
 - Crypto examples:
   - If built with `-DFUN_WITH_OPENSSL=ON`, try `examples/crypto/openssl_md5.fun`.
diff --git a/web/documentation/embedding.md b/web/documentation/embedding/embedding.md
similarity index 69%
rename from web/documentation/embedding.md
rename to web/documentation/embedding/embedding.md
index 095e866..2d39d00 100644
--- a/web/documentation/embedding.md
+++ b/web/documentation/embedding/embedding.md
@@ -22,8 +22,8 @@ tags:
 This guide outlines how to embed the Fun VM in a host application and extend it from C/Rust.
 
 ## Overview
-- The VM is implemented in C (see [src/vm](../src/vm/)).
-- Optional Rust-based opcodes can be enabled via `FUN_WITH_RUST` (see [rust.md](./rust/)).
+- The VM is implemented in C (see [../internals/](../internals/)).
+- Optional Rust-based opcodes can be enabled via `FUN_WITH_RUST` (see [../rust/](../rust/)).
 
 ## Embedding from C
 While the exact API surface may evolve, a typical embedding flow looks like:
@@ -33,7 +33,7 @@ While the exact API surface may evolve, a typical embedding flow looks like:
 4. Execute entry function or script body.
 5. Retrieve results and clean up.
 
-See [src/vm/core](../src/vm/core/) and related headers for public entry points and value types.
+See [https://git.xw3.org/fun/fun/src/branch/main/src/](https://git.xw3.org/fun/fun/src/branch/main/src/){:class="git"} and related headers for public entry points and value types.
 
 ### Hosting considerations
 - Threading: share VM state cautiously or create one VM per thread.
@@ -41,8 +41,8 @@ See [src/vm/core](../src/vm/core/) and related headers for public entry points a
 - Errors: propagate parse/runtime errors back to the host with useful messages.
 
 ## Extending with Rust
-When `FUN_WITH_RUST=ON`, a Rust static library from [`src/rust/`](../src/rust/) is built and linked. You can:
+When `FUN_WITH_RUST=ON`, a Rust static library from [https://git.xw3.org/fun/fun/src/branch/main/src/rust](https://git.xw3.org/fun/fun/src/branch/main/src/rust){:class="git"} is built and linked. You can:
 - Implement new opcodes/functions in Rust.
 - Expose a C ABI for the VM to call into.
 
-See [rust.md](./rust/) for details and example code.
+See [../rust/](../rust/) for details and example code.
diff --git a/web/documentation/errors-and-diagnostics.md b/web/documentation/errors-and-diagnostics/errors-and-diagnostics.md
similarity index 96%
rename from web/documentation/errors-and-diagnostics.md
rename to web/documentation/errors-and-diagnostics/errors-and-diagnostics.md
index ea2708e..c1306d1 100644
--- a/web/documentation/errors-and-diagnostics.md
+++ b/web/documentation/errors-and-diagnostics/errors-and-diagnostics.md
@@ -27,7 +27,7 @@ This guide helps you understand common error messages and how to collect useful
 - Runtime errors: type mismatches, out-of-range access, invalid operations.
 
 ## Enabling diagnostics
-- Build with `-DFUN_DEBUG=ON` to enable additional assertions and debug messages (see [build.md](./build/)).
+- Build with `-DFUN_DEBUG=ON` to enable additional assertions and debug messages (see [build](./build/)).
 - Run with smaller, focused scripts to isolate issues.
 
 ## Getting useful reports
diff --git a/web/documentation/examples/README.md b/web/documentation/examples/README.md
deleted file mode 100644
index 0500946..0000000
--- a/web/documentation/examples/README.md
+++ /dev/null
@@ -1,246 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - Examples catalog and how to run them
-subtitle: Catalog of all example scripts under ./examples/, what each area contains, how to run them, required env vars, and extension requirements.
-description: Catalog of all example scripts under ./examples/, what each area contains, how to run them, required env vars, and extension requirements.
-permalink: /documentation/examples/
-lang: en
-tags:
-- area
-- catalog
-- contains
-- env
-- example
-- examples
-- extension
-- required
-- requirements
-- run
-- scripts
-- them
-- under
-- vars
-- what
----
-
-
-This page is a practical catalog of the example areas that ship with the Fun language. It explains what you’ll find in each folder under ./examples/, how to run the scripts, and where deeper walkthroughs live.
-
-If you’re building/running from the repository without installing, set FUN_LIB_DIR to the local ./lib directory so examples can locate the stdlib:
-
-- export FUN_LIB_DIR="./lib"
-- Then run an example: ./build_debug/fun examples/basics/hello_world.fun
-  - Or, if installed: fun examples/basics/hello_world.fun
-
-Notes
-- Most scripts are self‑documented with a short header comment at the top. Open them to see exact behavior and expected output.
-- Some examples depend on optional extensions (cURL, PCRE2, SQLite, Notcurses, Tk, PC/SC, OpenSSL/LibreSSL). See documentation/external/ for enablement and availability.
-- Networking examples often bind to 127.0.0.1 on high ports; read the file header for the exact port.
-
-Deep‑dives
-
-## Top‑level examples (./examples)
-
-Quick micro demos covering language features and tiny utilities.
-
-Run pattern:
-- fun examples/<file>.fun
-
-Highlights (selection):
-
-- [builtins_extended.fun](./builtins_extended/) — tour of core built‑ins beyond the basics
-- [byte_for_demo.fun](./byte_for_demo/) — iterating bytes with for
-- [byte_overflow_try_catch.fun](./byte_overflow_try_catch/) — error handling on overflow
-- [cast_demo.fun](./cast_demo/) — conversions and casting helpers
-- [class_constructor.fun](./class_constructor/) — basic constructor usage and init patterns
-- [class_test.fun](./class_test/) — small class feature checks
-- [classes_demo.fun](classes_demo/) — class basics and usage
-- [class_without_object.fun](./class_without_object/) — class features without an instance helper
-- [cli_argv_dump.fun](./cli_argv_dump/) — prints argv/argc handling
-- [conversions_showcase.fun](./conversions_showcase/) — numbers, strings, bytes conversions
-- [cpp_add.fun](./cpp_add/) — calling into the optional C++ extension (if enabled)
-- [datetime_basic.fun](./datetime_basic/) — minimal date/time helpers
-- [datetime_extended.fun](./datetime_extended/) — richer date/time operations
-- [datetime_timer.fun](datetime_timer/) — time/date helpers
-- [echo_example.fun](./echo_example/) — simple echo of input/args
-- [env_all.fun](./env_all/) — enumerate environment variables
-- [os_env.fun](./os_env/) — reading environment variables
-- [error_handling.fun](./error_handling/) — try/catch and error objects
-- [try_catch_finally.fun](try_catch_finally/) — error patterns
-- [expressions_test.fun](./expressions_test/) — precedence and grouping
-- [features.fun](./features/) — grab bag of language features
-- [file_print_for_file_line_by_line.fun](./file_print_for_file_line_by_line/) — iterate file content
-- [floats.fun](./floats/) — float ops and formatting
-- [for_range_test.fun](./for_range_test/) — ranges and loops
-- [functions_test.fun](./functions_test/) — functions, closures, returns
-- [have_fun.fun](./have_fun/) — playful starter demo
-- [have_fun_function.fun](have_fun_function/) — playful demos
-- [hex_example.fun](./hex_example/) — hex encode/decode
-- [if_else_test.fun](./if_else_test/) — conditional branching examples
-- [nested_loops.fun](./nested_loops/) — loops inside loops
-- [loops_break_continue.fun](loops_break_continue/) — control flow
-- [include_local.fun](./include_local/) — include a local file/module
-- [include_lib.fun](./include_lib/) — include from the stdlib path
-- [include_local_util.fun](include_local_util/) — include mechanics
-- [inheritance_demo.fun](./inheritance_demo/) — simple class inheritance
-- [maps.fun](./maps/), [match.fun](match/) — data structures and pattern matching
-- [namespaced_mod.fun](./namespaced_mod/) — namespaced includes with as
-- [objects_basic.fun](./objects_basic/) — simple objects and methods
-- [objects_more.fun](./objects_more/) — OO basics
-- [process_example.fun](./process_example/) — spawn and capture subprocess output
-- [progress.fun](./progress/) — progress bar helper
-- [progress_inline.fun](./progress_inline/) — simple progress displays
-- [random_demo.fun](./random_demo/) — random helpers overview
-- [random_number_example.fun](random_number_example/) — RNG usage
-- [regex_demo.fun](./regex_demo/) — regex basics (PCRE2 when enabled)
-- [regex_procedural.fun](./regex_procedural/) — regex helpers (PCRE2 when enabled)
-- [rust_hello.fun](./rust_hello/), rust_hello_args*.fun — Rust opcodes (if FUN_WITH_RUST)
-- [serial_demo.fun](./serial_demo/) — serial port usage
-- [test_serial.fun](./test_serial/) — serial port (when available)
-- [short_circuit_test.fun](./short_circuit_test/) — boolean evaluation order
-- [signed_ints.fun](./signed_ints/) — signed integers overview
-- [uint_types.fun](./uint_types/) — unsigned integers overview
-- [types_integers.fun](./types_integers/) — integer families
-- [stdlib_showcase.fun](./stdlib_showcase/) — sampler of common stdlib modules
-- [strings_test.fun](./strings_test/) — string helpers and edge cases
-- [tcp_http_get.fun](./tcp_http_get/) — simple HTTP GET over raw TCP
-- [tcp_http_get_class.fun](./tcp_http_get_class/) — manual HTTP client over sockets
-- [test_bits.fun](./test_bits/) — /rol/shl/xor/dec_to_hex/hex_to_dec bitwise utilities
-- [thread_class_example.fun](./thread_class_example/) — define and run a thread class
-- [threads_demo.fun](./threads_demo/) — threading building blocks
-- [typeof.fun](./typeof/) — type inspection
-- [typeof_features.fun](./typeof_features/) — type inspection of declared integer subtypes and runtime categories
-- [type_safety.fun](./type_safety/) — static/dynamic type checks
-- [type_safety_fails.fun](./type_safety_fails/) — static/dynamic type checks
-- [types_overview.fun](./types_overview/) — language types tour
-- [unix_socket_echo.fun](./unix_socket_echo/) — local domain socket echo demo
-- [version.fun](./version/) — print VM/version info
-- [while_test.fun](./while_test/) — simple while loop example
-
-Tip: If a file name is listed above but not present on your build, it may depend on an extension you did not enable.
-
-
-## Algorithms (./examples/algos)
-- deduplicate.fun — removing duplicates from arrays/maps
-- sort_and_search.fun — sorting and lookup patterns
-- stack_queue.fun — basic stack and queue implementation
-
-## Arrays (./examples/arrays)
-- arrays.fun — create, index, slice; typical idioms
-- arrays_iter.fun — iteration and enumeration
-- arrays_advanced.fun — copying, filtering, transformations
-
-## Basics (./examples/basics)
-- boolean_decl.fun, booleans.fun — boolean values and operators
-- builtins_conversions.fun — core built‑ins, type conversions
-- collections.fun — arrays, maps, nested structures
-- fibonacci.fun, fizzbuzz.fun — classic exercises
-- hello_world.fun — the canonical first program
-
-## CLI (./examples/cli)
-- args_parse.fun — arguments parsing patterns for small CLIs
-
-## Compose (./examples/compose)
-Compositional patterns, small abstractions to combine behavior.
-
-## Crypto (./examples/crypto)
-Hashing and cryptographic helpers. Availability depends on whether OpenSSL/LibreSSL is enabled.
-- openssl_md5.fun — MD5 via OpenSSL (if -DFUN_WITH_OPENSSL)
-- libressl_md5.fun — MD5 via LibreSSL (if -DFUN_WITH_LIBRESSL)
-- aes256.fun and hash samples if present on your build
-
-## Data (./examples/data)
-Static assets for example servers; not meant to be run directly.
-- htdocumentation/ — files used by HTTP server examples (index.html, hello.fun, info.fun, form_post.fun, counter.fun, redirect.fun, json_like_api.fun)
-
-## Error handling and diagnostics (./examples/error)
-- debug_reporting.fun — enabling debug output and reading traces
-- exit_example.fun — exit codes
-- fail.fun — triggering and observing failures
-- repl_on_error.fun — dropping into REPL on error
-- rust_vm_access.fun — Rust opcode errors (if enabled)
-- test_indent.fun — parser/indentation corner cases
-- try_catch_with_error.fun — capturing error objects
-
-## Extra integrations (./examples/extra)
-These require optional external libraries. See documentation/external/.
-- curl_* — cURL HTTP client examples (download, GET JSON, POST)
-- ini_* — parsing INI files (simple to complex)
-- json_showcase.fun — JSON helpers
-- libsql_example.fun — libSQL client usage
-- notcurses_* — rich TUI demos (if Notcurses enabled)
-- pcre2_* — PCRE2 regex engine demos
-- pcsc*.fun — smart card access via PC/SC
-- sqlite_example.fun — SQLite usage
-- tcp_echo_server*.fun — basic TCP echo server
-- tk_* — Tcl/Tk GUI examples
-- xml_* — XML parsing with libxml2
-
-## Interactive (./examples/interactive)
-- console_prompt.fun — simple prompt loop
-- input_example.fun — reading user input
-- input_hidden_example.fun, input_hidden_pam_auth.fun — hidden input/passwords
-
-## IO (./examples/io)
-- async_http_client.fun — non‑blocking HTTP client
-- await_http_client.fun — non‑blocking HTTP client using lib/async/scheduler.fun (await-style helpers)
-- csv_reader.fun — parse CSV files
-- file_io.fun, read_write_file.fun — file operations
-- word_count.fun — classic WC example
-
-## Math (./examples/math)
-Small, focused math helpers and demonstrations:
-- math_ceil, math_floor, math_round, math_trunc, math_sign
-- math_cos, math_sin, math_tan
-- math_sqrt, math_isqrt
-- math_exp_log
-- math_fmin_fmax
-- math_gcd_lcm
-
-## Networking (./examples/net)
-Servers and socket utilities. See documentation/examples/net/httpserver.md for the HTTP family.
-- HTTP servers: [httpserver.md](./net/httpserver/) — end‑to‑end walkthrough of all HTTP server variants in examples/net/
-- http_static_server.fun — minimal static server over sockets
-- http_server.fun — blocking static/CGI dispatcher using lib/net/http_server.fun
-- http_server_cgi.fun — blocking server with CGI via lib/net/http_cgi_server.fun
-- http_server_cgi_lib.fun — blocking server leveraging net/cgi.fun helpers
-- http_mt_server.fun — thread‑per‑connection static server
-- http_mt_server_cgi.fun — thread‑per‑connection with CGI support
-
-## Patterns (./examples/patterns)
-Small idioms and reusable patterns.
-- assert_like.fun — assert‑style checks via language constructs
-
-## Snippets (./examples/snippets)
-Miscellaneous one‑off code snippets demonstrating particular opcodes or tricks.
-
-## SQLite daemon (./examples/sqlited)
-- Files related to running a small SQLite‑backed service (see source for details)
-
-## Strings (./examples/strings)
-- base64_demo.fun — base64 encode/decode using encoding/base64
-- split_join_trim.fun — string splitting and trimming
-- templating_min.fun — bare‑bones templating
-- urlencode_decode.fun — percent‑encoding helpers
-
-## Broken (./examples/broken)
-Historical or intentionally broken examples kept for reference/regression.
-- notcurses_* — experiments around Notcurses
-- ripemd160* — legacy or experimental hash routines
-
-### Running examples reliably
-
-Prefer the local build when running from the repository root:
-- ./build_debug/fun <path/to/example.fun>
-- or: ./build_release/fun <path/to/example.fun>
-
-Set up env if needed:
-- export FUN_LIB_DIR="./lib" # to find stdlib
-- export FUN_EXEC="./build_debug/fun" # used by CGI examples
-- export FUN_HTDOCS="./examples/data/htdocs" # override docroot
-
-When optional extensions are not enabled, their examples will not run; reconfigure the build with the required -D flags shown in documentation/external/.
diff --git a/web/documentation/examples/builtins_extended.md b/web/documentation/examples/builtins_extended.md
deleted file mode 100644
index 36982ac..0000000
--- a/web/documentation/examples/builtins_extended.md
+++ /dev/null
@@ -1,28 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - builtins_extended.fun — overview
-subtitle: Documentation for builtins_extended.fun — overview
-description: Documentation for builtins_extended.fun — overview
-permalink: /documentation/examples/builtins_extended/
-lang: en
-tags:
-- builtins_extended
-- example
----
-
-
-What it shows
-- A tour of core built‑ins beyond the basics: printing, typing, math helpers, conversions, and utility functions commonly used in small scripts.
-
-How to run
-- From repo root with local build:
-  - export FUN_LIB_DIR="./lib"
-  - ./build_debug/fun examples/builtins_extended.fun
-- Or, if installed: fun examples/builtins_extended.fun
-
-Notes
-- Exact behavior and outputs are documented inline at the top of the script; open the .fun file for details.
diff --git a/web/documentation/examples/builtins_maps_and_more.md b/web/documentation/examples/builtins_maps_and_more.md
deleted file mode 100644
index daa1c72..0000000
--- a/web/documentation/examples/builtins_maps_and_more.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - builtins_maps_and_more.fun — overview
-subtitle: Documentation for builtins_maps_and_more.fun — overview
-description: Documentation for builtins_maps_and_more.fun — overview
-permalink: /documentation/examples/builtins_maps_and_more/
-lang: en
-tags:
-- builtins_maps_and_more
-- example
----
-
-
-What it shows
-- Exploring built‑ins while working with maps and related data structures.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/builtins_maps_and_more.fun
-- Or: fun examples/builtins_maps_and_more.fun
-
-Notes
-- Open the .fun file to see the exact behaviors and printed output.
diff --git a/web/documentation/examples/byte_for_demo.md b/web/documentation/examples/byte_for_demo.md
deleted file mode 100644
index 455ba48..0000000
--- a/web/documentation/examples/byte_for_demo.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - byte_for_demo.fun — overview
-subtitle: Documentation for byte_for_demo.fun — overview
-description: Documentation for byte_for_demo.fun — overview
-permalink: /documentation/examples/byte_for_demo/
-lang: en
-tags:
-- byte_for_demo
-- example
----
-
-
-What it shows
-- Iterating bytes with a for-loop; indexing and printing byte values.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/byte_for_demo.fun
-- Or: fun examples/byte_for_demo.fun
diff --git a/web/documentation/examples/byte_overflow_try_catch.md b/web/documentation/examples/byte_overflow_try_catch.md
deleted file mode 100644
index 6b72711..0000000
--- a/web/documentation/examples/byte_overflow_try_catch.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - byte_overflow_try_catch.fun — overview
-subtitle: Documentation for byte_overflow_try_catch.fun — overview
-description: Documentation for byte_overflow_try_catch.fun — overview
-permalink: /documentation/examples/byte_overflow_try_catch/
-lang: en
-tags:
-- byte_overflow_try_catch
-- example
----
-
-
-What it shows
-- Error handling around byte/integer overflow using try/catch.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/byte_overflow_try_catch.fun
-- Or: fun examples/byte_overflow_try_catch.fun
diff --git a/web/documentation/examples/cast_demo.md b/web/documentation/examples/cast_demo.md
deleted file mode 100644
index 9583624..0000000
--- a/web/documentation/examples/cast_demo.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - cast_demo.fun — overview
-subtitle: Documentation for cast_demo.fun — overview
-description: Documentation for cast_demo.fun — overview
-permalink: /documentation/examples/cast_demo/
-lang: en
-tags:
-- cast_demo
-- example
----
-
-
-What it shows
-- Conversions and casting helpers; demonstrates changing between numeric and string types safely.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/cast_demo.fun
-- Or: fun examples/cast_demo.fun
diff --git a/web/documentation/examples/class_constructor.md b/web/documentation/examples/class_constructor.md
deleted file mode 100644
index c6e4e9f..0000000
--- a/web/documentation/examples/class_constructor.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - class_constructor.fun — overview
-subtitle: Documentation for class_constructor.fun — overview
-description: Documentation for class_constructor.fun — overview
-permalink: /documentation/examples/class_constructor/
-lang: en
-tags:
-- class_constructor
-- example
----
-
-
-What it shows
-- Class basics and constructor behavior; initializing fields and using methods.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/class_constructor.fun
-- Or: fun examples/class_constructor.fun
diff --git a/web/documentation/examples/class_test.md b/web/documentation/examples/class_test.md
deleted file mode 100644
index 1b01d26..0000000
--- a/web/documentation/examples/class_test.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - class_test.fun — overview
-subtitle: Documentation for class_test.fun — overview
-description: Documentation for class_test.fun — overview
-permalink: /documentation/examples/class_test/
-lang: en
-tags:
-- class_test
-- example
----
-
-
-What it shows
-- Simple class usage and method invocation; small sanity checks around classes.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/class_test.fun
-- Or: fun examples/class_test.fun
-
-Notes
-- Open the script to see the exact behavior and outputs.
diff --git a/web/documentation/examples/class_without_object.md b/web/documentation/examples/class_without_object.md
deleted file mode 100644
index 1ffffbc..0000000
--- a/web/documentation/examples/class_without_object.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - class_without_object.fun — overview
-subtitle: Documentation for class_without_object.fun — overview
-description: Documentation for class_without_object.fun — overview
-permalink: /documentation/examples/class_without_object/
-lang: en
-tags:
-- class_without_object
-- example
----
-
-
-What it shows
-- Class features that can be used without creating an instance (static-like usage patterns).
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/class_without_object.fun
-- Or: fun examples/class_without_object.fun
diff --git a/web/documentation/examples/classes_demo.md b/web/documentation/examples/classes_demo.md
deleted file mode 100644
index 5e8ec05..0000000
--- a/web/documentation/examples/classes_demo.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - classes_demo.fun — overview
-subtitle: Documentation for classes_demo.fun — overview
-description: Documentation for classes_demo.fun — overview
-permalink: /documentation/examples/classes_demo/
-lang: en
-tags:
-- classes_demo
-- example
----
-
-
-What it shows
-- Class basics and usage: defining classes, instantiating objects, calling methods.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/classes_demo.fun
-- Or: fun examples/classes_demo.fun
diff --git a/web/documentation/examples/cli_argv_dump.md b/web/documentation/examples/cli_argv_dump.md
deleted file mode 100644
index 1fb48f4..0000000
--- a/web/documentation/examples/cli_argv_dump.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - cli_argv_dump.fun — overview
-subtitle: Documentation for cli_argv_dump.fun — overview
-description: Documentation for cli_argv_dump.fun — overview
-permalink: /documentation/examples/cli_argv_dump/
-lang: en
-tags:
-- cli_argv_dump
-- example
----
-
-
-What it shows
-- Prints argv/argc handling to demonstrate CLI arguments parsing at a low level.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/cli_argv_dump.fun --foo bar 123
-- Or: fun examples/cli_argv_dump.fun --foo bar 123
diff --git a/web/documentation/examples/conversions_showcase.md b/web/documentation/examples/conversions_showcase.md
deleted file mode 100644
index 435741a..0000000
--- a/web/documentation/examples/conversions_showcase.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - conversions_showcase.fun — overview
-subtitle: Documentation for conversions_showcase.fun — overview
-description: Documentation for conversions_showcase.fun — overview
-permalink: /documentation/examples/conversions_showcase/
-lang: en
-tags:
-- conversions_showcase
-- example
----
-
-
-What it shows
-- Numbers, strings, and bytes conversions; typical idioms and edge cases.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/conversions_showcase.fun
-- Or: fun examples/conversions_showcase.fun
diff --git a/web/documentation/examples/cpp_add.md b/web/documentation/examples/cpp_add.md
deleted file mode 100644
index e05f641..0000000
--- a/web/documentation/examples/cpp_add.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - cpp_add.fun — overview
-subtitle: Documentation for cpp_add.fun — overview
-description: Documentation for cpp_add.fun — overview
-permalink: /documentation/examples/cpp_add/
-lang: en
-tags:
-- cpp_add
-- example
----
-
-
-What it shows
-- Calling into the optional C++ extension from Fun.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/cpp_add.fun
-- Or: fun examples/cpp_add.fun
-
-Notes
-- Requires the optional C++ extension to be enabled in your build; otherwise this example may be unavailable.
diff --git a/web/documentation/examples/data/htdocs/counter.md b/web/documentation/examples/data/htdocs/counter.md
deleted file mode 100644
index 3b460a0..0000000
--- a/web/documentation/examples/data/htdocs/counter.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - counter.fun (CGI)
-subtitle: Documentation for counter.fun (CGI)
-description: Documentation for counter.fun (CGI)
-permalink: /documentation/examples/data/htdocumentation/counter/
-lang: en
-tags:
-- cgi
-- counter
-- example
----
-
-
-- Location: examples/data/htdocumentation/counter.fun
-- Category: CGI script used by HTTP server examples
-
-Description
-- Simple stateful counter example for CGI; demonstrates reading and updating a value across requests (implementation details in script).
-
-How to run
-- Through one of the HTTP server examples, e.g.:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Open: http://127.0.0.1:8080/counter.fun
-
-See also
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/data/htdocs/form_post.md b/web/documentation/examples/data/htdocs/form_post.md
deleted file mode 100644
index 7efe6c2..0000000
--- a/web/documentation/examples/data/htdocs/form_post.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - form_post.fun (CGI)
-subtitle: Documentation for form_post.fun (CGI)
-description: Documentation for form_post.fun (CGI)
-permalink: /documentation/examples/data/htdocumentation/form_post/
-lang: en
-tags:
-- cgi
-- example
-- form_post
----
-
-
-- Location: examples/data/htdocumentation/form_post.fun
-- Category: CGI script used by HTTP server examples
-
-Description
-- Demonstrates handling of POST form data via the CGI interface.
-
-How to run
-- Through one of the HTTP server examples, e.g.:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Submit a form to: http://127.0.0.1:8080/form_post.fun
-
-See also
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/data/htdocs/hello.md b/web/documentation/examples/data/htdocs/hello.md
deleted file mode 100644
index dee58fb..0000000
--- a/web/documentation/examples/data/htdocs/hello.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - hello.fun (CGI)
-subtitle: Documentation for hello.fun (CGI)
-description: Documentation for hello.fun (CGI)
-permalink: /documentation/examples/data/htdocumentation/hello/
-lang: en
-tags:
-- cgi
-- example
-- hello
----
-
-
-- Location: examples/data/htdocumentation/hello.fun
-- Category: CGI script used by HTTP server examples
-
-Description
-- Simple CGI .fun script that prints a greeting, optionally using query parameters (e.g., ?name=Fun).
-
-How to run
-- Through one of the HTTP server examples, e.g.:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Open: http://127.0.0.1:8080/hello.fun?name=Fun
-
-See also
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/data/htdocs/info.md b/web/documentation/examples/data/htdocs/info.md
deleted file mode 100644
index 0529342..0000000
--- a/web/documentation/examples/data/htdocs/info.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - info.fun (CGI)
-subtitle: Documentation for info.fun (CGI)
-description: Documentation for info.fun (CGI)
-permalink: /documentation/examples/data/htdocumentation/info/
-lang: en
-tags:
-- cgi
-- example
-- info
----
-
-
-- Location: examples/data/htdocumentation/info.fun
-- Category: CGI script used by HTTP server examples
-
-Description
-- CGI script that prints request/environment information, useful for debugging CGI variables.
-
-How to run
-- Through one of the HTTP server examples, e.g.:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Open: http://127.0.0.1:8080/info.fun
-
-See also
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/data/htdocs/json_like_api.md b/web/documentation/examples/data/htdocs/json_like_api.md
deleted file mode 100644
index 601766c..0000000
--- a/web/documentation/examples/data/htdocs/json_like_api.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - json_like_api.fun (CGI)
-subtitle: Documentation for json_like_api.fun (CGI)
-description: Documentation for json_like_api.fun (CGI)
-permalink: /documentation/examples/data/htdocumentation/json_like_api/
-lang: en
-tags:
-- cgi
-- example
-- json_like_api
----
-
-
-- Location: examples/data/htdocumentation/json_like_api.fun
-- Category: CGI script used by HTTP server examples
-
-Description
-- Demonstrates returning JSON-like output from a CGI endpoint.
-
-How to run
-- Through one of the HTTP server examples, e.g.:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Open: http://127.0.0.1:8080/json_like_api.fun
-
-See also
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/data/htdocs/redirect.md b/web/documentation/examples/data/htdocs/redirect.md
deleted file mode 100644
index 5390697..0000000
--- a/web/documentation/examples/data/htdocs/redirect.md
+++ /dev/null
@@ -1,33 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - redirect.fun (CGI)
-subtitle: Documentation for redirect.fun (CGI)
-description: Documentation for redirect.fun (CGI)
-permalink: /documentation/examples/data/htdocumentation/redirect/
-lang: en
-tags:
-- cgi
-- example
-- redirect
----
-
-
-- Location: examples/data/htdocumentation/redirect.fun
-- Category: CGI script used by HTTP server examples
-
-Description
-- Demonstrates issuing HTTP redirects from a CGI script (setting Status and Location headers).
-
-How to run
-- Through one of the HTTP server examples, e.g.:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Open: http://127.0.0.1:8080/redirect.fun
-
-See also
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/datetime_basic.md b/web/documentation/examples/datetime_basic.md
deleted file mode 100644
index 0c49979..0000000
--- a/web/documentation/examples/datetime_basic.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - datetime_basic.fun — overview
-subtitle: Documentation for datetime_basic.fun — overview
-description: Documentation for datetime_basic.fun — overview
-permalink: /documentation/examples/datetime_basic/
-lang: en
-tags:
-- datetime_basic
-- example
----
-
-
-What it shows
-- Basic time/date helpers and formatting.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/datetime_basic.fun
-- Or: fun examples/datetime_basic.fun
diff --git a/web/documentation/examples/datetime_extended.md b/web/documentation/examples/datetime_extended.md
deleted file mode 100644
index 7b38a0b..0000000
--- a/web/documentation/examples/datetime_extended.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - datetime_extended.fun — overview
-subtitle: Documentation for datetime_extended.fun — overview
-description: Documentation for datetime_extended.fun — overview
-permalink: /documentation/examples/datetime_extended/
-lang: en
-tags:
-- datetime_extended
-- example
----
-
-
-What it shows
-- Extended datetime helpers: parsing, arithmetic, timers, and formatting variants.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/datetime_extended.fun
-- Or: fun examples/datetime_extended.fun
diff --git a/web/documentation/examples/datetime_timer.md b/web/documentation/examples/datetime_timer.md
deleted file mode 100644
index d104724..0000000
--- a/web/documentation/examples/datetime_timer.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - datetime_timer.fun — overview
-subtitle: Documentation for datetime_timer.fun — overview
-description: Documentation for datetime_timer.fun — overview
-permalink: /documentation/examples/datetime_timer/
-lang: en
-tags:
-- datetime_timer
-- example
----
-
-
-What it shows
-- Measuring elapsed time and simple timers using datetime helpers.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/datetime_timer.fun
-- Or: fun examples/datetime_timer.fun
diff --git a/web/documentation/examples/echo_example.md b/web/documentation/examples/echo_example.md
deleted file mode 100644
index 5a23c7b..0000000
--- a/web/documentation/examples/echo_example.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - echo_example.fun — overview
-subtitle: Documentation for echo_example.fun — overview
-description: Documentation for echo_example.fun — overview
-permalink: /documentation/examples/echo_example/
-lang: en
-tags:
-- echo_example
-- example
----
-
-
-What it shows
-- Simple echo of input/args; prints back what you type or pass as arguments.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/echo_example.fun hello world
-- Or: fun examples/echo_example.fun hello world
diff --git a/web/documentation/examples/env_all.md b/web/documentation/examples/env_all.md
deleted file mode 100644
index c62a3f3..0000000
--- a/web/documentation/examples/env_all.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - env_all.fun — overview
-subtitle: Documentation for env_all.fun — overview
-description: Documentation for env_all.fun — overview
-permalink: /documentation/examples/env_all/
-lang: en
-tags:
-- env_all
-- example
----
-
-
-What it shows
-- Reading and listing environment variables.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/env_all.fun
-- Or: fun examples/env_all.fun
diff --git a/web/documentation/examples/error_handling.md b/web/documentation/examples/error_handling.md
deleted file mode 100644
index f96d482..0000000
--- a/web/documentation/examples/error_handling.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - error_handling.fun — overview
-subtitle: Documentation for error_handling.fun — overview
-description: Documentation for error_handling.fun — overview
-permalink: /documentation/examples/error_handling/
-lang: en
-tags:
-- error_handling
-- example
----
-
-
-What it shows
-- Error patterns and handling strategies using try/catch/finally.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/error_handling.fun
-- Or: fun examples/error_handling.fun
diff --git a/web/documentation/examples.md b/web/documentation/examples/examples.md
similarity index 95%
rename from web/documentation/examples.md
rename to web/documentation/examples/examples.md
index e689517..41f4a44 100644
--- a/web/documentation/examples.md
+++ b/web/documentation/examples/examples.md
@@ -28,7 +28,7 @@ All commands assume you are in the repository root.
 
 ## Prerequisites
 
-- Build the interpreter (see handbook.md). You’ll have `build/fun` (paths may vary by your setup/IDE).
+- Build the interpreter (see handbook/). You’ll have `build/fun` (paths may vary by your setup/IDE).
 - Set FUN_LIB_DIR to the repo’s lib directory when running without installation so `#include <...>` can find the standard library.
 
 Example (Linux/macOS/BSD):
diff --git a/web/documentation/examples/expressions_test.md b/web/documentation/examples/expressions_test.md
deleted file mode 100644
index 340e105..0000000
--- a/web/documentation/examples/expressions_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - expressions_test.fun — overview
-subtitle: Documentation for expressions_test.fun — overview
-description: Documentation for expressions_test.fun — overview
-permalink: /documentation/examples/expressions_test/
-lang: en
-tags:
-- example
-- expressions_test
----
-
-
-What it shows
-- Operator precedence and expression grouping tests/demonstrations.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/expressions_test.fun
-- Or: fun examples/expressions_test.fun
diff --git a/web/documentation/examples/features.md b/web/documentation/examples/features.md
deleted file mode 100644
index a126b93..0000000
--- a/web/documentation/examples/features.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - features.fun — overview
-subtitle: Documentation for features.fun — overview
-description: Documentation for features.fun — overview
-permalink: /documentation/examples/features/
-lang: en
-tags:
-- example
-- features
----
-
-
-What it shows
-- Grab bag of language features in a single script.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/features.fun
-- Or: fun examples/features.fun
diff --git a/web/documentation/examples/file_print_for_file_line_by_line.md b/web/documentation/examples/file_print_for_file_line_by_line.md
deleted file mode 100644
index bf9ab00..0000000
--- a/web/documentation/examples/file_print_for_file_line_by_line.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - file_print_for_file_line_by_line.fun — overview
-subtitle: Documentation for file_print_for_file_line_by_line.fun — overview
-description: Documentation for file_print_for_file_line_by_line.fun — overview
-permalink: /documentation/examples/file_print_for_file_line_by_line/
-lang: en
-tags:
-- example
-- file_print_for_file_line_by_line
----
-
-
-What it shows
-- Iterate a file line-by-line and print each line; basic file IO idioms.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/file_print_for_file_line_by_line.fun path/to/file.txt
-- Or: fun examples/file_print_for_file_line_by_line.fun path/to/file.txt
diff --git a/web/documentation/examples/floats.md b/web/documentation/examples/floats.md
deleted file mode 100644
index 50c1449..0000000
--- a/web/documentation/examples/floats.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - floats.fun — overview
-subtitle: Documentation for floats.fun — overview
-description: Documentation for floats.fun — overview
-permalink: /documentation/examples/floats/
-lang: en
-tags:
-- example
-- floats
----
-
-
-What it shows
-- Floating point operations and formatting details.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/floats.fun
-- Or: fun examples/floats.fun
diff --git a/web/documentation/examples/for_range_test.md b/web/documentation/examples/for_range_test.md
deleted file mode 100644
index 34a9429..0000000
--- a/web/documentation/examples/for_range_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - for_range_test.fun — overview
-subtitle: Documentation for for_range_test.fun — overview
-description: Documentation for for_range_test.fun — overview
-permalink: /documentation/examples/for_range_test/
-lang: en
-tags:
-- example
-- for_range_test
----
-
-
-What it shows
-- Ranges and loops; iterating numeric ranges and verifying bounds.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/for_range_test.fun
-- Or: fun examples/for_range_test.fun
diff --git a/web/documentation/examples/functions_test.md b/web/documentation/examples/functions_test.md
deleted file mode 100644
index 4b39c7f..0000000
--- a/web/documentation/examples/functions_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - functions_test.fun — overview
-subtitle: Documentation for functions_test.fun — overview
-description: Documentation for functions_test.fun — overview
-permalink: /documentation/examples/functions_test/
-lang: en
-tags:
-- example
-- functions_test
----
-
-
-What it shows
-- Functions, closures, and return behavior; call semantics basics.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/functions_test.fun
-- Or: fun examples/functions_test.fun
diff --git a/web/documentation/examples/have_fun.md b/web/documentation/examples/have_fun.md
deleted file mode 100644
index 0026131..0000000
--- a/web/documentation/examples/have_fun.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - have_fun.fun — overview
-subtitle: Documentation for have_fun.fun — overview
-description: Documentation for have_fun.fun — overview
-permalink: /documentation/examples/have_fun/
-lang: en
-tags:
-- example
-- have_fun
----
-
-
-What it shows
-- Playful demo showing off small language tricks.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/have_fun.fun
-- Or: fun examples/have_fun.fun
diff --git a/web/documentation/examples/have_fun_function.md b/web/documentation/examples/have_fun_function.md
deleted file mode 100644
index 5f65a98..0000000
--- a/web/documentation/examples/have_fun_function.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - have_fun_function.fun — overview
-subtitle: Documentation for have_fun_function.fun — overview
-description: Documentation for have_fun_function.fun — overview
-permalink: /documentation/examples/have_fun_function/
-lang: en
-tags:
-- example
-- have_fun_function
----
-
-
-What it shows
-- A playful function-centric demo; small utility behaviors.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/have_fun_function.fun
-- Or: fun examples/have_fun_function.fun
diff --git a/web/documentation/examples/hex_example.md b/web/documentation/examples/hex_example.md
deleted file mode 100644
index d2e380a..0000000
--- a/web/documentation/examples/hex_example.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - hex_example.fun — overview
-subtitle: Documentation for hex_example.fun — overview
-description: Documentation for hex_example.fun — overview
-permalink: /documentation/examples/hex_example/
-lang: en
-tags:
-- example
-- hex_example
----
-
-
-What it shows
-- Hex encode/decode helpers; working with hexadecimal representations.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/hex_example.fun
-- Or: fun examples/hex_example.fun
diff --git a/web/documentation/examples/if_else_test.md b/web/documentation/examples/if_else_test.md
deleted file mode 100644
index 5316e3c..0000000
--- a/web/documentation/examples/if_else_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - if_else_test.fun — overview
-subtitle: Documentation for if_else_test.fun — overview
-description: Documentation for if_else_test.fun — overview
-permalink: /documentation/examples/if_else_test/
-lang: en
-tags:
-- example
-- if_else_test
----
-
-
-What it shows
-- Control flow with if/else; branching and comparisons.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/if_else_test.fun
-- Or: fun examples/if_else_test.fun
diff --git a/web/documentation/examples/include_lib.md b/web/documentation/examples/include_lib.md
deleted file mode 100644
index b76f031..0000000
--- a/web/documentation/examples/include_lib.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - include_lib.fun — overview
-subtitle: Documentation for include_lib.fun — overview
-description: Documentation for include_lib.fun — overview
-permalink: /documentation/examples/include_lib/
-lang: en
-tags:
-- example
-- include_lib
----
-
-
-What it shows
-- Including modules from the standard library path using #include <...>.
-
-How to run
-- export FUN_LIB_DIR="./lib"  # ensure stdlib is discoverable
-- ./build_debug/fun examples/include_lib.fun
-- Or: fun examples/include_lib.fun
diff --git a/web/documentation/examples/include_local.md b/web/documentation/examples/include_local.md
deleted file mode 100644
index 413e0da..0000000
--- a/web/documentation/examples/include_local.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - include_local.fun — overview
-subtitle: Documentation for include_local.fun — overview
-description: Documentation for include_local.fun — overview
-permalink: /documentation/examples/include_local/
-lang: en
-tags:
-- example
-- include_local
----
-
-
-What it shows
-- Including local files relative to the script and reusing helpers.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/include_local.fun
-- Or: fun examples/include_local.fun
diff --git a/web/documentation/examples/include_local_util.md b/web/documentation/examples/include_local_util.md
deleted file mode 100644
index b359340..0000000
--- a/web/documentation/examples/include_local_util.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - include_local_util.fun — overview
-subtitle: Documentation for include_local_util.fun — overview
-description: Documentation for include_local_util.fun — overview
-permalink: /documentation/examples/include_local_util/
-lang: en
-tags:
-- example
-- include_local_util
----
-
-
-What it shows
-- Local include mechanics with a small utility module.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/include_local_util.fun
-- Or: fun examples/include_local_util.fun
diff --git a/web/documentation/examples/inheritance_demo.md b/web/documentation/examples/inheritance_demo.md
deleted file mode 100644
index 3304bda..0000000
--- a/web/documentation/examples/inheritance_demo.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - inheritance_demo.fun — overview
-subtitle: Documentation for inheritance_demo.fun — overview
-description: Documentation for inheritance_demo.fun — overview
-permalink: /documentation/examples/inheritance_demo/
-lang: en
-tags:
-- example
-- inheritance_demo
----
-
-
-What it shows
-- Simple class inheritance and method overriding examples.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/inheritance_demo.fun
-- Or: fun examples/inheritance_demo.fun
diff --git a/web/documentation/examples/loops_break_continue.md b/web/documentation/examples/loops_break_continue.md
deleted file mode 100644
index 5fb5017..0000000
--- a/web/documentation/examples/loops_break_continue.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - loops_break_continue.fun — overview
-subtitle: Documentation for loops_break_continue.fun — overview
-description: Documentation for loops_break_continue.fun — overview
-permalink: /documentation/examples/loops_break_continue/
-lang: en
-tags:
-- example
-- loops_break_continue
----
-
-
-What it shows
-- Loop control: break and continue; demonstrating control flow within loops.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/loops_break_continue.fun
-- Or: fun examples/loops_break_continue.fun
diff --git a/web/documentation/examples/maps.md b/web/documentation/examples/maps.md
deleted file mode 100644
index e49b60d..0000000
--- a/web/documentation/examples/maps.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - maps.fun — overview
-subtitle: Working with maps, construction, lookup/update, merging, iteration, and common patterns.
-description: Working with maps, construction, lookup/update, merging, iteration, and common patterns.
-permalink: /documentation/examples/maps/
-lang: en
-tags:
-- common
-- construction
-- example
-- iteration
-- lookup
-- maps
-- merging
-- patterns
-- update
----
-
-
-What it shows
-- Working with maps: creation, indexing, iteration, and typical idioms.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/maps.fun
-- Or: fun examples/maps.fun
diff --git a/web/documentation/examples/match.md b/web/documentation/examples/match.md
deleted file mode 100644
index fc186a5..0000000
--- a/web/documentation/examples/match.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - match.fun — overview
-subtitle: Documentation for match.fun — overview
-description: Documentation for match.fun — overview
-permalink: /documentation/examples/match/
-lang: en
-tags:
-- example
-- match
----
-
-
-What it shows
-- Pattern matching constructs and examples of branching by value/shape.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/match.fun
-- Or: fun examples/match.fun
diff --git a/web/documentation/examples/namespaced_mod.md b/web/documentation/examples/namespaced_mod.md
deleted file mode 100644
index 33c447c..0000000
--- a/web/documentation/examples/namespaced_mod.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - namespaced_mod.fun — overview
-subtitle: Documentation for namespaced_mod.fun — overview
-description: Documentation for namespaced_mod.fun — overview
-permalink: /documentation/examples/namespaced_mod/
-lang: en
-tags:
-- example
-- namespaced_mod
----
-
-
-What it shows
-- Namespaced includes and using the "as" aliasing pattern for modules.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/namespaced_mod.fun
-- Or: fun examples/namespaced_mod.fun
diff --git a/web/documentation/examples/nested_loops.md b/web/documentation/examples/nested_loops.md
deleted file mode 100644
index c8c2314..0000000
--- a/web/documentation/examples/nested_loops.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - nested_loops.fun — overview
-subtitle: Documentation for nested_loops.fun — overview
-description: Documentation for nested_loops.fun — overview
-permalink: /documentation/examples/nested_loops/
-lang: en
-tags:
-- example
-- nested_loops
----
-
-
-What it shows
-- Control flow with nested loops; inner/outer loop coordination.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/nested_loops.fun
-- Or: fun examples/nested_loops.fun
diff --git a/web/documentation/examples/net/http_mt_server.md b/web/documentation/examples/net/http_mt_server.md
deleted file mode 100644
index a2537d2..0000000
--- a/web/documentation/examples/net/http_mt_server.md
+++ /dev/null
@@ -1,36 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - http_mt_server.fun
-subtitle: Documentation for http_mt_server.fun
-description: Documentation for http_mt_server.fun
-permalink: /documentation/examples/net/http_mt_server/
-lang: en
-tags:
-- example
-- http_mt_server
-- network
----
-
-
-- Location: examples/net/http_mt_server.fun
-- Category: Networking / HTTP (multi-threaded)
-
-Description
-- Thread-per-connection HTTP server built on io/socket.fun and io/thread.fun. For each accepted client, spawns a thread and returns a small HTML page.
-
-How to run
-- From the repository root:
-  - export FUN_LIB_DIR="./lib"
-  - ./build_debug/fun examples/net/http_mt_server.fun
-  - Then open http://127.0.0.1:8080/ (or the port printed on start)
-
-Requirements
-- Uses stdlib io/socket.fun and io/thread.fun. No external extensions required.
-
-See also
-- documentation/examples/README.md
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/net/http_mt_server_cgi.md b/web/documentation/examples/net/http_mt_server_cgi.md
deleted file mode 100644
index ac0123b..0000000
--- a/web/documentation/examples/net/http_mt_server_cgi.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - http_mt_server_cgi.fun
-subtitle: Documentation for http_mt_server_cgi.fun
-description: Documentation for http_mt_server_cgi.fun
-permalink: /documentation/examples/net/http_mt_server_cgi/
-lang: en
-tags:
-- example
-- http_mt_server_cgi
-- network
----
-
-
-- Location: examples/net/http_mt_server_cgi.fun
-- Category: Networking / HTTP with CGI (multi-threaded)
-
-Description
-- Multi-threaded HTTP server (thread-per-connection) with CGI support. Serves static files from htdocs and executes .fun scripts as CGI using net/cgi.fun helpers.
-
-How to run
-- From the repository root:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"   # optional; auto-detected if omitted
-  - export FUN_HTDOCS="./examples/data/htdocs"  # optional
-  - ./build_debug/fun examples/net/http_mt_server_cgi.fun
-  - Try: http://127.0.0.1:8080/ and /hello.fun?name=Fun, /info.fun
-
-Requirements
-- Uses stdlib io/socket.fun, io/thread.fun, and net/cgi.fun. No external extensions required.
-
-See also
-- documentation/examples/README.md
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/net/http_server.md b/web/documentation/examples/net/http_server.md
deleted file mode 100644
index cf51420..0000000
--- a/web/documentation/examples/net/http_server.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - http_server.fun
-subtitle: Documentation for http_server.fun
-description: Documentation for http_server.fun
-permalink: /documentation/examples/net/http_server/
-lang: en
-tags:
-- example
-- http_server
-- network
----
-
-
-- Location: examples/net/http_server.fun
-- Category: Networking / HTTP (blocking)
-
-Description
-- Blocking HTTP server that serves static files and executes .fun CGI scripts via lib/net/http_server.fun.
-
-How to run
-- From the repository root:
-  - export FUN_LIB_DIR="./lib"
-  - ./build_debug/fun examples/net/http_server.fun
-  - Default docroot: ./examples/data/htdocs
-  - Visit: http://127.0.0.1:8080/
-
-Notes
-- For CGI .fun under htdocs, the server uses the Fun interpreter to execute them and forwards output as HTTP.
-
-Requirements
-- Uses io/socket.fun and strings.fun; no external extensions required.
-
-See also
-- documentation/examples/README.md
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/net/http_server_cgi.md b/web/documentation/examples/net/http_server_cgi.md
deleted file mode 100644
index aad5159..0000000
--- a/web/documentation/examples/net/http_server_cgi.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - http_server_cgi.fun
-subtitle: Documentation for http_server_cgi.fun
-description: Documentation for http_server_cgi.fun
-permalink: /documentation/examples/net/http_server_cgi/
-lang: en
-tags:
-- example
-- http_server_cgi
-- network
----
-
-
-- Location: examples/net/http_server_cgi.fun
-- Category: Networking / HTTP with CGI (blocking)
-
-Description
-- Minimal CGI-capable HTTP server (blocking) using lib/net/http_cgi_server.fun. Serves static files and executes .fun scripts as CGI.
-
-How to run
-- From the repository root:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"   # optional; auto-detected if omitted
-  - export FUN_HTDOCS="./examples/data/htdocs"  # optional
-  - ./build_debug/fun examples/net/http_server_cgi.fun
-  - Try: http://127.0.0.1:8080/ and /hello.fun, /info.fun
-
-Requirements
-- Uses stdlib io/socket.fun, strings.fun, and net/cgi.fun. No external extensions required.
-
-See also
-- documentation/examples/README.md
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/net/http_server_cgi_lib.md b/web/documentation/examples/net/http_server_cgi_lib.md
deleted file mode 100644
index 63926f5..0000000
--- a/web/documentation/examples/net/http_server_cgi_lib.md
+++ /dev/null
@@ -1,38 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - http_server_cgi_lib.fun
-subtitle: Documentation for http_server_cgi_lib.fun
-description: Documentation for http_server_cgi_lib.fun
-permalink: /documentation/examples/net/http_server_cgi_lib/
-lang: en
-tags:
-- example
-- http_server_cgi_lib
-- network
----
-
-
-- Location: examples/net/http_server_cgi_lib.fun
-- Category: Networking / HTTP with CGI (blocking, stdlib helpers)
-
-Description
-- Blocking HTTP server that serves static files and runs .fun as CGI using helpers from lib/net/http_cgi_lib_server.fun and net/cgi.fun.
-
-How to run
-- From the repository root:
-  - export FUN_LIB_DIR="./lib"
-  - export FUN_EXEC="./build_debug/fun"   # optional; auto-detected if omitted
-  - export FUN_HTDOCS="./examples/data/htdocs"  # optional
-  - ./build_debug/fun examples/net/http_server_cgi_lib.fun
-  - Try: http://127.0.0.1:8080/ and /hello.fun, /info.fun
-
-Requirements
-- Uses stdlib io/socket.fun, strings.fun, net/cgi.fun. No external extensions required.
-
-See also
-- documentation/examples/README.md
-- documentation/examples/httpserver.md (deep-dive)
diff --git a/web/documentation/examples/net/http_static_server.md b/web/documentation/examples/net/http_static_server.md
deleted file mode 100644
index c5e311d..0000000
--- a/web/documentation/examples/net/http_static_server.md
+++ /dev/null
@@ -1,36 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - http_static_server.fun
-subtitle: Documentation for http_static_server.fun
-description: Documentation for http_static_server.fun
-permalink: /documentation/examples/net/http_static_server/
-lang: en
-tags:
-- example
-- http_static_server
-- network
----
-
-
-- Location: examples/net/http_static_server.fun
-- Category: Networking / Sockets
-
-Description
-- Minimal static HTTP server implemented directly on sockets. Accepts connections and always returns a small HTML page.
-
-How to run
-- From the repository root:
-  - export FUN_LIB_DIR="./lib"
-  - ./build_debug/fun examples/net/http_static_server.fun
-  - Then open http://127.0.0.1:8088/
-
-Requirements
-- Uses core IO/socket stdlib (io/socket.fun). No optional extensions required.
-
-See also
-- documentation/examples/README.md
-- documentation/examples/httpserver.md (deep-dive over HTTP servers)
diff --git a/web/documentation/examples/net/httpserver.md b/web/documentation/examples/net/httpserver.md
deleted file mode 100644
index 5b3ed6d..0000000
--- a/web/documentation/examples/net/httpserver.md
+++ /dev/null
@@ -1,155 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - HTTP server examples: architecture and how they work
-subtitle: Documentation for HTTP server examples, architecture and how they work
-description: Documentation for HTTP server examples, architecture and how they work
-permalink: /documentation/examples/net/httpserver/
-lang: en
-tags:
-- architecture
-- example
-- examples
-- http
-- network
-- server
-- they
-- work
----
-
-
-This guide explains the HTTP server examples under `./examples/net/http_*` and the supporting standard library modules under `./lib/net/`.
-
-It covers what each example does, how to run it, and how the request handling/CGI pieces are implemented.
-
-## Prerequisites
-- Build the project so you have a `fun` executable, or ensure `fun` is on your PATH.
-  - Typical local builds: `./build_debug/fun` or `./build_release/fun`.
-- For examples that serve files/CGI scripts, content is read from `./examples/data/htdocs` by default.
-- Helpful env vars used by some examples:
-  - `FUN_LIB_DIR` — path to the stdlib (`./lib` when running from the repo).
-  - `FUN_EXEC` — override path to the `fun` interpreter used to run CGI children.
-  - `FUN_HTDOCS` — override htdocs directory for some examples (not all).
-  - `FUN_PORT` — override port for some examples (mainly the MT CGI one).
-
-## Supporting stdlib modules (lib/net)
-
-- `net/http_server.fun` — Simple blocking HTTP server class serving static files, with a very small built-in “CGI for .fun files” (spawns `fun` with `QUERY_STRING`/`POST_DATA`).
-- `net/http_cgi_server.fun` — Blocking server with fuller CGI support using `net/cgi.fun` to translate CGI output into proper HTTP responses and richer request/header parsing.
-- `net/http_cgi_lib_server.fun` — Variant of the CGI server with the same core behavior, explicitly wiring the Fun interpreter path and using `CGI().cgi_to_http_response()` from `net/cgi.fun`.
-- `net/cgi.fun` — Helpers to work with CGI-style programs and to translate CGI output (headers + body) into full HTTP/1.1 responses.
-
-See documentation/stdlib.md → net/ for a quick index of these modules.
-
-## Example: http_static_server.fun
-- File: `examples/net/http_static_server.fun`
-- Purpose: Minimal, hand-written HTTP server that ignores the request path and always responds with a fixed HTML page.
-- Key includes: `io/socket.fun`
-- Port/backlog: hard-coded `8088`, backlog 10.
-- Flow:
-  - Creates `TcpServer(port, backlog)` → `listen()` → loop on `accept()`
-  - `sock_recv()` reads and discards request
-  - Constructs a literal HTTP/1.1 200 response with `Content-Length` and `Connection: close`
-  - Sends the response with `sock_send()` and closes the client
-- Run:
-  - `./examples/net/http_static_server.fun`
-  - Open http://127.0.0.1:8080/
-
-## Example: http_server.fun (static + simple .fun CGI)
-- File: `examples/net/http_server.fun`
-- Uses: `#include <net/http_server.fun>` (class `HTTPServer`)
-- Purpose: Blocking server that serves static files from an htdocs directory; if the requested path ends with `.fun`, it spawns `fun` to run the script and returns its output.
-- Defaults in example:
-  - Port: `8080`
-  - Htdocs: `./examples/data/htdocs`
-- Implementation highlights (see `lib/net/http_server.fun`):
-  - Parses request line to get `method` and `path`; `/` maps to `/index.html`.
-  - When path ends with `.fun`, builds a small environment:
-    - `QUERY_STRING` (for `?a=b`), `POST_DATA` (raw body when `POST`).
-    - Runs `proc_run("<env> fun <script>")` and uses `out` as response body.
-  - Otherwise reads the file from `htdocs` and serves it as-is.
-  - Sends basic HTTP/1.1 headers: 200/404, `Content-Type: text/html`, `Content-Length`, `Connection: close`.
-- Run:
-  - `./examples/net/http_server.fun`
-  - Open http://127.0.0.1:8080/ and the sample CGI endpoints like `/hello.fun?name=Fun`.
-
-## Example: http_server_cgi.fun (CGI via external interpreter)
-- File: `examples/net/http_server_cgi.fun`
-- Uses: `#include <net/http_cgi_server.fun>` (class `HTTPCGIServer`)
-- Purpose: Blocking server that serves static files and executes `.fun` scripts under htdocs via a child Fun interpreter, with fuller CGI environment and header handling.
-- Defaults in example:
-  - Port: `8080`
-  - Htdocs: `./examples/data/htdocs`
-- Implementation highlights (see `lib/net/http_cgi_server.fun`):
-  - Robust request-line extraction and header parsing (case-normalized to uppercase).
-  - Path routing: `/` → `/index.html`; `.fun` → treat as CGI script.
-  - Builds CGI env including: `FUN_LIB_DIR`, `REQUEST_METHOD`, `QUERY_STRING`, `SCRIPT_NAME`, `PATH_INFO`, `SERVER_NAME`, `SERVER_PORT`, `SERVER_PROTOCOL`, `HTTP_HOST`, `HTTP_USER_AGENT`, `HTTP_COOKIE`, `CONTENT_TYPE`, `CONTENT_LENGTH`, and `POST_DATA` (if any).
-  - Interpreter selection priority: `$FUN_EXEC` → `./build_debug/fun` → `./build_release/fun` → `fun` from PATH.
-  - Uses `net/cgi.fun` to convert CGI output (headers + body) into a proper HTTP/1.1 response before sending.
-- Run:
-  - `./examples/net/http_server_cgi.fun`
-  - Try: `/`, `/hello.fun?name=Fun`, `/info.fun` under http://127.0.0.1:8080/
-
-## Example: http_server_cgi_lib.fun (CGI via stdlib wrapper)
-- File: `examples/net/http_server_cgi_lib.fun`
-- Uses: `#include <net/http_cgi_lib_server.fun>` (class `HTTPCGILibServer`)
-- Purpose: Same goal as the previous example but split into a slightly different stdlib class; also uses `CGI().cgi_to_http_response()` for translating CGI output.
-- Defaults and behavior mirror `HTTPCGIServer`: static files from htdocs, `.fun` as CGI with the same env block and interpreter selection logic.
-- Run:
-  - `./examples/net/http_server_cgi_lib.fun`
-  - Try: `/`, `/hello.fun?name=Fun`, `/info.fun` under http://127.0.0.1:8080/
-
-## Example: http_mt_server.fun (thread-per-connection)
-- File: `examples/net/http_mt_server.fun`
-- Uses: `io/socket.fun`, `io/thread.fun`
-- Purpose: Hand-written multi-threaded server; main thread blocks in `accept()`, each connection handled in a new Fun thread.
-- Behavior: Reads request, replies with a fixed HTML 200 response, then closes the connection.
-- Defaults: `PORT = 8080`, `BACKLOG = 128` (note the comment mentions 8089 in a usage line; the code uses 8080).
-- Run: `./examples/net/http_mt_server.fun` then open http://127.0.0.1:8080/
-
-## Example: http_mt_server_cgi.fun (thread-per-connection + CGI)
-- File: `examples/net/http_mt_server_cgi.fun`
-- Uses: `io/socket.fun`, `io/thread.fun`, `net/cgi.fun`
-- Purpose: Multi-threaded server that serves static files from htdocs and executes `.fun` scripts as CGI, implemented without higher-level string helpers to keep per-thread globals minimal.
-- Defaults: `PORT = 8080`, `BACKLOG = 128`, `HTDOCS = ./examples/data/htdocs`.
-- Request handling flow:
-  - Reads request bytes, extracts the request line, splits out `method` and `target`.
-  - Splits `path` and `query` on `?`; `/` becomes `/index.html`.
-  - Parses headers into a map (uppercase keys) and optionally reads a request body.
-  - Routing:
-    - If `path` ends with `.fun`: build CGI env; spawn a child `fun` to execute the script; capture stdout; translate to HTTP via `_cgi_to_http_response()`; send back.
-    - Else: attempt to read the static file from `HTDOCS + path`; send 200 or 404.
-- CGI environment variables set (subset):
-  - `FUN_LIB_DIR`, `REQUEST_METHOD`, `QUERY_STRING`, `SCRIPT_NAME`, `PATH_INFO`, `SERVER_NAME`, `SERVER_PORT`, `SERVER_PROTOCOL`, `HTTP_HOST`, `HTTP_USER_AGENT`, `HTTP_COOKIE`, `CONTENT_TYPE`, `CONTENT_LENGTH`, `POST_DATA` (when present).
-- Interpreter selection (similar to CGI examples): `$FUN_EXEC` → `./build_debug/fun` → `./build_release/fun` → `fun` from PATH.
-- Notes:
-  - Allows overriding `HTDOCS` & port via `FUN_HTDOCS` and `FUN_PORT` environment variables.
-  - Implements its own small helpers (`_trim`, `_ends_with`, `_split_*`) to avoid heavy string utilities inside threads.
-- Run: `./examples/net/http_mt_server_cgi.fun` then open http://127.0.0.1:8080/
-
-## Example: http_server_test.fun
-- File: `examples/net/http_server_test.fun`
-- Purpose: Small test harness to exercise/verify server pieces (implementation details may change). Check the source for exact behavior.
-
-## Common behaviors and notes
-- Index handling: most servers map `/` to `/index.html` under the configured `htdocs` directory.
-- Static files: served by reading from `<htdocs><path>`; a missing file returns `404 Not Found`.
-- CGI scripts:
-  - Any path ending in `.fun` under `htdocs` is executed with the Fun interpreter as a child process.
-  - CGI output is expected to be a mix of optional headers and a body; the servers convert this to a valid HTTP/1.1 response (via `net/cgi.fun` or a local helper).
-  - To ensure the child can `#include` stdlib modules, `FUN_LIB_DIR` is populated (defaults to `./lib` when run from repo root).
-- Content types: examples return `Content-Type: text/html; charset=utf-8` by default for dynamic responses; static file content types are not auto-detected in these examples.
-- Connection handling: responses include `Connection: close`; examples do not implement keep-alive or HTTP/1.1 request pipelining.
-- Security: these are demo servers. Do not expose them to untrusted networks. They lack path normalization, MIME sniffing, directory traversal protection, rate limiting, and TLS.
-
-## How to point htdocs somewhere else
-- For class-based servers: call `set_htdocs("/path/to/site")` on the server instance before `start()`.
-- For the MT CGI example: set `FUN_HTDOCS=/path/to/site` in the environment before launch.
-
-## Troubleshooting
-- If a CGI request yields a 500 and you see “CGI produced no output”, run the target `.fun` directly with your `fun` interpreter and fix any errors.
-- Confirm `FUN_LIB_DIR` points to the stdlib (especially when running CGI scripts that `#include` modules).
-- If the server cannot start, another process might be using the chosen port.
diff --git a/web/documentation/examples/objects_basic.md b/web/documentation/examples/objects_basic.md
deleted file mode 100644
index ce5b4ab..0000000
--- a/web/documentation/examples/objects_basic.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - objects_basic.fun — overview
-subtitle: Documentation for objects_basic.fun — overview
-description: Documentation for objects_basic.fun — overview
-permalink: /documentation/examples/objects_basic/
-lang: en
-tags:
-- example
-- objects_basic
----
-
-
-What it shows
-- OO basics: defining objects, fields, and invoking methods.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/objects_basic.fun
-- Or: fun examples/objects_basic.fun
diff --git a/web/documentation/examples/objects_more.md b/web/documentation/examples/objects_more.md
deleted file mode 100644
index 32b9e80..0000000
--- a/web/documentation/examples/objects_more.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - objects_more.fun — overview
-subtitle: Documentation for objects_more.fun — overview
-description: Documentation for objects_more.fun — overview
-permalink: /documentation/examples/objects_more/
-lang: en
-tags:
-- example
-- objects_more
----
-
-
-What it shows
-- Additional object patterns: composition, methods, and utilities.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/objects_more.fun
-- Or: fun examples/objects_more.fun
diff --git a/web/documentation/examples/os_env.md b/web/documentation/examples/os_env.md
deleted file mode 100644
index 4898775..0000000
--- a/web/documentation/examples/os_env.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - os_env.fun — overview
-subtitle: Documentation for os_env.fun — overview
-description: Documentation for os_env.fun — overview
-permalink: /documentation/examples/os_env/
-lang: en
-tags:
-- example
-- os_env
----
-
-
-What it shows
-- Reading and writing environment variables from the operating system.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/os_env.fun
-- Or: fun examples/os_env.fun
diff --git a/web/documentation/examples/process_example.md b/web/documentation/examples/process_example.md
deleted file mode 100644
index e81aa5a..0000000
--- a/web/documentation/examples/process_example.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - process_example.fun — overview
-subtitle: Documentation for process_example.fun — overview
-description: Documentation for process_example.fun — overview
-permalink: /documentation/examples/process_example/
-lang: en
-tags:
-- example
-- process_example
----
-
-
-What it shows
-- Spawning and capturing subprocess output; simple process management.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/process_example.fun
-- Or: fun examples/process_example.fun
diff --git a/web/documentation/examples/progress.md b/web/documentation/examples/progress.md
deleted file mode 100644
index 8c50903..0000000
--- a/web/documentation/examples/progress.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - progress.fun — overview
-subtitle: Documentation for progress.fun — overview
-description: Documentation for progress.fun — overview
-permalink: /documentation/examples/progress/
-lang: en
-tags:
-- example
-- progress
----
-
-
-What it shows
-- Simple progress display in the terminal.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/progress.fun
-- Or: fun examples/progress.fun
diff --git a/web/documentation/examples/progress_inline.md b/web/documentation/examples/progress_inline.md
deleted file mode 100644
index 3527d7c..0000000
--- a/web/documentation/examples/progress_inline.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - progress_inline.fun — overview
-subtitle: Documentation for progress_inline.fun — overview
-description: Documentation for progress_inline.fun — overview
-permalink: /documentation/examples/progress_inline/
-lang: en
-tags:
-- example
-- progress_inline
----
-
-
-What it shows
-- Inline progress updates (same line updates) for simple terminal UIs.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/progress_inline.fun
-- Or: fun examples/progress_inline.fun
diff --git a/web/documentation/examples/random_demo.md b/web/documentation/examples/random_demo.md
deleted file mode 100644
index b9ad7ed..0000000
--- a/web/documentation/examples/random_demo.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - random_demo.fun — overview
-subtitle: Documentation for random_demo.fun — overview
-description: Documentation for random_demo.fun — overview
-permalink: /documentation/examples/random_demo/
-lang: en
-tags:
-- example
-- random_demo
----
-
-
-What it shows
-- Random number generator usage and seeding basics.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/random_demo.fun
-- Or: fun examples/random_demo.fun
diff --git a/web/documentation/examples/random_number_example.md b/web/documentation/examples/random_number_example.md
deleted file mode 100644
index f181b9d..0000000
--- a/web/documentation/examples/random_number_example.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - random_number_example.fun — overview
-subtitle: Documentation for random_number_example.fun — overview
-description: Documentation for random_number_example.fun — overview
-permalink: /documentation/examples/random_number_example/
-lang: en
-tags:
-- example
-- random_number_example
----
-
-
-What it shows
-- Generating random numbers and printing them; small utility demo.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/random_number_example.fun
-- Or: fun examples/random_number_example.fun
diff --git a/web/documentation/examples/regex_demo.md b/web/documentation/examples/regex_demo.md
deleted file mode 100644
index 62e742d..0000000
--- a/web/documentation/examples/regex_demo.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - regex_demo.fun — overview
-subtitle: Documentation for regex_demo.fun — overview
-description: Documentation for regex_demo.fun — overview
-permalink: /documentation/examples/regex_demo/
-lang: en
-tags:
-- example
-- regex_demo
----
-
-
-What it shows
-- Regex helpers usage; simple matching and replacement tasks.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/regex_demo.fun
-- Or: fun examples/regex_demo.fun
-
-Notes
-- Some regex examples depend on the optional PCRE2 extension; enable it in your build to run.
diff --git a/web/documentation/examples/regex_procedural.md b/web/documentation/examples/regex_procedural.md
deleted file mode 100644
index 3d5a19d..0000000
--- a/web/documentation/examples/regex_procedural.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - regex_procedural.fun — overview
-subtitle: Documentation for regex_procedural.fun — overview
-description: Documentation for regex_procedural.fun — overview
-permalink: /documentation/examples/regex_procedural/
-lang: en
-tags:
-- example
-- regex_procedural
----
-
-
-What it shows
-- Procedural approach to regex work: compiling patterns and iterating matches.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/regex_procedural.fun
-- Or: fun examples/regex_procedural.fun
-
-Notes
-- May require the optional PCRE2 extension in your build.
diff --git a/web/documentation/examples/rust_hello.md b/web/documentation/examples/rust_hello.md
deleted file mode 100644
index 38e0774..0000000
--- a/web/documentation/examples/rust_hello.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - rust_hello.fun — overview
-subtitle: Documentation for rust_hello.fun — overview
-description: Documentation for rust_hello.fun — overview
-permalink: /documentation/examples/rust_hello/
-lang: en
-tags:
-- example
-- rust_hello
----
-
-
-What it shows
-- Using Rust opcodes from Fun (when built with Rust support).
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/rust_hello.fun
-- Or: fun examples/rust_hello.fun
-
-Notes
-- Requires building with FUN_WITH_RUST; otherwise this example will be unavailable.
diff --git a/web/documentation/examples/rust_hello_args.md b/web/documentation/examples/rust_hello_args.md
deleted file mode 100644
index ebdb590..0000000
--- a/web/documentation/examples/rust_hello_args.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - rust_hello_args.fun — overview
-subtitle: Documentation for rust_hello_args.fun — overview
-description: Documentation for rust_hello_args.fun — overview
-permalink: /documentation/examples/rust_hello_args/
-lang: en
-tags:
-- example
-- rust_hello_args
----
-
-
-What it shows
-- Passing arguments into Rust-backed opcodes and handling returns.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/rust_hello_args.fun
-- Or: fun examples/rust_hello_args.fun
-
-Notes
-- Requires building with FUN_WITH_RUST.
diff --git a/web/documentation/examples/rust_hello_args_return.md b/web/documentation/examples/rust_hello_args_return.md
deleted file mode 100644
index 2165315..0000000
--- a/web/documentation/examples/rust_hello_args_return.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - rust_hello_args_return.fun — overview
-subtitle: Documentation for rust_hello_args_return.fun — overview
-description: Documentation for rust_hello_args_return.fun — overview
-permalink: /documentation/examples/rust_hello_args_return/
-lang: en
-tags:
-- example
-- rust_hello_args_return
----
-
-
-What it shows
-- Demonstrates returning values from Rust-backed opcodes with arguments.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/rust_hello_args_return.fun
-- Or: fun examples/rust_hello_args_return.fun
-
-Notes
-- Requires building with FUN_WITH_RUST.
diff --git a/web/documentation/examples/serial_demo.md b/web/documentation/examples/serial_demo.md
deleted file mode 100644
index 90517cd..0000000
--- a/web/documentation/examples/serial_demo.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - serial_demo.fun — overview
-subtitle: Documentation for serial_demo.fun — overview
-description: Documentation for serial_demo.fun — overview
-permalink: /documentation/examples/serial_demo/
-lang: en
-tags:
-- example
-- serial_demo
----
-
-
-What it shows
-- Serial port access and basic read/write (when available on your system).
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/serial_demo.fun
-- Or: fun examples/serial_demo.fun
-
-Notes
-- Requires serial device access; may depend on platform support and permissions.
diff --git a/web/documentation/examples/short_circuit_test.md b/web/documentation/examples/short_circuit_test.md
deleted file mode 100644
index 832aa0a..0000000
--- a/web/documentation/examples/short_circuit_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - short_circuit_test.fun — overview
-subtitle: Documentation for short_circuit_test.fun — overview
-description: Documentation for short_circuit_test.fun — overview
-permalink: /documentation/examples/short_circuit_test/
-lang: en
-tags:
-- example
-- short_circuit_test
----
-
-
-What it shows
-- Boolean evaluation order and short-circuit behavior with && and ||.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/short_circuit_test.fun
-- Or: fun examples/short_circuit_test.fun
diff --git a/web/documentation/examples/signed_ints.md b/web/documentation/examples/signed_ints.md
deleted file mode 100644
index b6c9154..0000000
--- a/web/documentation/examples/signed_ints.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - signed_ints.fun — overview
-subtitle: Documentation for signed_ints.fun — overview
-description: Documentation for signed_ints.fun — overview
-permalink: /documentation/examples/signed_ints/
-lang: en
-tags:
-- example
-- signed_ints
----
-
-
-What it shows
-- Signed integer types and operations; ranges and conversions.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/signed_ints.fun
-- Or: fun examples/signed_ints.fun
diff --git a/web/documentation/examples/stdlib_showcase.md b/web/documentation/examples/stdlib_showcase.md
deleted file mode 100644
index 43e92e3..0000000
--- a/web/documentation/examples/stdlib_showcase.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - stdlib_showcase.fun — overview
-subtitle: Documentation for stdlib_showcase.fun — overview
-description: Documentation for stdlib_showcase.fun — overview
-permalink: /documentation/examples/stdlib_showcase/
-lang: en
-tags:
-- example
-- stdlib_showcase
----
-
-
-What it shows
-- Sampler of common standard library modules and utilities.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/stdlib_showcase.fun
-- Or: fun examples/stdlib_showcase.fun
diff --git a/web/documentation/examples/strings_test.md b/web/documentation/examples/strings_test.md
deleted file mode 100644
index 03db333..0000000
--- a/web/documentation/examples/strings_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - strings_test.fun — overview
-subtitle: Documentation for strings_test.fun — overview
-description: Documentation for strings_test.fun — overview
-permalink: /documentation/examples/strings_test/
-lang: en
-tags:
-- example
-- strings_test
----
-
-
-What it shows
-- String helpers and edge cases; splitting, joining, trimming, and formatting.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/strings_test.fun
-- Or: fun examples/strings_test.fun
diff --git a/web/documentation/examples/tcp_http_get.md b/web/documentation/examples/tcp_http_get.md
deleted file mode 100644
index 2e59828..0000000
--- a/web/documentation/examples/tcp_http_get.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - tcp_http_get.fun — overview
-subtitle: Documentation for tcp_http_get.fun — overview
-description: Documentation for tcp_http_get.fun — overview
-permalink: /documentation/examples/tcp_http_get/
-lang: en
-tags:
-- example
-- tcp_http_get
----
-
-
-What it shows
-- Manual HTTP client over raw TCP sockets: connect, write request, read response.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/tcp_http_get.fun
-- Or: fun examples/tcp_http_get.fun
-
-Notes
-- Requires network access to the target host used in the script.
diff --git a/web/documentation/examples/tcp_http_get_class.md b/web/documentation/examples/tcp_http_get_class.md
deleted file mode 100644
index f9258d2..0000000
--- a/web/documentation/examples/tcp_http_get_class.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - tcp_http_get_class.fun — overview
-subtitle: Documentation for tcp_http_get_class.fun — overview
-description: Documentation for tcp_http_get_class.fun — overview
-permalink: /documentation/examples/tcp_http_get_class/
-lang: en
-tags:
-- example
-- tcp_http_get_class
----
-
-
-What it shows
-- Manual HTTP client implemented with a small helper class over sockets.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/tcp_http_get_class.fun
-- Or: fun examples/tcp_http_get_class.fun
-
-Notes
-- Requires network access to the target host used in the script.
diff --git a/web/documentation/examples/test_bits.md b/web/documentation/examples/test_bits.md
deleted file mode 100644
index 9b51997..0000000
--- a/web/documentation/examples/test_bits.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_bits.fun — overview
-subtitle: Documentation for test_bits.fun — overview
-description: Documentation for test_bits.fun — overview
-permalink: /documentation/examples/test_bits/
-lang: en
-tags:
-- example
-- test_bits
----
-
-
-What it shows
-- Bitwise utilities demonstration (and/or/xor/shifts) and small tests.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_bits.fun
-- Or: fun examples/test_bits.fun
diff --git a/web/documentation/examples/test_dec_to_hex.md b/web/documentation/examples/test_dec_to_hex.md
deleted file mode 100644
index 8abf040..0000000
--- a/web/documentation/examples/test_dec_to_hex.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_dec_to_hex.fun — overview
-subtitle: Documentation for test_dec_to_hex.fun — overview
-description: Documentation for test_dec_to_hex.fun — overview
-permalink: /documentation/examples/test_dec_to_hex/
-lang: en
-tags:
-- example
-- test_dec_to_hex
----
-
-
-What it shows
-- Decimal to hexadecimal conversion helper/tests.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_dec_to_hex.fun
-- Or: fun examples/test_dec_to_hex.fun
diff --git a/web/documentation/examples/test_hex_to_dec.md b/web/documentation/examples/test_hex_to_dec.md
deleted file mode 100644
index e8764e1..0000000
--- a/web/documentation/examples/test_hex_to_dec.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_hex_to_dec.fun — overview
-subtitle: Documentation for test_hex_to_dec.fun — overview
-description: Documentation for test_hex_to_dec.fun — overview
-permalink: /documentation/examples/test_hex_to_dec/
-lang: en
-tags:
-- example
-- test_hex_to_dec
----
-
-
-What it shows
-- Hexadecimal to decimal conversion helper/tests.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_hex_to_dec.fun
-- Or: fun examples/test_hex_to_dec.fun
diff --git a/web/documentation/examples/test_include.md b/web/documentation/examples/test_include.md
deleted file mode 100644
index 43bab0f..0000000
--- a/web/documentation/examples/test_include.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_include.fun — overview
-subtitle: Documentation for test_include.fun — overview
-description: Documentation for test_include.fun — overview
-permalink: /documentation/examples/test_include/
-lang: en
-tags:
-- example
-- test_include
----
-
-
-What it shows
-- Small include mechanics test; ensures local and stdlib includes work.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_include.fun
-- Or: fun examples/test_include.fun
diff --git a/web/documentation/examples/test_rol.md b/web/documentation/examples/test_rol.md
deleted file mode 100644
index 00c083c..0000000
--- a/web/documentation/examples/test_rol.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_rol.fun — overview
-subtitle: Documentation for test_rol.fun — overview
-description: Documentation for test_rol.fun — overview
-permalink: /documentation/examples/test_rol/
-lang: en
-tags:
-- example
-- test_rol
----
-
-
-What it shows
-- Bit rotation (ROL) helper/tests.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_rol.fun
-- Or: fun examples/test_rol.fun
diff --git a/web/documentation/examples/test_serial.md b/web/documentation/examples/test_serial.md
deleted file mode 100644
index a77f50e..0000000
--- a/web/documentation/examples/test_serial.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_serial.fun — overview
-subtitle: Documentation for test_serial.fun — overview
-description: Documentation for test_serial.fun — overview
-permalink: /documentation/examples/test_serial/
-lang: en
-tags:
-- example
-- test_serial
----
-
-
-What it shows
-- Serial port test; opens a port and exchanges a few bytes (when available).
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_serial.fun
-- Or: fun examples/test_serial.fun
-
-Notes
-- Requires serial device access; may depend on platform support and permissions.
diff --git a/web/documentation/examples/test_shl.md b/web/documentation/examples/test_shl.md
deleted file mode 100644
index 748b2df..0000000
--- a/web/documentation/examples/test_shl.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_shl.fun — overview
-subtitle: Documentation for test_shl.fun — overview
-description: Documentation for test_shl.fun — overview
-permalink: /documentation/examples/test_shl/
-lang: en
-tags:
-- example
-- test_shl
----
-
-
-What it shows
-- Bit shift left (SHL) helper/tests.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_shl.fun
-- Or: fun examples/test_shl.fun
diff --git a/web/documentation/examples/test_types.md b/web/documentation/examples/test_types.md
deleted file mode 100644
index 0316cf5..0000000
--- a/web/documentation/examples/test_types.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_types.fun — overview
-subtitle: Documentation for test_types.fun — overview
-description: Documentation for test_types.fun — overview
-permalink: /documentation/examples/test_types/
-lang: en
-tags:
-- example
-- test_types
----
-
-
-What it shows
-- Type checks and simple assertions around type behavior.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_types.fun
-- Or: fun examples/test_types.fun
diff --git a/web/documentation/examples/test_xor.md b/web/documentation/examples/test_xor.md
deleted file mode 100644
index 3624189..0000000
--- a/web/documentation/examples/test_xor.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - test_xor.fun — overview
-subtitle: Documentation for test_xor.fun — overview
-description: Documentation for test_xor.fun — overview
-permalink: /documentation/examples/test_xor/
-lang: en
-tags:
-- example
-- test_xor
----
-
-
-What it shows
-- Bitwise XOR helper/tests.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/test_xor.fun
-- Or: fun examples/test_xor.fun
diff --git a/web/documentation/examples/thread_class_example.md b/web/documentation/examples/thread_class_example.md
deleted file mode 100644
index cfac0b0..0000000
--- a/web/documentation/examples/thread_class_example.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - thread_class_example.fun — overview
-subtitle: Documentation for thread_class_example.fun — overview
-description: Documentation for thread_class_example.fun — overview
-permalink: /documentation/examples/thread_class_example/
-lang: en
-tags:
-- example
-- thread_class_example
----
-
-
-What it shows
-- Threading building blocks using a small thread class; start/join patterns.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/thread_class_example.fun
-- Or: fun examples/thread_class_example.fun
diff --git a/web/documentation/examples/threads_demo.md b/web/documentation/examples/threads_demo.md
deleted file mode 100644
index 4f335b1..0000000
--- a/web/documentation/examples/threads_demo.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - threads_demo.fun — overview
-subtitle: Documentation for threads_demo.fun — overview
-description: Documentation for threads_demo.fun — overview
-permalink: /documentation/examples/threads_demo/
-lang: en
-tags:
-- example
-- threads_demo
----
-
-
-What it shows
-- Threading building blocks and concurrent execution demo.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/threads_demo.fun
-- Or: fun examples/threads_demo.fun
diff --git a/web/documentation/examples/try_catch_finally.md b/web/documentation/examples/try_catch_finally.md
deleted file mode 100644
index de632c2..0000000
--- a/web/documentation/examples/try_catch_finally.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - try_catch_finally.fun — overview
-subtitle: Documentation for try_catch_finally.fun — overview
-description: Documentation for try_catch_finally.fun — overview
-permalink: /documentation/examples/try_catch_finally/
-lang: en
-tags:
-- example
-- try_catch_finally
----
-
-
-What it shows
-- Structured error handling with try/catch/finally blocks.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/try_catch_finally.fun
-- Or: fun examples/try_catch_finally.fun
diff --git a/web/documentation/examples/type_safety.md b/web/documentation/examples/type_safety.md
deleted file mode 100644
index 2a2a18a..0000000
--- a/web/documentation/examples/type_safety.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - type_safety.fun — overview
-subtitle: Documentation for type_safety.fun — overview
-description: Documentation for type_safety.fun — overview
-permalink: /documentation/examples/type_safety/
-lang: en
-tags:
-- example
-- type_safety
----
-
-
-What it shows
-- Static/dynamic type checks and enforcing type safety in small examples.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/type_safety.fun
-- Or: fun examples/type_safety.fun
diff --git a/web/documentation/examples/type_safety_fails.md b/web/documentation/examples/type_safety_fails.md
deleted file mode 100644
index 711e170..0000000
--- a/web/documentation/examples/type_safety_fails.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - type_safety_fails.fun — overview
-subtitle: Documentation for type_safety_fails.fun — overview
-description: Documentation for type_safety_fails.fun — overview
-permalink: /documentation/examples/type_safety_fails/
-lang: en
-tags:
-- example
-- type_safety_fails
----
-
-
-What it shows
-- Examples that intentionally violate type expectations to illustrate safety checks.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/type_safety_fails.fun
-- Or: fun examples/type_safety_fails.fun
diff --git a/web/documentation/examples/typeof.md b/web/documentation/examples/typeof.md
deleted file mode 100644
index 3d88ff2..0000000
--- a/web/documentation/examples/typeof.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - typeof.fun — overview
-subtitle: Documentation for typeof.fun — overview
-description: Documentation for typeof.fun — overview
-permalink: /documentation/examples/typeof/
-lang: en
-tags:
-- example
-- typeof
----
-
-
-What it shows
-- Type inspection using typeof and related helpers.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/typeof.fun
-- Or: fun examples/typeof.fun
diff --git a/web/documentation/examples/typeof_features.md b/web/documentation/examples/typeof_features.md
deleted file mode 100644
index 217ed90..0000000
--- a/web/documentation/examples/typeof_features.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - typeof_features.fun — overview
-subtitle: Documentation for typeof_features.fun — overview
-description: Documentation for typeof_features.fun — overview
-permalink: /documentation/examples/typeof_features/
-lang: en
-tags:
-- example
-- typeof_features
----
-
-
-What it shows
-- A tour of typeof-related features and type introspection helpers.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/typeof_features.fun
-- Or: fun examples/typeof_features.fun
diff --git a/web/documentation/examples/types_integers.md b/web/documentation/examples/types_integers.md
deleted file mode 100644
index d154d2d..0000000
--- a/web/documentation/examples/types_integers.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - types_integers.fun — overview
-subtitle: Documentation for types_integers.fun — overview
-description: Documentation for types_integers.fun — overview
-permalink: /documentation/examples/types_integers/
-lang: en
-tags:
-- example
-- types_integers
----
-
-
-What it shows
-- Integer type families, ranges, and basic operations.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/types_integers.fun
-- Or: fun examples/types_integers.fun
diff --git a/web/documentation/examples/types_overview.md b/web/documentation/examples/types_overview.md
deleted file mode 100644
index 63b394e..0000000
--- a/web/documentation/examples/types_overview.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - types_overview.fun — overview
-subtitle: Documentation for types_overview.fun — overview
-description: Documentation for types_overview.fun — overview
-permalink: /documentation/examples/types_overview/
-lang: en
-tags:
-- example
-- types_overview
----
-
-
-What it shows
-- Overview of language types with small examples.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/types_overview.fun
-- Or: fun examples/types_overview.fun
diff --git a/web/documentation/examples/uint_types.md b/web/documentation/examples/uint_types.md
deleted file mode 100644
index 2d4c73f..0000000
--- a/web/documentation/examples/uint_types.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - uint_types.fun — overview
-subtitle: Documentation for uint_types.fun — overview
-description: Documentation for uint_types.fun — overview
-permalink: /documentation/examples/uint_types/
-lang: en
-tags:
-- example
-- uint_types
----
-
-
-What it shows
-- Unsigned integer types and operations; ranges and conversions.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/uint_types.fun
-- Or: fun examples/uint_types.fun
diff --git a/web/documentation/examples/unix_socket_echo.md b/web/documentation/examples/unix_socket_echo.md
deleted file mode 100644
index afc3abd..0000000
--- a/web/documentation/examples/unix_socket_echo.md
+++ /dev/null
@@ -1,27 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - unix_socket_echo.fun — overview
-subtitle: Documentation for unix_socket_echo.fun — overview
-description: Documentation for unix_socket_echo.fun — overview
-permalink: /documentation/examples/unix_socket_echo/
-lang: en
-tags:
-- example
-- unix_socket_echo
----
-
-
-What it shows
-- Local domain (UNIX) socket echo server/client demonstration.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/unix_socket_echo.fun
-- Or: fun examples/unix_socket_echo.fun
-
-Notes
-- Uses a UNIX domain socket path on the local filesystem; ensure you have permissions to create it.
diff --git a/web/documentation/examples/version.md b/web/documentation/examples/version.md
deleted file mode 100644
index 86b3902..0000000
--- a/web/documentation/examples/version.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - version.fun — overview
-subtitle: Documentation for version.fun — overview
-description: Documentation for version.fun — overview
-permalink: /documentation/examples/version/
-lang: en
-tags:
-- example
-- version
----
-
-
-What it shows
-- Prints VM and version info for the Fun interpreter/runtime.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/version.fun
-- Or: fun examples/version.fun
diff --git a/web/documentation/examples/while_test.md b/web/documentation/examples/while_test.md
deleted file mode 100644
index 56a6dff..0000000
--- a/web/documentation/examples/while_test.md
+++ /dev/null
@@ -1,24 +0,0 @@
----
-layout: page
-published: true
-noToc: false
-noComments: false
-noDate: false
-title: Fun - while_test.fun — overview
-subtitle: Documentation for while_test.fun — overview
-description: Documentation for while_test.fun — overview
-permalink: /documentation/examples/while_test/
-lang: en
-tags:
-- example
-- while_test
----
-
-
-What it shows
-- Simple while loop example; loop conditions and counters.
-
-How to run
-- export FUN_LIB_DIR="./lib"
-- ./build_debug/fun examples/while_test.fun
-- Or: fun examples/while_test.fun
diff --git a/web/documentation/external/curl.md b/web/documentation/external/curl/curl.md
similarity index 91%
rename from web/documentation/external/curl.md
rename to web/documentation/external/curl/curl.md
index a748e53..1bbf96c 100644
--- a/web/documentation/external/curl.md
+++ b/web/documentation/external/curl/curl.md
@@ -16,10 +16,9 @@ tags:
 - optional
 ---
 
-
 - CMake option: FUN_WITH_CURL=ON
 - Purpose: HTTP helpers using libcurl.
-- Homepage: https://curl.se/libcurl/
+- Homepage: [https://curl.se/libcurl/](https://curl.se/libcurl/){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/external/external.md b/web/documentation/external/external/external.md
similarity index 100%
rename from web/documentation/external/external.md
rename to web/documentation/external/external/external.md
index 262b213..523c00a 100644
--- a/web/documentation/external/external.md
+++ b/web/documentation/external/external/external.md
@@ -31,8 +31,8 @@ tags:
 - what
 ---
 
-
 This section documents Fun's optional, build-time selectable extensions. Each page covers:
+
 - How to enable the extension via CMake option (FUN_WITH_*)
 - Build requirements and detection notes
 - Available opcodes and/or helper functions
diff --git a/web/documentation/external/ini.md b/web/documentation/external/ini/ini.md
similarity index 91%
rename from web/documentation/external/ini.md
rename to web/documentation/external/ini/ini.md
index bc2b306..53ad719 100644
--- a/web/documentation/external/ini.md
+++ b/web/documentation/external/ini/ini.md
@@ -19,7 +19,7 @@ tags:
 
 - CMake option: FUN_WITH_INI=ON
 - Purpose: Read/write simple INI configuration files.
-- Homepage: https://github.com/ndevilla/iniparser
+- Homepage: [https://github.com/ndevilla/iniparser](https://github.com/ndevilla/iniparser){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/external/json.md b/web/documentation/external/json/json.md
similarity index 89%
rename from web/documentation/external/json.md
rename to web/documentation/external/json/json.md
index 0d2f533..9237594 100644
--- a/web/documentation/external/json.md
+++ b/web/documentation/external/json/json.md
@@ -18,7 +18,7 @@ tags:
 
 - CMake option: FUN_WITH_JSON=ON
 - Purpose: JSON parse/stringify and file helpers via json-c.
-- Homepage: https://json-c.github.io/json-c/
+- Homepage: [https://json-c.github.io/json-c/](https://json-c.github.io/json-c/){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/external/openssl.md b/web/documentation/external/openssl/openssl.md
similarity index 96%
rename from web/documentation/external/openssl.md
rename to web/documentation/external/openssl/openssl.md
index 7b61237..49b95fb 100644
--- a/web/documentation/external/openssl.md
+++ b/web/documentation/external/openssl/openssl.md
@@ -18,7 +18,7 @@ tags:
 
 - CMake option: FUN_WITH_OPENSSL=ON
 - Purpose: provide small crypto helpers backed by OpenSSL. Includes md5, sha256, sha512, ripemd160 helpers.
-- Homepage: https://www.openssl.org/
+- Homepage: [https://www.openssl.org/](https://www.openssl.org/){:class="ext"}
 
 ## Build notes:
 
diff --git a/web/documentation/external/pcre2.md b/web/documentation/external/pcre2/pcre2.md
similarity index 92%
rename from web/documentation/external/pcre2.md
rename to web/documentation/external/pcre2/pcre2.md
index 9218f49..a40ba74 100644
--- a/web/documentation/external/pcre2.md
+++ b/web/documentation/external/pcre2/pcre2.md
@@ -21,7 +21,7 @@ tags:
 
 - CMake option: FUN_WITH_PCRE2=ON
 - Purpose: Advanced regular expressions via PCRE2.
-- Homepage: https://www.pcre.org/
+- Homepage: [https://www.pcre.org/](https://www.pcre.org/){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/external/pcsc.md b/web/documentation/external/pcsc/pcsc.md
similarity index 92%
rename from web/documentation/external/pcsc.md
rename to web/documentation/external/pcsc/pcsc.md
index 4a3ce6c..aeb0e87 100644
--- a/web/documentation/external/pcsc.md
+++ b/web/documentation/external/pcsc/pcsc.md
@@ -19,7 +19,7 @@ tags:
 
 - CMake option: FUN_WITH_PCSC=ON
 - Purpose: Access smart card readers/cards via PC/SC (pcsclite).
-- Homepage: https://pcsclite.apdu.fr/
+- Homepage: [https://pcsclite.apdu.fr/](https://pcsclite.apdu.fr/){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/external/sqlite.md b/web/documentation/external/sqlite/sqlite.md
similarity index 90%
rename from web/documentation/external/sqlite.md
rename to web/documentation/external/sqlite/sqlite.md
index 6e634b1..79c64da 100644
--- a/web/documentation/external/sqlite.md
+++ b/web/documentation/external/sqlite/sqlite.md
@@ -18,7 +18,7 @@ tags:
 
 - CMake option: FUN_WITH_SQLITE=ON
 - Purpose: Access SQLite databases via the native C API.
-- Homepage: https://www.sqlite.org/
+- Homepage: [https://www.sqlite.org/](https://www.sqlite.org/){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/external/xml2.md b/web/documentation/external/xml2/xml2.md
similarity index 92%
rename from web/documentation/external/xml2.md
rename to web/documentation/external/xml2/xml2.md
index 794d12b..0d3c695 100644
--- a/web/documentation/external/xml2.md
+++ b/web/documentation/external/xml2/xml2.md
@@ -19,7 +19,7 @@ tags:
 
 - CMake option: FUN_WITH_XML2=ON
 - Purpose: Minimal XML parsing helpers using libxml2.
-- Homepage: http://xmlsoft.org/
+- Homepage: [http://xmlsoft.org/](http://xmlsoft.org/){:class="ext"}
 
 ## Opcodes:
 
diff --git a/web/documentation/faq.md b/web/documentation/faq/faq.md
similarity index 74%
rename from web/documentation/faq.md
rename to web/documentation/faq/faq.md
index 7d42bf5..1a60f70 100644
--- a/web/documentation/faq.md
+++ b/web/documentation/faq/faq.md
@@ -25,20 +25,20 @@ Answers to common questions.
 Set `FUN_LIB_DIR` to the repository's `./lib` directory when running without installation:
 <pre>FUN_LIB_DIR=./lib ./build/fun examples/hello.fun
 </pre>
-See [includes/](../includes/).
+See [../includes/](../includes/).
 
 ## How do I start the REPL?
 
-Run `fun -i` (or run `fun` without a script, depending on version). See [repl/](../repl/).
+Run `fun -i` (or run `fun` without a script, depending on version). See [../repl/](../repl/).
 
 ## Which build target should I use?
 
-Use the aggregate `build` target to build `fun`, `fun_test`, and `test_opcodes`. See [build/](../build/).
+Use the aggregate `build` target to build `fun`, `fun_test`, and `test_opcodes`. See [../build/](../build/).
 
 ## Where are the standard libraries?
 
-Under [https://git.xw3.org/fun/fun/src/branch/main/lib](https://git.xw3.org/fun/fun/src/branch/main/lib){:class="git"}. See [stdlib/](../stdlib/) for an overview.
+Under [https://git.xw3.org/fun/fun/src/branch/main/lib](https://git.xw3.org/fun/fun/src/branch/main/lib){:class="git"}. See [../stdlib/](../stdlib/) for an overview.
 
 ## Where can I find internals and opcodes?
 
-Browse [https://git.xw3.org/fun/fun/src/branch/main/src/vm](https://git.xw3.org/fun/fun/src/branch/main/src/vm/) and [internals/](../internals/) / [opcodes/](../opcodes/).
+Browse [https://git.xw3.org/fun/fun/src/branch/main/src/vm](https://git.xw3.org/fun/fun/src/branch/main/src/vm/) and [../internals/](../internals/) / [../opcodes/](../opcodes/).
diff --git a/web/documentation/fun.md b/web/documentation/fun/fun.md
similarity index 80%
rename from web/documentation/fun.md
rename to web/documentation/fun/fun.md
index 45642db..47302c4 100644
--- a/web/documentation/fun.md
+++ b/web/documentation/fun/fun.md
@@ -4,7 +4,7 @@ published: true
 noToc: false
 noComments: false
 noDate: false
-title: Fun - Fun executable: full usage guide
+title: Fun - Fun executable, full usage guide
 subtitle: Full usage guide for the `fun` executable, invocation patterns, REPL, env vars, include paths, examples, and install locations.
 description: Full usage guide for the `fun` executable, invocation patterns, REPL, env vars, include paths, examples, and install locations.
 permalink: /documentation/fun/
@@ -23,13 +23,13 @@ tags:
 - vars
 ---
 
-
 This document explains how to use the `fun` binary after building or installing it: invocation patterns, options, environment variables, include/search paths, REPL, and examples.
 
 ## Synopsis
-<pre>fun [options] [<script.fun>] [-- args...]
-</pre>
-- If `<script.fun>` is provided, `fun` runs the script.
+
+<pre>fun [options] [script.fun] [-- args...]</pre>
+- 
+- If [script.fun] is provided, `fun` runs the script.
 - If omitted and the build enables the REPL, `fun` starts an interactive session.
 
 ## Options
@@ -64,15 +64,17 @@ Useful commands/patterns in REPL:
 
 ## Running scripts
 Basic run (installed system‑wide):
-<pre>fun /usr/share/fun/examples/hello.fun
-</pre>
+<pre>fun /usr/share/fun/examples/hello.fun</pre>
+
 Running from a build tree (not installed):
-<pre>FUN_LIB_DIR=./lib /path/to/build_dir/fun examples/hello.fun
-</pre>
+
+<pre>FUN_LIB_DIR=./lib /path/to/build_dir/fun examples/hello.fun</pre>
+
 Passing arguments to scripts (arguments after `--` are forwarded to the script environment):
-<pre>fun myscript.fun -- arg1 arg2
-</pre>
+<pre>fun myscript.fun -- arg1 arg2</pre>
+
 ## Build and install locations
+
 - Build targets: `fun` is produced by the `fun` target. In CLion/CMake, typical build directories are `build_debug` or `build_release`.
 - Install locations (by default):
   - Binary: `/usr/bin/fun`
@@ -80,11 +82,12 @@ Passing arguments to scripts (arguments after `--` are forwarded to the script e
   - Examples (optional): `/usr/share/fun/examples`
 
 To stage an install without touching the system:
-<pre>DESTDIR=./tmp/stage cmake --build <build_dir> --target install
-./tmp/stage/usr/bin/fun ./examples/hello.fun
-</pre>
+
+<pre>DESTDIR=./tmp/stage cmake --build [build_dir] --target install
+./tmp/stage/usr/bin/fun ./examples/hello.fun</pre>
+
 ## See also
-- `documentation/cli.md` — concise CLI reference (synopsis/options/exit codes)
-- `documentation/funstx.md` — syntax checker for `.fun` files with optional `--fix`
-- `documentation/examples.md` — how to run the bundled examples
-- `documentation/includes.md` — include paths, namespacing, and `FUN_LIB_DIR`
+- [../cli/](../cli/) — concise CLI reference (synopsis/options/exit codes)
+- [../funstx/](../funstx/) — syntax checker for `.fun` files with optional `--fix`
+- [../examples/](../examples/) — how to run the bundled examples
+- [../includes/](../includes) — include paths, namespacing, and `FUN_LIB_DIR`
diff --git a/web/documentation/funstx.md b/web/documentation/funstx/funstx.md
similarity index 97%
rename from web/documentation/funstx.md
rename to web/documentation/funstx/funstx.md
index 4d29679..ca5b11a 100644
--- a/web/documentation/funstx.md
+++ b/web/documentation/funstx/funstx.md
@@ -24,10 +24,10 @@ tags:
 - syntax
 ---
 
-
 funstx is a small command‑line tool that parses .fun source files to verify syntax without executing them. It lives alongside the fun executable in the build directory and is installed by default.
 
 ## Features
+
 - Fast syntax checking for one or many .fun files
 - Non‑executing: only parses, never runs code
 - Clear error messages with file:line:col
@@ -36,12 +36,13 @@ funstx is a small command‑line tool that parses .fun source files to verify sy
 
 ## Usage
 
-<pre>funstx [--fix] <file1.fun> [file2.fun ...]
-</pre>
+<pre>funstx [--fix] [file1.fun] [file2.fun ...]</pre>
+
 - Provide one or more .fun files to check.
 - Add `--fix` to attempt safe, automatic corrections before re‑checking.
 
 ### Examples
+
 - Check a single file:
   - `funstx examples/arrays.fun`
 - Check and auto‑fix a file:
@@ -50,37 +51,45 @@ funstx is a small command‑line tool that parses .fun source files to verify sy
   - `find examples -type f -name '*.fun' -print0 | xargs -0 -n 50 funstx --fix`
 
 ## Output
+
 - On success: prints `path/to/file.fun: OK`
 - On failure: prints `path/to/file.fun:line:col: syntax error: <message>`
 
 ## Exit codes
+
 - `0`: All provided files parsed successfully
 - `1`: At least one file failed to parse (after optional fixing)
 - `2`: Incorrect usage (e.g., no files provided)
 
 ## What `--fix` does
+
 The fixer makes conservative, idempotent edits that align files with parser expectations. It only writes changes if the fixed version parses successfully.
 
-Applied rules:
+### Applied rules:
+
 - Normalize line endings: CRLF/CR → LF
 - Convert leading tabs to spaces; normalize indentation to multiples of two spaces
 - Trim trailing spaces
 - Ensure the file ends with a single newline
 - Normalize type aliases: `sint8|sint16|sint32|sint64` → `int8|int16|int32|int64` (word‑boundary aware)
 
-Notes:
+### Notes:
+
 - Structural issues that require semantic changes aren’t auto‑fixed (e.g., exceeding global limits, missing required delimiters, incomplete statements).
 - If parsing still fails after fixing, the original file is left unchanged and an error is reported.
 
 ## Build and install
+
 - Built as a regular CMake executable target `funstx` and placed in the same build directory as `fun` (e.g., `build_debug/` or `build_release/`).
 - Installed by default alongside `fun` into `/usr/bin` via `make install`/`cmake --build <build_dir> --target install`.
 
 ## Integration tips
+
 - Use `funstx --fix` in pre‑commit hooks or CI to enforce consistent formatting.
 - For quiet CI logs, capture stdout and only surface stderr on failure.
 - Combine with `find`/`xargs` to process large trees efficiently (see examples above).
 
 ## Limitations
+
 - Does not execute bytecode or validate runtime behavior.
 - The auto‑fixer focuses on formatting and a small set of safe token normalizations; it won’t rewrite program structure.
diff --git a/web/documentation/handbook.md b/web/documentation/handbook/handbook.md
similarity index 99%
rename from web/documentation/handbook.md
rename to web/documentation/handbook/handbook.md
index 4e44c8b..aa628e9 100644
--- a/web/documentation/handbook.md
+++ b/web/documentation/handbook/handbook.md
@@ -21,7 +21,6 @@ tags:
 - second
 ---
 
-
 This is a refreshed, de-duplicated, and fully up-to-date handbook for the Fun programming language and its virtual machine (VM). It keeps the same section layout as the original handbook while consolidating repeated content and documenting all currently available features, including the latest SQLite support.
 
 ## Overview
diff --git a/web/documentation/includes.md b/web/documentation/includes/includes.md
similarity index 98%
rename from web/documentation/includes.md
rename to web/documentation/includes/includes.md
index acd2c06..577d937 100644
--- a/web/documentation/includes.md
+++ b/web/documentation/includes/includes.md
@@ -20,7 +20,6 @@ tags:
 - variable
 ---
 
-
 This document explains how to use local and system includes in Fun source files and how `FUN_LIB_DIR` controls where system includes are resolved from. It also covers namespaced includes with `as`.
 
 ## Quick summary
@@ -46,8 +45,8 @@ greet("Fun")
 
 number a = 2
 number b = 3
-print("sum(" + to_string(a) + ", " + to_string(b) + ") = " + to_string(sum(a, b)))
-</pre>
+print("sum(" + to_string(a) + ", " + to_string(b) + ") = " + to_string(sum(a, b)))</pre>
+
 - Resolution rule: quoted includes are read directly from the given path relative to `$PWD`.
 - Typical use: including helper modules that live within your project tree.
 
@@ -65,8 +64,8 @@ hello_lib()
 number x = 10
 number y = 32
 print("add(" + to_string(x) + ", " + to_string(y) + ") = " + to_string(add(x, y)))
-print("times(" + to_string(x) + ", " + to_string(y) + ") = " + to_string(times(x, y)))
-</pre>
+print("times(" + to_string(x) + ", " + to_string(y) + ") = " + to_string(times(x, y)))</pre>
+
 Resolution order for `#include <...>`:
 
 1) `FUN_LIB_DIR` (environment variable), with automatic handling of trailing `/` or `\`
@@ -89,9 +88,10 @@ print("m.times(4, 5) = " + to_string(m.times(4, 5)))
 #include "examples/namespaced_mod.fun" as mod
 print(mod.hello("Fun"))
 g = mod.Greeter("Hi")
-g.say("World")
-</pre>
+g.say("World")</pre>
+
 Rules:
+
 - `as` must be followed by a valid identifier (letters, digits, underscore, starting with a letter or underscore).
 - Works for both local (`"..."`) and system (`<...>`) includes.
 
diff --git a/web/documentation/internals.md b/web/documentation/internals/internals.md
similarity index 99%
rename from web/documentation/internals.md
rename to web/documentation/internals/internals.md
index e96a5e7..3e5b970 100644
--- a/web/documentation/internals.md
+++ b/web/documentation/internals/internals.md
@@ -4,7 +4,7 @@ published: true
 noToc: false
 noComments: false
 noDate: false
-title: Fun - Fun Internals
+title: Fun - Internals
 subtitle: Implementation details, bytecode format, VM architecture, stacks/frames, parser, and dispatch.
 description: Implementation details, bytecode format, VM architecture, stacks/frames, parser, and dispatch.
 permalink: /documentation/internals/
@@ -22,7 +22,6 @@ tags:
 - stacks
 ---
 
-
 This document describes how Fun is implemented under the hood: the bytecode format, the virtual machine (VM) execution model, how opcodes are organized, error handling and debugging, and how the parser translates source code into bytecode.
 
 It complements the Handbook and Spec by focusing on implementation details in the C core, with pointers to the relevant source files.
@@ -49,20 +48,24 @@ Almost all operations are implemented as small, focused opcode handlers. The VM
 ## Values, bytecode, and instructions
 
 Relevant headers:
+
 - src/value.h — the tagged value type used by the VM (ints, floats, strings, arrays, maps, nil, booleans, etc.).
 - src/bytecode.h — the instruction set and bytecode container types.
 
 Instruction set:
+
 - enum OpCode defines all opcodes (OP_NOP, OP_LOAD_CONST, OP_ADD, …). See src/bytecode.h.
 - Instruction is a pair { OpCode op; int32_t operand; }.
   - Some opcodes encode immediate arguments in operand (e.g., local slot index, constant index, jump target, arg count).
 
 Bytecode container (Bytecode):
+
 - instructions: dynamic array of Instruction
 - constants: dynamic array of Value copies (literals, strings, numbers, etc.)
 - debug metadata: name (function or module), source_file (for error mapping)
 
 Utilities:
+
 - bytecode_add_constant, bytecode_add_instruction, bytecode_set_operand, bytecode_dump…
 
 ## VM structure and execution model
@@ -70,12 +73,14 @@ Utilities:
 See src/vm.h for the main VM and Frame shapes.
 
 Frame:
+
 - fn: pointer to the current Bytecode (function or module entry)
 - ip: instruction pointer (index into instructions)
 - locals[MAX_FRAME_LOCALS]: local slots for this frame
 - try_stack[16], try_sp: per‑frame exception handler stack (see exceptions section)
 
 VM:
+
 - stack[STACK_SIZE], sp: data stack and stack pointer
 - frames[MAX_FRAMES], fp: call frame stack and frame pointer
 - globals[MAX_GLOBALS]: global slots
@@ -87,6 +92,7 @@ VM:
 - debugger state (step/next/finish, breakpoints)
 
 Initialization and lifecycle:
+
 - vm_init(VM*): zeroes state and prepares stacks
 - vm_reset(VM*): frees/clears dynamic state while keeping the VM instance
 - vm_free(VM*): tear‑down helper
@@ -95,30 +101,36 @@ Initialization and lifecycle:
 ## The interpreter loop and opcode dispatch
 
 The interpreter loop lives in src/vm.c: vm_run. Opcodes are executed in a tight loop that:
+
 - Fetches the current instruction (op, operand) from the active frame (frames[fp])
 - Optionally updates debug/tracing state (e.g., OP_LINE updates VM.current_line)
 - Executes the handler for the opcode
 - Advances ip, or jumps/returns/halts as needed
 
 Opcode handlers organization:
+
 - To keep vm.c readable, most opcode implementations are factored into small .c files included directly into vm.c (e.g., vm/core/load_const.c, vm/logic/and.c, vm/arrays/push.c, vm/math/abs.c, vm/os/thread_spawn.c, etc.).
 - This is a deliberate “amalgamation” style: small single-purpose C units compiled as part of vm.c.
 - Optional subsystems (JSON, PCRE2, CURL, SQLite, libSQL, PC/SC, XML2, Tcl/Tk, Notcurses, INI, OpenSSL/LibreSSL crypto helpers, sockets, serial, OS helpers) are grouped under src/external and src/vm/<domain>/.
 
 Dispatch naming and visibility:
+
 - Human-readable names for opcodes live in vm.h: opcode_names[]. These are used in debug prints and error messages.
 
 ## Stacks, frames, locals, globals
 
 Data stack:
+
 - push_value/pop_value manage stack items of type Value.
 - Most opcodes pop their arguments (right‑to‑left) and push a result.
 
 Call frames:
+
 - vm_push_frame sets up a new frame for a function call (OP_CALL), transferring arguments into the callee’s local slots per the calling convention implemented by the compiler.
 - vm_pop_frame unwinds one frame, restoring caller context and optionally leaving a return value on the data stack.
 
 Locals and globals:
+
 - OP_LOAD_LOCAL/STORE_LOCAL address MAX_FRAME_LOCALS slots in the current frame.
 - OP_LOAD_GLOBAL/STORE_GLOBAL access the VM‑wide globals table.
 
@@ -147,18 +159,22 @@ Each handler enforces argument types and returns clear error messages via vm_rai
 ## Source lines, tracing, and error reporting
 
 Source line tracking:
+
 - The compiler emits OP_LINE markers carrying 1‑based source line numbers. vm_run updates VM.current_line when these execute.
 
 Tracing:
+
 - When VM.trace_enabled is set, vm_run prints each opcode and stack state. This is helpful for debugging compiled programs.
 
 Enhanced error messages:
+
 - vm.c wraps fprintf for stderr to append context: source file, line, function name, opcode, and ip of the last executed instruction.
 - For sources expanded via include preprocessing, vm.c maps the line back to the included file using preprocess_includes and inline markers (see below).
 
 ## Exceptions: try/catch/finally
 
 Minimal structured exceptions are implemented with three opcodes and a per‑frame try stack:
+
 - OP_TRY_PUSH operand = handler ip; pushes a handler location to Frame.try_stack
 - OP_TRY_POP pops the current handler
 - OP_THROW pops an error value; if a handler exists in the current frame, control jumps to it with the error value available on the stack; otherwise, vm_raise_error terminates execution (or triggers REPL if configured)
@@ -168,10 +184,12 @@ This design keeps exception metadata strictly per frame and avoids VM‑global u
 ## REPL‑on‑error and debugger
 
 Runtime error path:
+
 - vm_raise_error consults the current frame’s try handlers. If none match, it formats a message with location, prints it, and sets exit_code.
 - If VM.repl_on_error is enabled and a REPL hook is installed, the VM drops into the REPL to inspect state.
 
 Debugger state (vm.h):
+
 - Step/Next/Finish modes, breakpoints stored in VM.breakpoints[].
 - vm_debug_* helpers manage breakpoints and stepping requests. vm_run consults this state at loop boundaries to pause execution.
 
@@ -204,24 +222,30 @@ Key components:
   - emit_expression: entry point that threads all the above
 
 - Statement and block parsing:
+- 
   - read_line_start and skip_to_eol implement indentation and line/whitespace/comment handling (Fun uses indentation‑based blocks).
   - parse_simple_statement emits bytecode for assignments, declarations, expression statements, control flow (if/elif/else, while/for), returns, breaks/continues, try/catch/finally constructs, print/echo, etc.
   - parse_block handles nested blocks, indentation tracking, and emits OP_LINE markers for accurate source positioning.
 
 - Control‑flow codegen:
+- 
   - Conditional and loop constructs emit OP_JUMP/OP_JUMP_IF_FALSE with forward jump placeholders patched later via bytecode_set_operand.
   - try/catch/finally: emit OP_TRY_PUSH/OP_TRY_POP and arrange handler ips; OP_THROW for explicit throw.
 
 - Functions and calls:
+- 
   - Functions compile to their own Bytecode with a fresh LocalEnv; callers use OP_CALL with operand = arg count. Arguments are pushed left‑to‑right; the callee consumes them from the stack into local slots as per the compiler’s calling convention.
 
 - Constants and literals:
+- 
   - String/number/boolean/nil literals are interned into the Bytecode.constants table. OP_LOAD_CONST references them by index.
 
 - Line information and files:
+- 
   - The parser emits OP_LINE as it advances through source lines. Bytecode.source_file is set so the VM can report accurate errors.
 
 Front‑end entry points:
+
 - parse_string_to_bytecode(const char* source)
 - parse_file_to_bytecode(const char* path)
 - compile_minimal for very small snippets/tests
@@ -240,6 +264,7 @@ The VM includes small, standalone C files for each feature group under src/vm/
 - External integrations: src/external/*.c glue with opcode handlers in src/vm/<domain> when enabled by CMake options
 
 Feature flags (CMake):
+
 - Many subsystems are guarded by -DFUN_WITH_… options (JSON, PCRE2, CURL, PCSC, SQLITE, LIBSQL, XML2, TCLTK, NOTCURSES, INI, REPL). See CMake options in the Handbook.
 
 ## Debugging and development tips
@@ -256,6 +281,7 @@ Feature flags (CMake):
 ## Data limits and sizes
 
 From vm.h defaults (tuned for simplicity; adjust if needed):
+
 - STACK_SIZE = 1024
 - MAX_FRAMES = 128
 - MAX_FRAME_LOCALS = 64
@@ -360,8 +386,8 @@ void fun_shared_buffer_release(fun_shared_buffer_t*);
 // Ports/channels for inter-VM comms
 fun_port_t* fun_port_create(fun_vm_t*);
 int fun_send(fun_port_t*, fun_value_t value);      // can carry a shared buffer handle
-int fun_recv(fun_port_t*, fun_value_t* out, uint64_t timeout_ms);
-</pre>
+int fun_recv(fun_port_t*, fun_value_t* out, uint64_t timeout_ms);</pre>
+
 #### Practical usage tips
 
 - Default to isolates + ports for logic; use `fun_shared_buffer` only for large payloads (images, tensors, blobs).
@@ -407,8 +433,8 @@ if (fun_recv(port, &v, 1000) == 0) {
   fun_shared_buffer_retain(r);
   …
   fun_shared_buffer_release(r);
-}
-</pre>
+}</pre>
+
 #### When would the host ever sync?
 
 - Only if you choose shared mutability outside the VM (e.g., a lock‑free ring buffer you manage). For that, we expose optional helpers (`fun_atomic_*`, `fun_mutex_t`, `fun_rwlock_t`), but they’re not required for the standard zero‑copy path.
@@ -494,8 +520,7 @@ int fun_deserialize(fun_vm_t*, const fun_buffer_t*, fun_value_t* out);
 fun_shared_buffer_t* fun_shared_buffer_new(size_t n);
 void* fun_shared_buffer_data(fun_shared_buffer_t*);
 void fun_shared_buffer_retain(fun_shared_buffer_t*);
-void fun_shared_buffer_release(fun_shared_buffer_t*);
-</pre>
+void fun_shared_buffer_release(fun_shared_buffer_t*);</pre>
 ### Glossary
 
 - GC: garbage collection. In our context, each `fun_vm_t` isolate has its own GC (stop‑the‑world, per‑VM). There is no global stop‑the‑world and no global lock; a GC pause in one VM does not affect others.
diff --git a/web/documentation/maps.md b/web/documentation/maps/maps.md
similarity index 90%
rename from web/documentation/maps.md
rename to web/documentation/maps/maps.md
index 6d9c16f..01abce3 100644
--- a/web/documentation/maps.md
+++ b/web/documentation/maps/maps.md
@@ -20,7 +20,6 @@ tags:
 - update
 ---
 
-
 This guide focuses on maps: creation, reading/writing by key, checking key presence, iterating keys/values, nesting, and common gotchas. It complements the quick overview in types.md with a deeper, example‑driven treatment.
 
 ## What is a map?
@@ -37,8 +36,8 @@ This guide focuses on maps: creation, reading/writing by key, checking key prese
 user = { "name": "Ada", "age": 37 }
 empty = {}
 
-print(typeof(user))     // "map"
-</pre>
+print(typeof(user))     // "map"</pre>
+
 Nested structures are natural and common:
 
 <pre>book = {
@@ -46,8 +45,8 @@ Nested structures are natural and common:
   "meta": { "pages": 120, "isbn": "123-456" },
   "tags": ["lang", "vm"]
 }
-print(book["meta"]["pages"])   // 120
-</pre>
+print(book["meta"]["pages"])   // 120</pre>
+
 ## Getting and setting by key
 
 <pre>profile = { "name": "Lin" }
@@ -61,15 +60,16 @@ print(profile["email"])      // nil
 // write / overwrite
 profile["email"] = "lin@example.org"
 profile["name"]  = "Linus"
-print(profile)                 // {"name":"Linus","email":"lin@example.org"}
-</pre>
+print(profile)                 // {"name":"Linus","email":"lin@example.org"}</pre>
+
 Notes:
+
 - Using a non‑string key is allowed only if your build/runtime supports it; most code uses string keys for portability.
 - Missing keys produce nil. Compare against nil before converting or indexing:
 
 <pre>v = profile["phone"]
-if v == nil { print("no phone on file") }
-</pre>
+if v == nil { print("no phone on file") }</pre>
+
 ## Checking key existence
 
 Use has(m, key) to check if a key is present (returns 1 or 0):
@@ -78,8 +78,8 @@ Use has(m, key) to check if a key is present (returns 1 or 0):
 print(has(cfg, "debug"))   // 1
 print(has(cfg, "port"))    // 0
 
-if has(cfg, "port") { print(cfg["port"]) } else { print("using default port") }
-</pre>
+if has(cfg, "port") { print(cfg["port"]) } else { print("using default port") }</pre>
+
 ## Iterating maps
 
 Maps are not inherently ordered. To iterate, first obtain an array of keys or values.
@@ -102,8 +102,8 @@ for i = 0; i < len(ks); i = i + 1 {
 
 // values only
 vs = values(user)         // -> ["Ada", 38]
-for i = 0; i < len(vs); i = i + 1 { print(to_string(vs[i])) }
-</pre>
+for i = 0; i < len(vs); i = i + 1 { print(to_string(vs[i])) }</pre>
+
 Tip:
 - If you need deterministic output, either define the order array explicitly or sort the result of keys(user) using your available utilities before looping.
 
@@ -124,15 +124,15 @@ for i = 0; i < len(ks); i = i + 1 { k = ks[i]; dst[k] = src[k] }
 
 dst["x"] = 7
 print(src["x"])     // 1
-print(dst["x"])     // 7
-</pre>
+print(dst["x"])     // 7</pre>
+
 Shallow copies duplicate only the top‑level mapping; nested arrays/maps inside are still shared unless you clone them manually.
 
 ## Equality
 
 <pre>print({"a":1,"b":2} == {"b":2,"a":1})  // true
-print({"a":1} == {"a":2})                // false
-</pre>
+print({"a":1} == {"a":2})                // false</pre>
+
 Map equality compares sets of keys and their corresponding values for equality (order does not matter).
 
 ## Common utilities
@@ -162,8 +162,8 @@ print(m["nums"])           // [1,2,3,4]
 
 // JSON interop is typically via lib/io/json.fun (if enabled in your build)
 #include <io/json.fun> as json    // adjust to your tree and build flags
-s = json.stringify({"ok":1})     // "{"ok":1}"
-</pre>
+s = json.stringify({"ok":1})     // "{"ok":1}"</pre>
+
 ## Error handling and edge cases
 
 - Accessing a missing key returns nil. Guard before arithmetic or nested indexing.
@@ -196,9 +196,9 @@ for i = 0; i < len(rows); i = i + 1 {
   r = rows[i]
   by_id[r["id"]] = r
 }
-print(by_id["u2"]["name"])  // Lin
-</pre>
+print(by_id["u2"]["name"])  // Lin</pre>
+
 ## See also
 
-- types.md — broader overview of core types with quick map examples.
-- examples/ — there are example scripts involving maps; try play.fun to explore.
+- [../types/](../types/) — broader overview of core types with quick map examples.
+- [../examples/](../examples/) — there are example scripts involving maps; try play.fun to explore.
diff --git a/web/documentation/numbers.md b/web/documentation/numbers/numbers.md
similarity index 87%
rename from web/documentation/numbers.md
rename to web/documentation/numbers/numbers.md
index ca69c85..98d3ca5 100644
--- a/web/documentation/numbers.md
+++ b/web/documentation/numbers/numbers.md
@@ -21,7 +21,6 @@ tags:
 - patterns
 ---
 
-
 This guide covers the numeric types in Fun, with a focus on the integer "number" type and the 64‑bit floating point "float" type. You’ll find creation, arithmetic, conversion, clamping, bitwise operations, and common patterns.
 
 ## TL;DR
@@ -41,8 +40,8 @@ This guide covers the numeric types in Fun, with a focus on the integer "number"
 <pre>an = 42            // number
 af = 3.14159       // float
 print(typeof(an))  // "number"
-print(typeof(af))  // "float"
-</pre>
+print(typeof(af))  // "float"</pre>
+
 ## Literals
 
 - Integer (number): 0, 1, -7, 120
@@ -50,8 +49,8 @@ print(typeof(af))  // "float"
 
 <pre>x = 10
 y = 2.5
-z = -3
-</pre>
+z = -3</pre>
+
 ## Arithmetic
 
 Basic arithmetic works as you’d expect:
@@ -61,19 +60,19 @@ b = 2
 print(a + b)   // 9
 print(a - b)   // 5
 print(a * b)   // 14
-print(a % b)   // 1 (modulo)
-</pre>
+print(a % b)   // 1 (modulo)</pre>
+
 Division and result type:
 
 <pre>// If you need a fractional result, ensure a float is involved
 print(7 / 2)                    // implementation may yield 3 or 3.5 depending on numeric rules
 print(cast(7, "float") / 2)    // 3.5 (recommended when you need fractions)
-print(7 / 2.0)                  // 3.5
-</pre>
+print(7 / 2.0)                  // 3.5</pre>
+
 Mixing numbers and floats promotes the operation to float semantics:
 
-<pre>print(2 + 0.5)   // 2.5
-</pre>
+<pre>print(2 + 0.5)   // 2.5</pre>
+
 ## Comparisons
 
 <pre>print(3 < 5)     // 1 (true)
@@ -82,15 +81,15 @@ print(3 != 4)    // 1
 
 // Be explicit when comparing ints vs floats if types matter
 print(1 == 1.0)              // may be true, but types differ
-print(cast(1.0, "number") == 1) // 1 (true) with explicit cast
-</pre>
+print(cast(1.0, "number") == 1) // 1 (true) with explicit cast</pre>
+
 ## Conversions and parsing
 
 <pre>n = to_number("123")        // 123 (number)
 f = cast(n, "float")        // 123.0 (float)
 n2 = cast(3.9, "number")    // 3 (truncation semantics)
-print(to_string(f))          // "123"
-</pre>
+print(to_string(f))          // "123"</pre>
+
 If parsing fails (e.g., to_number("abc")), expect a runtime error; guard accordingly.
 
 ## Clamping to fixed widths
@@ -102,8 +101,8 @@ u8  = uclamp(300, 8)   // 44
 u16 = uclamp(70000, 16)
 
 // Signed clamp to N bits
-s8  = sclamp(-130, 8)  // wraps into signed 8‑bit range
-</pre>
+s8  = sclamp(-130, 8)  // wraps into signed 8‑bit range</pre>
+
 Choose the bits according to the target field (8, 16, 32, 64). See your interop API docs for exact ranges.
 
 ## Bitwise operations (numbers)
@@ -118,16 +117,16 @@ print(a | b)  // 0b0111 -> 7
 print(a ^ b)  // 0b0101 -> 5
 print(~a)     // bitwise NOT (two’s complement rules)
 print(a << 1) // 12
-print(a >> 1) // 3
-</pre>
+print(a >> 1) // 3</pre>
+
 Note: Bitwise ops are defined for numbers, not floats. Cast floats to numbers first when needed.
 
 ## Common patterns
 
 Ensuring float math to avoid unintended truncation:
 
-<pre>avg = cast(sum, "float") / cast(count, "float")
-</pre>
+<pre>avg = cast(sum, "float") / cast(count, "float")</pre>
+
 Safe division with guard against zero:
 
 <pre>num = 10
@@ -136,8 +135,8 @@ if den == 0 {
   print("division by zero")
 } else {
   print(num / den)
-}
-</pre>
+}</pre>
+
 Parsing user input with fallback:
 
 <pre>raw = "not-a-number"
@@ -145,8 +144,8 @@ val = 0
 // simplistic guard pattern; adapt to your error handling style
 if find(raw, "0") >= 0 || find(raw, "1") >= 0 {  // crude pre-check
   val = to_number(raw)
-}
-</pre>
+}</pre>
+
 ## Gotchas
 
 - Integer division vs float division: promote to float when you need fractional results.
@@ -155,6 +154,6 @@ if find(raw, "0") >= 0 || find(raw, "1") >= 0 {  // crude pre-check
 
 ## See also
 
-- Core overview: [types.md](./types/)
-- Math helpers and advanced ops: check [math/opcodes](./opcodes/) and the vm/math sources for available functions.
-- Strings: [strings.md](./strings/)
+- Core overview: [../types/](../types/)
+- Math helpers and advanced ops: check [../opcodes/](../opcodes/) and the vm/math sources for available functions.
+- Strings: [../strings/](../strings/)
diff --git a/web/documentation/opcodes.md b/web/documentation/opcodes/opcodes.md
similarity index 99%
rename from web/documentation/opcodes.md
rename to web/documentation/opcodes/opcodes.md
index b1516ec..d42d293 100644
--- a/web/documentation/opcodes.md
+++ b/web/documentation/opcodes/opcodes.md
@@ -19,7 +19,6 @@ tags:
 - stack
 ---
 
-
 This document provides an overview of the available VM opcodes implemented under src/vm and its subdirectories. Opcodes are grouped by module. For each opcode, we briefly note its purpose and, where available, the expected stack arguments and return value.
 
 ## Notes
diff --git a/web/documentation/performance.md b/web/documentation/performance/performance.md
similarity index 99%
rename from web/documentation/performance.md
rename to web/documentation/performance/performance.md
index 82ccd36..fff9d53 100644
--- a/web/documentation/performance.md
+++ b/web/documentation/performance/performance.md
@@ -19,23 +19,26 @@ tags:
 - tuning
 ---
 
-
 Tips for getting good performance from Fun programs and builds.
 
 ## Build configuration
+
 - Use `-DCMAKE_BUILD_TYPE=Release` for production binaries.
 - Consider `FUN_DEBUG=OFF` to remove extra checks in hot paths.
 - `FUN_USE_MUSL=ON` can help with static/portable builds; measure performance for your use case.
 
 ## Language-level tips
+
 - Prefer pre-sized arrays/maps when possible to reduce reallocations.
 - Avoid unnecessary string concatenations in loops; accumulate in arrays and `join`.
 - Push work to native ops where available (e.g., regex, JSON, math helpers).
 
 ## Algorithmic choices
+
 - Choose appropriate data structures (arrays for ordered scans, maps for key lookups).
 - Cache repeated computations or lookups when safe.
 
 ## Measuring
+
 - Create small, representative benchmarks.
 - Compare Debug vs. Release to ensure changes are meaningful.
diff --git a/web/documentation/repl.md b/web/documentation/repl/repl.md
similarity index 93%
rename from web/documentation/repl.md
rename to web/documentation/repl/repl.md
index 04cd4fb..aedb1bf 100644
--- a/web/documentation/repl.md
+++ b/web/documentation/repl/repl.md
@@ -4,7 +4,7 @@ published: true
 noToc: false
 noComments: false
 noDate: false
-title: Fun - Fun REPL Guide
+title: Fun - REPL Guide
 subtitle: REPL guide, how to build/launch, editing and history, completions, REPL-on-error, and tips.
 description: REPL guide, how to build/launch, editing and history, completions, REPL-on-error, and tips.
 permalink: /documentation/repl/
@@ -19,7 +19,6 @@ tags:
 - tips
 ---
 
-
 This document describes the interactive Read–Eval–Print Loop (REPL) for the Fun programming language: how to build/launch it, how input and execution work, line editing and completion, the REPL buffer workflow, commands, debugging helpers, and tips.
 
 The REPL is optional at build time. It provides a fast feedback loop for experimenting with Fun code, inspecting VM state, and debugging scripts interactively.
@@ -31,39 +30,39 @@ The REPL is optional at build time. It provides a fast feedback loop for experim
 
 <pre>cmake -S . -B build \
   -DFUN_WITH_REPL=ON
-cmake --build build --target fun
-</pre>
+cmake --build build --target fun</pre>
+
 You can also set a default search path for the bundled stdlib using DEFAULT_LIB_DIR at configure time (used for completions and library loading):
 
-<pre>cmake -S . -B build -DFUN_WITH_REPL=ON -DDEFAULT_LIB_DIR="/usr/share/fun/lib"
-</pre>
+<pre>cmake -S . -B build -DFUN_WITH_REPL=ON -DDEFAULT_LIB_DIR="/usr/share/fun/lib"</pre>
+
 ## Launching the REPL
 
 - Directly run the main executable (ensure FUN_WITH_REPL=ON):
 
-<pre>FUN_LIB_DIR="$(pwd)/lib" ./build/fun
-</pre>
+<pre>FUN_LIB_DIR="$(pwd)/lib" ./build/fun</pre>
+
 - With the CMake “repl” convenience target (available only if built with FUN_WITH_REPL=ON):
 
-<pre>cmake --build build --target repl
-</pre>
+<pre>cmake --build build --target repl</pre>
+
 On startup, you should see something like:
 
 <pre>Fun X.Y.Z REPL
-Type :help for commands. Submit an empty line to run.
-</pre>
+Type :help for commands. Submit an empty line to run.</pre>
+
 Environment variable FUN_LIB_DIR can be used to point the REPL to the standard library directory for symbol completion and library loading. If not set, a compile-time DEFAULT_LIB_DIR (if provided) or "lib" is used.
 
 ## Running scripts and REPL-on-error
 
 - Run a script file normally:
 
-<pre>FUN_LIB_DIR="$(pwd)/lib" ./build/fun ./demo.fun
-</pre>
+<pre>FUN_LIB_DIR="$(pwd)/lib" ./build/fun ./demo.fun</pre>
+
 - Enable tracing, and drop into a REPL automatically when a runtime error occurs:
 
-<pre>FUN_LIB_DIR="$(pwd)/lib" ./build/fun --repl-on-error --trace ./demo.fun
-</pre>
+<pre>FUN_LIB_DIR="$(pwd)/lib" ./build/fun --repl-on-error --trace ./demo.fun</pre>
+
 Inside REPL-on-error, you can inspect frames, locals, disassembly, set breakpoints, and continue or step. Use :help to see available commands.
 
 ## Prompts and input model
@@ -75,6 +74,7 @@ Inside REPL-on-error, you can inspect frames, locals, disassembly, set breakpoin
 - Execution trigger: submit an empty line (press Enter on a blank line). The REPL parses the current buffer and executes it if complete; otherwise it will tell you the input looks incomplete and keep the buffer.
 
 Notes on completeness detection:
+
 - The REPL considers code incomplete if there are unbalanced blocks or the last significant line ends with an operator/comma.
 - If incomplete, it prints a hint like “(incomplete, open block indent +N)” or “(incomplete, continue typing)”.
 
@@ -243,5 +243,5 @@ Program output produced by VM execution is collected and then printed after each
 
 ## See also
 
-- documentation/handbook.md — full language and VM handbook, including build options and ecosystem overview.
-- examples/error/repl_on_error.fun — example showing the REPL-on-error workflow.
+- [../handbook/](../handbook/) — full language and VM handbook, including build options and ecosystem overview.
+- [https://git.xw3.org/fun/fun/src/branch/main/examples/error/repl_on_error.fun](https://git.xw3.org/fun/fun/src/branch/main/examples/error/repl_on_error.fun){:class="git"} — example showing the REPL-on-error workflow.
diff --git a/web/documentation/roadmap.md b/web/documentation/roadmap/roadmap.md
similarity index 58%
rename from web/documentation/roadmap.md
rename to web/documentation/roadmap/roadmap.md
index c621a3b..cc89162 100644
--- a/web/documentation/roadmap.md
+++ b/web/documentation/roadmap/roadmap.md
@@ -30,13 +30,13 @@ This page outlines high-level areas of focus and points to places where you can
 - Safety: clearer error messages, diagnostics, and sandboxing guidance
 
 ## Near-term
-- Expand CLI reference and examples ([cli.md](./cli/))
-- Improve testing docs and coverage ([writing-tests.md](./writing-tests/))
-- Fill gaps in stdlib documentation ([stdlib.md](./stdlib/))
+- Expand CLI reference and examples ([../cli/](../cli/))
+- Improve testing docs and coverage ([../writing-tests/](../writing-tests/))
+- Fill gaps in stdlib documentation ([../stdlib/](../stdlib/))
 
 ## Medium-term
-- Bytecode/reference updates as internals evolve ([bytecode-format.md](./bytecode-format/), [internals.md](./internals/))
-- Embedding guides and host API stability ([embedding.md](./embedding/), [rust.md](./rust/))
+- Bytecode/reference updates as internals evolve ([../bytecode-format/](../bytecode-format/), [../internals/](../internals/))
+- Embedding guides and host API stability ([../embedding/](../embedding/), [../rust/](../rust/))
 
 ## Contributing
-See [contributing.md](./contributing/) for how to propose and implement items. Track concrete tasks via repository issues and PRs.
+See [../contributing/](../contributing/) for how to propose and implement items. Track concrete tasks via repository issues and PRs.
diff --git a/web/documentation/rust.md b/web/documentation/rust/rust.md
similarity index 84%
rename from web/documentation/rust.md
rename to web/documentation/rust/rust.md
index 76c29a8..9ef016d 100644
--- a/web/documentation/rust.md
+++ b/web/documentation/rust/rust.md
@@ -21,7 +21,6 @@ tags:
 - writing
 ---
 
-
 This guide explains how to implement VM opcodes in Rust, wire them into the C VM, and use them from Fun scripts.
 
 It assumes you are comfortable with basic Rust and C and have a working Fun checkout.
@@ -65,9 +64,10 @@ Note: In CLion, prefer building with one of the provided CMake profiles (Debug/R
 
 ## Writing an opcode in Rust
 
-	The Rust side is a no_std static library exposing C ABI functions that the VM can call. See src/rust/src/lib.rs for examples already in the tree.
+The Rust side is a no_std static library exposing C ABI functions that the VM can call. See src/rust/src/lib.rs for examples already in the tree.
 
 Key points:
+
 - Use extern "C" and #[no_mangle] to fix the symbol name.
 - Take a raw pointer to the VM as *mut Vm; return i32 status (0 for success).
 - Interact with the VM stack via helper FFI functions declared as externs.
@@ -98,8 +98,8 @@ In src/rust/src/lib.rs:
  }
 
  #[panic_handler]
- fn panic(_info: &core::panic::PanicInfo) -> ! { loop {} }
-</pre>
+ fn panic(_info: &core::panic::PanicInfo) -> ! { loop {} }</pre>
+
 What this does:
 - Pops two 64-bit integers from the VM stack.
 - Pushes back their sum.
@@ -123,8 +123,8 @@ String demo wiring (already present): src/vm/rust/hello.c
    push_value(vm, make_nil());
 #endif
    break;
-}
-</pre>
+}</pre>
+
 For a stack-based math opcode (like fun_op_radd), you would declare and call the Rust function similarly:
 
 <pre>#ifdef FUN_WITH_RUST
@@ -139,8 +139,8 @@ case OP_RADD: {
    push_value(vm, make_nil()); // or follow your opcode’s error convention
 #endif
    break;
-}
-</pre>
+}</pre>
+
 Notes:
 
 - Follow the existing opcode conventions for your module (core, math, strings, etc.).
@@ -160,6 +160,7 @@ Run the example:
    build/fun examples/rust_hello.fun
 
 Expected output:
+
    Hello from Rust ops!
 
 If you build without Rust, calling rust_hello() raises a runtime error indicating that Rust integration is disabled.
@@ -205,17 +206,17 @@ The minimal helpers shown cover 64-bit integers and simple strings. Extending th
 
 Authoritative and practical resources on exposing Rust to C (FFI) and maintaining a C-compatible API:
 
-- Rustonomicon: FFI overview and best practices
-  https://doc.rust-lang.org/nomicon/ffi.html
-- Rustonomicon: Calling Rust code from C
-  https://doc.rust-lang.org/nomicon/ffi.html#calling-rust-code-from-c
-- The Rust Book: Unsafe and FFI (extern, #[no_mangle], calling Rust from other languages)
-  https://doc.rust-lang.org/book/ch19-01-unsafe-rust.html#calling-rust-functions-from-other-languages
-- Rust Reference: extern blocks, ABIs, and linkage
-  https://doc.rust-lang.org/reference/items/external-blocks.html
-- Rust FFI Omnibus (examples for many patterns, including Rust ↔ C)
-  https://github.com/shepmaster/rust-ffi-omnibus
-- cbindgen (generate C headers from Rust libraries)
-  https://cbindgen.github.io/cbindgen/
-- bindgen (generate Rust bindings to existing C headers; useful when mixing C and Rust)
-  https://github.com/rust-lang/rust-bindgen
+- Rustonomicon: FFI overview and best practices<br>
+  [https://doc.rust-lang.org/nomicon/ffi.html](https://doc.rust-lang.org/nomicon/ffi.html){:class="ext"}
+- Rustonomicon: Calling Rust code from C<br>
+  [https://doc.rust-lang.org/nomicon/ffi.html#calling-rust-code-from-c](https://doc.rust-lang.org/nomicon/ffi.html#calling-rust-code-from-c){:class="ext"}
+- The Rust Book: Unsafe and FFI (extern, #[no_mangle], calling Rust from other languages)<br>
+  [https://doc.rust-lang.org/book/ch19-01-unsafe-rust.html#calling-rust-functions-from-other-languages](https://doc.rust-lang.org/book/ch19-01-unsafe-rust.html#calling-rust-functions-from-other-languages){:class="ext"}
+- Rust Reference: extern blocks, ABIs, and linkage<br>
+  [https://doc.rust-lang.org/reference/items/external-blocks.html](https://doc.rust-lang.org/reference/items/external-blocks.html){:class="ext"}
+- Rust FFI Omnibus (examples for many patterns, including Rust ↔ C)<br>
+  [https://github.com/shepmaster/rust-ffi-omnibus](https://github.com/shepmaster/rust-ffi-omnibus){:class="ext"}
+- cbindgen (generate C headers from Rust libraries)<br>
+  [https://cbindgen.github.io/cbindgen/](https://cbindgen.github.io/cbindgen/){:class="ext"}
+- bindgen (generate Rust bindings to existing C headers; useful when mixing C and Rust)<br>
+  [https://github.com/rust-lang/rust-bindgen](https://github.com/rust-lang/rust-bindgen){:class="ext"}
diff --git a/web/documentation/security-and-sandboxing.md b/web/documentation/security-and-sandboxing/security-and-sandboxing.md
similarity index 99%
rename from web/documentation/security-and-sandboxing.md
rename to web/documentation/security-and-sandboxing/security-and-sandboxing.md
index 7a0b8b5..f7e3e9c 100644
--- a/web/documentation/security-and-sandboxing.md
+++ b/web/documentation/security-and-sandboxing/security-and-sandboxing.md
@@ -19,19 +19,21 @@ tags:
 - trust
 ---
 
-
 Understand the trust boundaries and how to run Fun code safely.
 
 ## Trust model
+
 - By default, Fun code can access functionality exposed by the stdlib and any enabled extensions.
 - File and network access depend on available modules and host configuration.
 
 ## Running untrusted code
+
 - Prefer running in a container/VM with restricted filesystem and network.
 - Limit available stdlib/modules by controlling `FUN_LIB_DIR` contents.
 - Use OS-level sandboxing (seccomp, AppArmor, SELinux, chroot) where applicable.
 
 ## Best practices
+
 - Avoid running as root.
 - Validate and sanitize inputs at module boundaries.
 - Keep your build minimal; disable unneeded extensions at compile time.
diff --git a/web/documentation/stdlib.md b/web/documentation/stdlib/stdlib.md
similarity index 59%
rename from web/documentation/stdlib.md
rename to web/documentation/stdlib/stdlib.md
index 01117d7..ca356db 100644
--- a/web/documentation/stdlib.md
+++ b/web/documentation/stdlib/stdlib.md
@@ -20,12 +20,12 @@ tags:
 - under
 ---
 
-
-This page provides a quick orientation to the standard library located under [`./lib/`](../lib/).
+This page provides a quick orientation to the standard library located under [https://git.xw3.org/fun/fun/src/branch/main/lib](https://git.xw3.org/fun/fun/src/branch/main/lib){:class="git"}.
 
 The stdlib is written in Fun and organized by domain. Below is the current layout with brief notes. Refer to the source for full APIs and examples.
 
 ## Top-level modules
+
 - `arrays.fun` — helpers for working with array structures.
 - `cli.fun` — minimal helpers for building CLI tools.
 - `hello.fun` — simple demonstration helper(s).
@@ -35,17 +35,18 @@ The stdlib is written in Fun and organized by domain. Below is the current layou
 - `strings.fun` — string manipulation utilities.
 
 ## Packages
-- `crypt/` — cryptographic primitives and hashes. See [lib/crypt](../lib/crypt/).
+
+- `crypt/` — cryptographic primitives and hashes. See [https://git.xw3.org/fun/fun/src/branch/main/lib/crypt/](https://git.xw3.org/fun/fun/src/branch/main/lib/crypt/){:class="git"}.
   - `aes256.fun`
   - `crc32.fun`, `crc32c.fun`
   - `md5.fun`, `md5_legacy.fun`
   - `ripemd160.fun`, `ripemd160_new_try.fun`
   - `sha1.fun`, `sha256.fun`, `sha384.fun`, `sha512.fun`
 
-- `encoding/` — text/binary encodings and conversions. See [lib/encoding](../lib/encoding/).
+- `encoding/` — text/binary encodings and conversions. See [https://git.xw3.org/fun/fun/src/branch/main/lib/encoding/](https://git.xw3.org/fun/fun/src/branch/main/lib/encoding/){:class="git"}.
   - `base64.fun`
 
-- `io/` — input/output utilities and system interfaces. See [lib/io](../lib/io/).
+- `io/` — input/output utilities and system interfaces. See [https://git.xw3.org/fun/fun/src/branch/main/lib/io/](https://git.xw3.org/fun/fun/src/branch/main/lib/io/){:class="git"}.
   - `console.fun` — console I/O helpers
   - `ini.fun` — INI parse helpers
   - `json.fun` — JSON helpers
@@ -56,20 +57,16 @@ The stdlib is written in Fun and organized by domain. Below is the current layou
   - `thread.fun` — simple threading utilities
   - `xml.fun` — XML helpers
 
-- `net/` — networking helpers and example HTTP servers. See [lib/net](../lib/net/).
+- `net/` — networking helpers and example HTTP servers. See [https://git.xw3.org/fun/fun/src/branch/main/lib/net/](https://git.xw3.org/fun/fun/src/branch/main/lib/net/){:class="git"}.
   - `cgi.fun` — basic CGI helpers
   - `http_server.fun` — blocking HTTP server
   - `http_cgi_server.fun` — HTTP server that can execute .fun CGI files
   - `http_cgi_lib_server.fun` — variant of the HTTP CGI server using the stdlib
 
-- `regex/` — regular expression utilities (PCRE2-based when available). See [lib/regex](../lib/regex/).
+- `regex/` — regular expression utilities (PCRE2-based when available). See [https://git.xw3.org/fun/fun/src/branch/main/lib/regex/](https://git.xw3.org/fun/fun/src/branch/main/lib/regex/){:class="git"}.
   - `pcre2.fun`
 
-- `ui/` — user interface helpers (built if the corresponding extensions are enabled). See [lib/ui](../lib/ui/).
-  - `notcurses.fun`
-  - `tk.fun`
-
-- `utils/` — small reusable helpers and functional utilities. See [lib/utils](../lib/utils/).
+- `utils/` — small reusable helpers and functional utilities. See [https://git.xw3.org/fun/fun/src/branch/main/lib/utils/](https://git.xw3.org/fun/fun/src/branch/main/lib/utils/){:class="git"}.
   - `datetime.fun`
   - `match.fun`
   - `math.fun`
@@ -77,12 +74,13 @@ The stdlib is written in Fun and organized by domain. Below is the current layou
   - `range.fun`
   - `result.fun`
 
-Note: Availability of some modules can depend on optional extensions selected at build time (see [build.md](./build/)). For instance, `regex/pcre2.fun` requires PCRE2 support; `ui/*` depends on chosen UI backends.
+Note: Availability of some modules can depend on optional extensions selected at build time (see [../build/](../build/)). For instance, `regex/pcre2.fun` requires PCRE2 support; `ui/*` depends on chosen UI backends.
 
 ## Using modules
-<pre>#include <strings.fun>
 
-let s = trim("  hello  ")
-print(s)
-</pre>
-For search paths and namespacing details, see [includes.md](./includes/) and [cli.md](./cli/) (FUN_LIB_DIR and DEFAULT_LIB_DIR).
+<pre>#include &lt;strings.fun
+
+s = trim("  hello  ")
+print(s)</pre>
+
+For search paths and namespacing details, see [../includes/](../includes/) and [../cli/](../cli/) (FUN_LIB_DIR and DEFAULT_LIB_DIR).
diff --git a/web/documentation/strings.md b/web/documentation/strings/strings.md
similarity index 87%
rename from web/documentation/strings.md
rename to web/documentation/strings/strings.md
index 336a6bb..2da528d 100644
--- a/web/documentation/strings.md
+++ b/web/documentation/strings/strings.md
@@ -20,7 +20,6 @@ tags:
 - substr
 ---
 
-
 This guide covers string literals, common operations (length, concatenation, substring, search, split), and interop patterns. Strings in Fun are immutable sequences of bytes/text.
 
 ## TL;DR
@@ -37,9 +36,10 @@ This guide covers string literals, common operations (length, concatenation, sub
 s2 = "line1\nline2"   // newline
 s3 = "quote: \" and backslash: \\" // escaped quote and backslash
 
-print(s1)  // hello
-</pre>
+print(s1)  // hello</pre>
+
 Notes:
+
 - Strings are immutable; operations return new strings rather than modifying in place.
 - Use to_string(x) when concatenating non-string values.
 
@@ -49,22 +49,22 @@ Length and concatenation:
 
 <pre>name = "Ada"
 greet = "Hello, " + name + "!"    // "Hello, Ada!"
-print(len(greet))                   // 12
-</pre>
+print(len(greet))                   // 12</pre>
+
 Substring (start, length) and search:
 
 <pre>s = "hello, world"
 print(substr(s, 7, 5))   // world
 idx = find(s, ",")      // 5, or -1 if not found
-if idx >= 0 { print("comma at index " + to_string(idx)) }
-</pre>
+if idx >= 0 { print("comma at index " + to_string(idx)) }</pre>
+
 Splitting into arrays:
 
 <pre>parts = split("a,b,c", ",")  // ["a","b","c"]
 for i = 0; i < len(parts); i = i + 1 {
   print(parts[i])
-}
-</pre>
+}</pre>
+
 ## Conversions and formatting
 
 <pre>n = 42
@@ -73,8 +73,8 @@ msg = "n=" + to_string(n) + ", pi=" + to_string(pi)
 print(msg)
 
 // parsing (may error if the string is not numeric)
-n2 = to_number("123")    // 123
-</pre>
+n2 = to_number("123")    // 123</pre>
+
 If you need a specific type, you can use cast for advanced cases, e.g. cast("123", "number").
 
 ## Common patterns
@@ -87,20 +87,20 @@ if at >= 0 {
   user = substr(email, 0, at)
   host = substr(email, at + 1, len(email) - at - 1)
   print(user + " on " + host)
-}
-</pre>
+}</pre>
+
 - Building paths or messages:
 
 <pre>base = "/tmp"
 file = "log.txt"
-path = base + "/" + file
-</pre>
+path = base + "/" + file</pre>
+
 ## Gotchas
 
 - Strings are immutable: repeated concatenation in big loops can be costly; consider collecting pieces in an array and joining at the end if you have a helper for that in your setup.
-- len(s) counts bytes/code units; be mindful when working with multi-byte encodings.
+- len(s) counts bytes/code units; be mindful when working with multibyte encodings.
 
 ## See also
 
-- Core overview: [types.md](./types/)
-- Arrays guide (useful when splitting/collecting text): [arrays.md](./arrays/)
+- Core overview: [../types/](../types/)
+- Arrays guide (useful when splitting/collecting text): [../arrays/](../arrays/)
diff --git a/web/documentation/style-guide.md b/web/documentation/style-guide/style-guide.md
similarity index 99%
rename from web/documentation/style-guide.md
rename to web/documentation/style-guide/style-guide.md
index 4f3a247..61babbc 100644
--- a/web/documentation/style-guide.md
+++ b/web/documentation/style-guide/style-guide.md
@@ -18,7 +18,6 @@ tags:
 - style
 ---
 
-
 Conventions for writing C and Fun code in this repository.
 
 ## General principles
diff --git a/web/documentation/testing.md b/web/documentation/testing/testing.md
similarity index 94%
rename from web/documentation/testing.md
rename to web/documentation/testing/testing.md
index 8531e66..0060eb2 100644
--- a/web/documentation/testing.md
+++ b/web/documentation/testing/testing.md
@@ -23,7 +23,6 @@ tags:
 - where
 ---
 
-
 This page explains how to build and run Fun’s tests using the existing CMake targets. It also points to where opcode and language tests typically live and how to add new ones.
 
 ## Test-related targets
@@ -41,21 +40,21 @@ To list targets with CMake directly, consult your IDE or run the build system’
 
 Debug profile example:
 
-<pre>cmake --build build --target test_opcodes && ./build/test_opcodes
-</pre>
+<pre>cmake --build build --target test_opcodes && ./build/test_opcodes</pre>
+
 Release profile example:
 
-<pre>cmake --build build_release --target test_opcodes && ./build/test_opcodes
-</pre>
+<pre>cmake --build build_release --target test_opcodes && ./build/test_opcodes</pre>
+
 If `fun_test` exists in your configuration:
 
-<pre>cmake --build build --target fun_test && ./build/fun_test
-</pre>
+<pre>cmake --build build --target fun_test && ./build/fun_test</pre>
+
 You can also invoke CTest to run any tests registered with `add_test()`:
 
 <pre>cmake --build build --target test
-ctest --test-dir build -j
-</pre>
+ctest --test-dir build -j</pre>
+
 ## Adding new tests
 
 - C/C++/VM-side tests: look for existing tests under `src` or `spec` and mirror the structure. Add a new source and register it in CMake with an executable or via `add_test()`.
diff --git a/web/documentation/troubleshooting.md b/web/documentation/troubleshooting/troubleshooting.md
similarity index 93%
rename from web/documentation/troubleshooting.md
rename to web/documentation/troubleshooting/troubleshooting.md
index 030b8f1..665f81f 100644
--- a/web/documentation/troubleshooting.md
+++ b/web/documentation/troubleshooting/troubleshooting.md
@@ -19,28 +19,28 @@ tags:
 - troubleshooting
 ---
 
-
 This page lists common issues when building and running Fun from a source checkout and how to fix them quickly.
 
 ## Includes cannot be found
 
 Error example:
 
-<pre>Include error: cannot read '<io/console.fun>'
-</pre>
+<pre>Include error: cannot read '<io/console.fun>'</pre>
+
 Fix:
+
 - When running from the repository without installing, set `FUN_LIB_DIR` to the local `./lib` directory so angle‑bracket includes resolve correctly.
 
 Linux/macOS/BSD:
 
 <pre>export FUN_LIB_DIR="$(pwd)/lib"
-./build/fun examples/include_lib.fun
-</pre>
+./build/fun examples/include_lib.fun</pre>
+
 Windows (PowerShell):
 
 <pre>$env:FUN_LIB_DIR = "$PWD/lib"
-./build/fun.exe .\examples\include_lib.fun
-</pre>
+./build/fun.exe .\examples\include_lib.fun</pre>
+
 If `FUN_LIB_DIR` is not set, the interpreter tries a compile‑time `DEFAULT_LIB_DIR`, and finally falls back to `./lib` relative to the current working directory. Be mindful of where you run the `fun` binary from.
 
 See includes.md for more details.
@@ -48,6 +48,7 @@ See includes.md for more details.
 ## REPL does not start
 
 Symptoms:
+
 - Running the executable just exits, or `--repl-on-error` is not recognized.
 
 Fix:
@@ -55,8 +56,8 @@ Fix:
 
 <pre>cmake -S . -B build -DFUN_WITH_REPL=ON
 cmake --build build --target fun
-FUN_LIB_DIR="$(pwd)/lib" ./build/fun
-</pre>
+FUN_LIB_DIR="$(pwd)/lib" ./build/fun</pre>
+
 See repl.md for usage tips and features.
 
 ## Linker errors for optional libraries (JSON, PCRE2, CURL, SQLite, etc.)
diff --git a/web/documentation/types.md b/web/documentation/types/types.md
similarity index 89%
rename from web/documentation/types.md
rename to web/documentation/types/types.md
index 2503d44..f4722e4 100644
--- a/web/documentation/types.md
+++ b/web/documentation/types/types.md
@@ -27,15 +27,14 @@ tags:
 - types
 ---
 
-
 This guide shows how to create and use the most common Fun datatypes with practical examples. It focuses on arrays and maps, and also recaps numbers, floats, strings, booleans and nil so examples are self‑contained.
 
 See also:
 
-- [arrays](../arrays/) — Deeper dive into array creation, indexing/slicing, iteration, and helpers.
-- [strings](../strings/) — Practical guide to string literals, concatenation, substr/find, split, and conversions.
-- [maps](../maps/) — Detailed guide to map construction, lookup/update, merging, and patterns.
-- [numbers](../numbers/) — Numbers vs floats, arithmetic, conversions, clamping, bitwise ops, and common patterns.
+- [../arrays/](../arrays/) — Deeper dive into array creation, indexing/slicing, iteration, and helpers.
+- [../strings](../strings/) — Practical guide to string literals, concatenation, substr/find, split, and conversions.
+- [../maps/](../maps/) — Detailed guide to map construction, lookup/update, merging, and patterns.
+- [../numbers/](../numbers/) — Numbers vs floats, arithmetic, conversions, clamping, bitwise ops, and common patterns.
 
 ## Quick overview
 
@@ -94,9 +93,10 @@ for pair in it.enumerate(["x", "y"]) {
   idx = pair[0]
   val = pair[1]
   print(idx + ":" + val)
-}
-</pre>
+}</pre>
+
 Notes:
+
 - Indexing is bounds‑checked; invalid indices cause a runtime error that you can inspect with --trace or REPL‑on‑error.
 - Arrays are mutable; operations modify in place unless documented otherwise.
 
@@ -130,9 +130,10 @@ keys = ["name", "age", "lang"]
 for i = 0; i < len(keys); i = i + 1 {
   k = keys[i]
   print(k + " = " + to_string(user[k]))
-}
-</pre>
+}</pre>
+
 Notes:
+
 - Accessing a non‑existing key returns nil; write a guard before using it as another type.
 - Maps are mutable; assigning with map["k"] = v updates in place.
 
@@ -144,8 +145,8 @@ print(substr(s, 7, 5))     // world
 print(find(s, ","))       // 5 (index) or -1 if not found
 
 parts = split("a,b,c", ",")  // ["a","b","c"]
-print(join(parts, ";"))      // a;b;c
-</pre>
+print(join(parts, ";"))      // a;b;c</pre>
+
 ## Numbers and floats (brief)
 
 <pre>n = 10
@@ -154,8 +155,8 @@ print(n + 2)               // 12
 print(f * 2)               // 6.28
 
 // clamp to widths when needed
-print(uclamp(300, 8))      // 44 (300 mod 256)
-</pre>
+print(uclamp(300, 8))      // 44 (300 mod 256)</pre>
+
 ## Booleans and nil
 
 <pre>ok = 1        // true
@@ -163,16 +164,16 @@ no = 0        // false
 none = nil
 
 if ok && !no { print("yay") }
-if none == nil { print("is nil") }
-</pre>
+if none == nil { print("is nil") }</pre>
+
 ## Conversions and typing
 
 <pre>x = "42"
 print(to_number(x) + 1)    // 43
 
 print(typeof([1,2,3]))     // "array"
-print(typeof({}))          // "map"
-</pre>
+print(typeof({}))          // "map"</pre>
+
 ## Common patterns
 
 - Accumulate values:
diff --git a/web/documentation/vm.md b/web/documentation/vm/vm.md
similarity index 93%
rename from web/documentation/vm.md
rename to web/documentation/vm/vm.md
index 3ee75ab..acca941 100644
--- a/web/documentation/vm.md
+++ b/web/documentation/vm/vm.md
@@ -15,15 +15,13 @@ tags:
 - configuration
 ---
 
-# Virtual Machine (VM) Configuration Constants
-
 The Fun Virtual Machine (VM) uses several fixed-size limits to manage memory and execution. These constants are defined in `src/vm.h` and can be adjusted if necessary by re-compiling the project.
 
 This document explains what each of these constants does in plain English.
 
----
+View [../build/](../build/) to see how to set the params at build time.
 
-### `MAX_FRAMES` (Default: 128)
+## `MAX_FRAMES` (Default: 128)
 This constant defines the **maximum depth of the call stack**. 
 
 When a function is called, the VM creates a "frame" to keep track of that function's execution (where it's at in the code and its local variables). If a function calls another function, a new frame is added on top. 
@@ -31,7 +29,7 @@ When a function is called, the VM creates a "frame" to keep track of that functi
 - **What happens if you exceed it?** If you have too many nested function calls (for example, in a deep recursion that never ends), the VM will run out of space for new frames.
 - **Analogy:** Imagine a stack of dinner plates. `MAX_FRAMES` is the maximum height the stack can reach before it becomes unstable or hits the ceiling.
 
-### `MAX_FRAME_LOCALS` (Default: 64)
+## `MAX_FRAME_LOCALS` (Default: 64)
 This constant limits the **number of local variables** each individual function can have.
 
 Every time a function is called, it gets its own space for variables that only exist within that function. 
@@ -39,7 +37,7 @@ Every time a function is called, it gets its own space for variables that only e
 - **What happens if you exceed it?** A single function cannot define more than 64 local variables. If it tries to use more, the VM won't be able to store them in the frame.
 - **Analogy:** Think of this as the number of pockets in a single person's jacket. You can only carry 64 items in your pockets at once.
 
-### `MAX_GLOBALS` (Default: 128)
+## `MAX_GLOBALS` (Default: 128)
 This constant defines the **maximum number of global variables** available to the entire program.
 
 Global variables are accessible from anywhere in your code, unlike local variables which belong to a specific function.
@@ -47,7 +45,7 @@ Global variables are accessible from anywhere in your code, unlike local variabl
 - **What happens if you exceed it?** Your program cannot have more than 128 global variables defined at the same time.
 - **Analogy:** This is like a shared community bulletin board. There is only enough room on the board for 128 different notices.
 
-### `STACK_SIZE` (Default: 1024)
+## `STACK_SIZE` (Default: 1024)
 This constant sets the size of the **operand stack**.
 
 The VM uses this stack for almost everything it does: adding numbers, comparing values, and passing arguments to functions. Most operations take values from the top of the stack, perform a calculation, and push the result back onto the stack.
@@ -55,7 +53,7 @@ The VM uses this stack for almost everything it does: adding numbers, comparing
 - **What happens if you exceed it?** Complex calculations or passing a very large number of arguments might fill up this stack, leading to a "stack overflow."
 - **Analogy:** Imagine a workbench where you put tools and materials you are currently working on. `STACK_SIZE` is the area of that workbench. If it's too small, you can't work on complex projects.
 
-### `OUTPUT_SIZE` (Default: 1024)
+## `OUTPUT_SIZE` (Default: 1024)
 This constant determines the size of the **output buffer**.
 
 When your program uses commands like `PRINT` or `ECHO`, the results are stored in an internal list before they are displayed or processed further. 
diff --git a/web/documentation/website.md b/web/documentation/website/website.md
similarity index 93%
rename from web/documentation/website.md
rename to web/documentation/website/website.md
index 5c95058..828e0b6 100644
--- a/web/documentation/website.md
+++ b/web/documentation/website/website.md
@@ -18,12 +18,11 @@ tags:
 - xyz
 ---
 
-
-This document describes the structure and maintenance of the website for the Fun programming language, located in the `./web/` directory. The website is hosted at [https://fun-lang.xyz](https://fun-lang.xyz).
+This document describes the structure and maintenance of the website for the Fun programming language, located in the `./web/` directory of the source tree. The website is hosted at [https://fun-lang.xyz](https://fun-lang.xyz).
 
 ## Technology Stack
 
-The website is built using [Jekyll](https://jekyllrb.com/), a static site generator written in Ruby.
+The website is built using [Jekyll](https://jekyllrb.com/){:class="ext"}, a static site generator written in Ruby.
 
 - **Markdown Engine:** kramdown (configured for GFM)
 - **Syntax Highlighting:** Rouge
@@ -94,6 +93,6 @@ To run the website locally for development:
 The website can be deployed using the Makefile:
 
 <pre>cd web/
-make release
-</pre>
+make release</pre>
+
 The `release` target builds the site, minifies the assets, and syncs the files to [fun-lang.xyz](https://fun-lang.xyz) via `rsync`. Ensure you have the necessary SSH permissions for the sync to succeed.
diff --git a/web/documentation/writing-tests.md b/web/documentation/writing-tests/writing-tests.md
similarity index 99%
rename from web/documentation/writing-tests.md
rename to web/documentation/writing-tests/writing-tests.md
index f4a295c..f610f79 100644
--- a/web/documentation/writing-tests.md
+++ b/web/documentation/writing-tests/writing-tests.md
@@ -18,26 +18,29 @@ tags:
 - writing
 ---
 
-
 How to author tests for Fun and its opcode implementations.
 
 ## Test kinds
+
 - VM/opcode tests: exercise bytecode operations and VM behavior (target: `test_opcodes`).
 - Language/runtime tests: exercise user-visible features and stdlib behavior (target: `fun_test`).
 
 See `documentation/testing.md` for how to build and run these targets with CTest.
 
 ## Adding new tests
+
 The exact layout may evolve; generally:
 - Add new test sources alongside existing ones used by `fun_test`.
 - For opcode-focused tests, add cases where `test_opcodes` discovers them.
 
 Aim for:
+
 - Small, isolated test cases with clear assertions
 - One behavior per test; descriptive names
 - Minimal fixtures and setup
 
 ## Guidelines
+
 - Prefer black-box testing via public APIs.
 - When adding features, include both positive and negative cases.
 - Keep tests deterministic; avoid non-deterministic timers or random sources unless seeded.