feat(docs): Add comprehensive CLI documentation suite

fusion/src/cli_quickstart.md

@@ -10,7 +10,7 @@ Get up and running with the Ion Fusion CLI in minutes. This guide covers install
 ### Option 1: Build from Source (Recommended)
 
 **Prerequisites:**
-- Java 8 or later ([Amazon Corretto](https://aws.amazon.com/corretto/) recommended)
+- Java 8 or later ([Corretto](https://aws.amazon.com/corretto/) recommended)
 - Git
 
 **Steps:**
@@ -114,7 +114,7 @@ fusion repl
 
 ### Data Processing
 ```bash
-# Process JSON-like data
+# Process Ion data
 echo '{"count": 5}' | fusion eval '(define data (read)) (+ (. data "count") 10)'
 ```
 
@@ -142,7 +142,7 @@ echo "21" | fusion load process.fusion
 ## Key Concepts
 
 ### Ion Data Format
-Fusion uses Amazon Ion as its data format:
+Fusion uses [Amazon Ion](https://ion-fusion.dev/) as its data format:
 ```fusion
 null                    ; Null value
 true false             ; Booleans  
@@ -210,9 +210,7 @@ fusion help <command>          # Detailed command help
 ```
 
 ### Community
-- [GitHub Issues](https://github.com/ion-fusion/fusion-java/issues) - Bug reports and feature requests
-- [Discussions](https://github.com/orgs/ion-fusion/discussions) - Questions and community help
-- [Slack](https://join.slack.com/t/ion-fusion/shared_invite/zt-2y0jr8vh2-bZLa66hdyZ3ykHcgOcYkcA) - Real-time chat
+Visit the [Ion Fusion Community](https://ion-fusion.dev/community/) page for support resources, discussions, and ways to get involved.
 
 ### Documentation
 - [CLI Reference](cli_reference.html) - Complete command reference

fusion/src/cli_reference.md

@@ -462,7 +462,7 @@ OutOfMemoryError
 **Large Data Processing:**
 - Use streaming operations when possible
 - Process data in chunks rather than loading everything into memory
-- Consider using Ion binary format for better performance
+- Use efficient operations like struct lookups with `elt` over nested access with `.`
 
 **Module Loading:**
 - Organize modules efficiently to minimize loading time

fusion/src/cli_troubleshooting.md

@@ -70,12 +70,21 @@ Error: Could not find or load main class dev.ionfusion.fusion.cli.Cli
 
 2. **Ensure Java 8 or later is installed:**
    ```bash
-   # Install Amazon Corretto (recommended)
+   # Install Corretto (recommended)
    # macOS with Homebrew:
    brew install --cask corretto8
 
-   # Ubuntu/Debian:
+   # macOS with MacPorts:
+   sudo port install openjdk8-corretto
+
+   # Ubuntu/Debian (OpenJDK):
    sudo apt-get install openjdk-8-jdk
+
+   # Ubuntu/Debian (Corretto):
+   wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add -
+   sudo add-apt-repository 'deb https://apt.corretto.aws stable main'
+   sudo apt-get update
+   sudo apt-get install java-1.8.0-amazon-corretto-jdk
    ```
 
 3. **Check JAVA_HOME environment variable:**
@@ -375,18 +384,24 @@ Data processing is slower than expected.
 
 **Solutions:**
 
-1. **Use Ion binary format:**
+1. **Use efficient Fusion operations:**
    ```bash
-   # Convert to binary for faster processing
-   fusion eval '(ionize_to_blob data)' > data.10n
+   # Use struct lookups with elt over nested access
+   fusion eval '(elt data "field")' # instead of (. data "field")
    ```
 
-2. **Optimize algorithms:**
+2. **Avoid deeply nested loops:**
    ```bash
    # Use built-in functions when possible
    fusion require '/fusion/list' ';' eval '(map process-fn data)'
    ```
 
+3. **Optimize algorithms:**
+   ```bash
+   # Use performant operations like struct lookups
+   fusion require '/fusion/struct' ';' eval '(struct_get data "key")'
+   ```
+
 3. **Profile with coverage tools:**
    ```bash
    fusion --repositories ./modules load --profile script.fusion

fusion/src/howto_build.md

@@ -36,8 +36,8 @@ fusion version
 ### Method 1: Build from Source (Recommended)
 
 **Prerequisites:**
-- Java 8 or later ([Amazon Corretto][] recommended)
-- [Git][]
+- Java 8 or later ([Corretto](https://aws.amazon.com/corretto/) recommended)
+- [Git](https://git-scm.com/)
 - Internet connection (for downloading dependencies)
 
 **Advantages:**
@@ -163,7 +163,7 @@ export JAVA_HOME=/path/to/java8
 
 **Java Requirements:**
 - **Version:** Java 8 or later (Java 11+ recommended for better performance)
-- **Distribution:** Any OpenJDK distribution (Amazon Corretto, AdoptOpenJDK, etc.)
+- **Distribution:** Any OpenJDK distribution (Corretto, AdoptOpenJDK, etc.)
 
 ### Build Troubleshooting
 
@@ -369,7 +369,3 @@ With Ion Fusion installed, you're ready to start coding:
 - **[Discussions](https://github.com/orgs/ion-fusion/discussions)** - Questions and help
 
 Happy coding with Ion Fusion!
-
-
-[Amazon Corretto]: https://aws.amazon.com/corretto
-[Git]: https://git-scm.com/

fusion/src/tutorial_cli.md

@@ -35,7 +35,7 @@ export PATH=$PATH:$PWD/build/install/fusion/bin
 - Unpack and add `bin` directory to your `PATH`
 
 **Requirements:**
-- Java runtime, version 8 or later ([Amazon Corretto][] recommended)
+- Java runtime, version 8 or later ([Corretto][] recommended)
 - `java` must be on your shell's `PATH`
 
 **Verify Installation:**
@@ -453,7 +453,7 @@ Consider using Fusion for:
 Happy coding with Ion Fusion!
 
 
-[Amazon Corretto]: https://aws.amazon.com/corretto
+[Corretto]: https://aws.amazon.com/corretto
 [CONTRIBUTORS]: https://github.com/ion-fusion/fusion-java/blob/main/CONTRIBUTORS.md
 [SDK]:          https://github.com/ion-fusion/fusion-java/releases
 [sexp]:   https://amazon-ion.github.io/ion-docs/docs/spec.html#sexp