Add clarity on some facts. (#29)

Author: sakrist

src/README.md

@@ -13,6 +13,14 @@ WebAssembly is described on its [home page](https://webassembly.org/) as:
 
 We use LLVM as a compiler backend to produce WebAssembly binaries. Our resulting binaries also depend on [WASI](https://wasi.dev), which is a modular system interface for WebAssembly. WASI is mainly required to compile Swift Standard Library.
 
+
+### Important note
+In 2024, Apple introduced [Swift Embedded](https://github.com/swiftlang/swift/blob/main/docs/EmbeddedSwift/UserManual.md). 
+While both projects benefit from each other, it is important to understand that they are different targets at the build phase, consequentially with different sets of abilities.
+Embedded Swift [very limited](https://github.com/swiftlang/swift/blob/main/docs/EmbeddedSwift/EmbeddedSwiftStatus.md#embedded-swift-language-features) but can produce small binaries. [Example](https://github.com/apple/swift-for-wasm-examples).
+
+
+
 ## Project Status
 
 [All compiler and standard library changes have been upstreamed to the official Swift repository, and the upstream CI is now testing WebAssembly targets.](https://forums.swift.org/t/stdlib-and-runtime-tests-for-wasm-wasi-now-available-on-swift-ci/70385)

src/SUMMARY.md

@@ -3,7 +3,7 @@
 - [Introduction](README.md)
 - [Getting Started](getting-started/index.md)
     - [Installation](getting-started/setup.md)
-    - [Porting code from other platforms](getting-started/porting.md)
+    - [Porting code](getting-started/porting.md)
     - [Creating a browser app](getting-started/browser-app.md)
     - [JavaScript interoperation](getting-started/javascript-interop.md)
     - [Concurrency](getting-started/concurrency.md)

src/examples/exporting-function.md

@@ -1,5 +1,28 @@
 # Exporting function for host environment
 
+## Swift 6.0 or later
+
+If you use Swift 6.0 or later, you can use `@_expose(wasm, "add")` and omit the `--export` linker flag.
+
+```swift
+// File name: lib.swift
+@_expose(wasm, "add")
+@_cdecl("add") // This is still required to call the function with C ABI
+func add(_ lhs: Int, _ rhs: Int) -> Int {
+    return lhs + rhs
+}
+```
+
+Then you can compile the Swift code with the following command without `--export` linker flag.
+
+```bash
+$ swiftc \
+    -target wasm32-unknown-wasi \
+    -parse-as-library \
+    lib.swift -o lib.wasm \
+    -Xclang-linker -mexec-model=reactor
+```
+
 ## Swift 5.10 or earlier
 
 You can expose a Swift function for host environment using special attribute and linker option.
@@ -62,25 +85,3 @@ console.log("2 + 3 = " + addFn(2, 3))
 
 If you use SwiftPM package, you can omit linker flag using clang's `__atribute__`. Please see [swiftwasm/JavaScriptKit#91](https://github.com/swiftwasm/JavaScriptKit/pull/91/files) for more detail info
 
-## Swift 6.0 or later
-
-If you use Swift 6.0 or later, you can use `@_expose(wasm, "add")` and omit the `--export` linker flag.
-
-```swift
-// File name: lib.swift
-@_expose(wasm, "add")
-@_cdecl("add") // This is still required to call the function with C ABI
-func add(_ lhs: Int, _ rhs: Int) -> Int {
-    return lhs + rhs
-}
-```
-
-Then you can compile the Swift code with the following command without `--export` linker flag.
-
-```bash
-$ swiftc \
-    -target wasm32-unknown-wasi \
-    -parse-as-library \
-    lib.swift -o lib.wasm \
-    -Xclang-linker -mexec-model=reactor
-```

src/examples/importing-function.md

@@ -1,5 +1,29 @@
 # Importing a function from host environments
 
+## Swift 6.0 or later
+
+If you are using Swift 6.0 or later, you can use experimental `@_extern(wasm)` attribute
+
+Swift 6.0 introduces a new attribute `@_extern(wasm)` to import a function from the host environment.
+To use this experimental feature, you need to enable it in your SwiftPM manifest file:
+
+```swift
+.executableTarget(
+    name: "Example",
+    swiftSettings: [
+        .enableExperimentalFeature("Extern")
+    ]),
+```
+
+Then, you can import a function from the host environment as follows without using C headers:
+
+```swift
+@_extern(wasm, module: "env", name: "add")
+func add(_ a: Int, _ b: Int) -> Int
+
+print(add(2, 2))
+```
+
 ## Swift 5.10 or earlier
 
 You can import a function from your host environment using the integration of Swift Package Manager
@@ -85,26 +109,3 @@ A more streamlined way to import host functions will be implemented in the futur
 SwiftWasm toolchain.
 
 
-## Swift 6.0 or later
-
-If you are using Swift 6.0 or later, you can use experimental `@_extern(wasm)` attribute
-
-Swift 6.0 introduces a new attribute `@_extern(wasm)` to import a function from the host environment.
-To use this experimental feature, you need to enable it in your SwiftPM manifest file:
-
-```swift
-.executableTarget(
-    name: "Example",
-    swiftSettings: [
-        .enableExperimentalFeature("Extern")
-    ]),
-```
-
-Then, you can import a function from the host environment as follows without using C headers:
-
-```swift
-@_extern(wasm, module: "env", name: "add")
-func add(_ a: Int, _ b: Int) -> Int
-
-print(add(2, 2))
-```

src/getting-started/browser-app.md

@@ -13,7 +13,10 @@ already automated with `carton`.
 
 ### System Requirements
 
-- [Swift 5.9.2 or later](https://swift.org/download/)
+- [Swift 5.9.2](https://swift.org/download/)
+
+>Important:
+>Tokamak UI currently is not compatible with swift 6.0+. 
 
 ### Installation
 
@@ -51,7 +54,7 @@ let package = Package(
 )
 ```
 
-4. Add your first view to `Sources/main.swift`:
+4. Add your first view to `Sources/MyApp/main.swift`:
 
 ```swift
 import TokamakDOM

src/getting-started/porting.md

@@ -1,4 +1,4 @@
-# Porting code from other platforms to WebAssembly
+# Porting code to WebAssembly with WASI
 
 In the form that's currently standardized and supported by browsers and other hosts, WebAssembly
 is a 32-bit architecture. You have to take this into account when porting code from other