From c68b7e98d2024252724d758dd233fe2a3c382aba Mon Sep 17 00:00:00 2001
From: Zebulun McNeill <zeb.mcn@gmail.com>
Date: Fri, 30 May 2025 19:05:34 -0500
Subject: [PATCH 1/2] initial consolidation

---
 docs/changeblog.html                    |   5 +-
 docs/{language-guide.html => docs.html} | 593 ++++++++++++++++++++++-
 docs/examples.html                      |   5 +-
 docs/getting-started.html               | 283 -----------
 docs/index.html                         |  54 +--
 docs/memory-safety.html                 | 518 --------------------
 docs/standard-library.html              | 482 -------------------
 docs/type-system.html                   | 603 ------------------------
 8 files changed, 606 insertions(+), 1937 deletions(-)
 rename docs/{language-guide.html => docs.html} (53%)
 delete mode 100644 docs/getting-started.html
 delete mode 100644 docs/memory-safety.html
 delete mode 100644 docs/standard-library.html
 delete mode 100644 docs/type-system.html
diff --git a/docs/changeblog.html b/docs/changeblog.html
index 715c956..2b32fe6 100644
--- a/docs/changeblog.html
+++ b/docs/changeblog.html
@@ -19,8 +19,7 @@
             </div>
             <ul class="nav-menu">
                 <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
+                <li><a href="docs.html" class="nav-link">Docs</a></li>
                 <li><a href="examples.html" class="nav-link">Examples</a></li>
                 <li><a href="changeblog.html" class="nav-link active">Changeblog</a></li>
                 <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
@@ -402,7 +401,7 @@ <h2>What's Next?</h2>
                 </div>
                 <div class="footer-links">
                     <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
+                    <a href="docs.html">Documentation</a>
                     <a href="changeblog.html">Changeblog</a>
                 </div>
             </div>
diff --git a/docs/language-guide.html b/docs/docs.html
similarity index 53%
rename from docs/language-guide.html
rename to docs/docs.html
index 78933ad..25e792d 100644
--- a/docs/language-guide.html
+++ b/docs/docs.html
@@ -3,7 +3,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Language Guide - Gem Programming Language</title>
+    <title>Documentation - Gem Programming Language</title>
     <link rel="stylesheet" href="styles.css">
     <link rel="stylesheet" href="docs.css">
     <link rel="icon" type="image/svg+xml" href="favicon.svg">
@@ -19,8 +19,7 @@
             </div>
             <ul class="nav-menu">
                 <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link active">Language Guide</a></li>
+                <li><a href="docs.html" class="nav-link active">Docs</a></li>
                 <li><a href="examples.html" class="nav-link">Examples</a></li>
                 <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
                 <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
@@ -33,9 +32,14 @@
             <div class="docs-layout">
                 <aside class="docs-sidebar">
                     <nav class="docs-nav">
-                        <h3>Language Guide</h3>
+                        <h3>Documentation</h3>
                         <ul>
-                            <li><a href="#overview">Overview</a></li>
+                            <li><a href="#getting-started">Getting Started</a></li>
+                            <li><a href="#installation">Installation</a></li>
+                            <li><a href="#first-program">Your First Program</a></li>
+                            <li><a href="#repl">Interactive REPL</a></li>
+                            <li><a href="#basic-concepts">Basic Concepts</a></li>
+                            <li><a href="#overview">Language Overview</a></li>
                             <li><a href="#syntax">Syntax</a></li>
                             <li><a href="#types">Type System</a></li>
                             <li><a href="#hashes">Hashes</a></li>
@@ -46,16 +50,199 @@ <h3>Language Guide</h3>
                             <li><a href="#control-flow">Control Flow</a></li>
                             <li><a href="#modules">Modules</a></li>
                             <li><a href="#memory">Memory Safety</a></li>
+                            <li><a href="#standard-library">Standard Library</a></li>
+                            <li><a href="#importing">Importing Modules</a></li>
+                            <li><a href="#math-module">Math Module</a></li>
+                            <li><a href="#http-module">HTTP Module</a></li>
+                            <li><a href="#time-module">Time Module</a></li>
                         </ul>
                     </nav>
                 </aside>
 
                 <article class="docs-content">
                     <header class="docs-header">
-                        <h1>Gem Language Guide</h1>
-                        <p class="docs-subtitle">Complete reference for Gem's syntax, features, and programming concepts</p>
+                        <h1>Gem Documentation</h1>
+                        <p class="docs-subtitle">Complete guide to the Gem programming language</p>
                     </header>
 
+                    <section id="getting-started" class="docs-section">
+                        <h2>Getting Started</h2>
+                        <p>Learn how to install Gem and write your first program. Gem is a statically-typed programming language designed for safety, performance, and developer productivity.</p>
+                    </section>
+
+                    <section id="installation" class="docs-section">
+                        <h2>Installation</h2>
+                        <p>Gem is distributed as source code that you compile locally. This ensures optimal performance for your system and gives you access to the latest features.</p>
+
+                        <h3>Prerequisites</h3>
+                        <ul>
+                            <li>A C compiler (GCC, Clang, or MSVC)</li>
+                            <li>Make (on Unix-like systems)</li>
+                            <li>Git (to clone the repository)</li>
+                        </ul>
+
+                        <h3>Building from Source</h3>
+                        <div class="code-block">
+                            <pre><code># Clone the repository
+git clone https://github.com/SimuCorps/Gem.git
+cd Gem
+
+# Build Gem with standard library (recommended)
+make
+
+# Or build without standard library for minimal installation
+make no-stl
+
+# Install system-wide (optional)
+sudo make install</code></pre>
+                        </div>
+
+                        <p>This will create a <code>gemc</code> executable in the project directory. If you installed system-wide, you can run <code>gemc</code> from anywhere.</p>
+
+                        <div class="info-box">
+                            <h4>💡 Build Options</h4>
+                            <ul>
+                                <li><code>make</code> or <code>make gemc</code> - Full build with standard library</li>
+                                <li><code>make no-stl</code> or <code>make gemch</code> - Minimal build without STL</li>
+                                <li><code>make clean</code> - Remove build artifacts</li>
+                                <li><code>make test</code> - Run the test suite</li>
+                            </ul>
+                        </div>
+                    </section>
+
+                    <section id="first-program" class="docs-section">
+                        <h2>Your First Program</h2>
+                        <p>Let's write a simple "Hello, World!" program to verify your installation works correctly.</p>
+
+                        <h3>Create a File</h3>
+                        <p>Create a new file called <code>hello.gem</code>:</p>
+
+                        <div class="code-block">
+                            <pre><code># hello.gem - Your first Gem program
+puts "Hello, World!"
+
+# Variables with type safety
+string name = "Gem"
+int version = 1
+
+puts "Welcome to #{name} v#{version}!"
+
+# Functions
+def greet(string person) string
+    return "Hello, #{person}!"
+end
+
+puts greet("Developer")</code></pre>
+                        </div>
+
+                        <h3>Run the Program</h3>
+                        <div class="code-block">
+                            <pre><code># Run your program
+./gemc hello.gem</code></pre>
+                        </div>
+
+                        <p>You should see output like:</p>
+                        <div class="output-block">
+                            <pre>Hello, World!
+Welcome to Gem v1!
+Hello, Developer!</pre>
+                        </div>
+                    </section>
+
+                    <section id="repl" class="docs-section">
+                        <h2>Interactive REPL</h2>
+                        <p>Gem includes an interactive Read-Eval-Print Loop (REPL) that's perfect for experimenting with the language and testing small code snippets.</p>
+
+                        <h3>Starting the REPL</h3>
+                        <div class="code-block">
+                            <pre><code># Start the interactive shell
+./gemc</code></pre>
+                        </div>
+
+                        <p>You'll see a prompt where you can type Gem code:</p>
+                        <div class="output-block">
+                            <pre>> puts "Hello from REPL!"
+Hello from REPL!
+> int x = 42
+> puts x
+42
+> string! message = "Mutable string"
+> message = "Changed!"
+> puts message
+Changed!
+> </pre>
+                        </div>
+
+                        <div class="info-box">
+                            <h4>🎯 REPL Tips</h4>
+                            <ul>
+                                <li>Press <kbd>Ctrl+C</kbd> or <kbd>Ctrl+D</kbd> to exit</li>
+                                <li>Variables persist between statements</li>
+                                <li>Type checking works in real-time</li>
+                                <li>Great for learning and experimentation</li>
+                            </ul>
+                        </div>
+                    </section>
+
+                    <section id="basic-concepts" class="docs-section">
+                        <h2>Basic Concepts</h2>
+                        <p>Here are the fundamental concepts you need to understand to start programming in Gem:</p>
+
+                        <h3>Type Safety</h3>
+                        <p>Gem is statically typed, meaning all variables must have explicit types:</p>
+                        <div class="code-block">
+                            <pre><code># Basic types
+int age = 25
+string name = "Alice"
+bool isActive = true
+
+# Type errors are caught at compile time
+# age = "not a number"  # ❌ Error!</code></pre>
+                        </div>
+
+                        <h3>Mutability Control</h3>
+                        <p>Variables are immutable by default. Use <code>mut</code> to make them mutable (or <code>!</code> as syntactic sugar):</p>
+                        <div class="code-block">
+                            <pre><code># Immutable by default
+string message = "Hello"
+
+# Mutable with 'mut' keyword (recommended)
+mut string mutableMessage = "Hello"
+mutableMessage = "Changed!"
+
+# Mutable with '!' suffix (alternative)
+string! altMutableMessage = "Hello"
+altMutableMessage = "Changed!"</code></pre>
+                        </div>
+
+                        <h3>Nullability Safety</h3>
+                        <p>Use <code>?</code> to allow variables to be <code>nil</code>:</p>
+                        <div class="code-block">
+                            <pre><code># Nullable variable
+string? optionalName = nil
+optionalName = "Alice"
+
+# Must check before use
+if (optionalName != nil)
+    puts "Hello, #{optionalName}!"
+end</code></pre>
+                        </div>
+
+                        <h3>Functions</h3>
+                        <p>Functions have explicit parameter and return types:</p>
+                        <div class="code-block">
+                            <pre><code># Function with parameters and return type
+def add(int a, int b) int
+    return a + b
+end
+
+# Function with no return value
+def greet(string name) void
+    puts "Hello, #{name}!"
+end</code></pre>
+                        </div>
+                    </section>
+
                     <section id="overview" class="docs-section">
                         <h2>Language Overview</h2>
                         <p>Gem is a statically-typed programming language designed for safety, performance, and developer productivity. It combines modern language features with compile-time guarantees to prevent common programming errors.</p>
@@ -729,6 +916,394 @@ <h4>💡 Memory Safety Benefits</h4>
                             </ul>
                         </div>
                     </section>
+
+                    <section id="standard-library" class="docs-section">
+                        <h2>Standard Library</h2>
+                        <p>Gem comes with a standard library that provides essential functionality for common programming tasks. The standard library is designed to be lightweight, efficient, and type-safe.</p>
+
+                        <h3>Available Modules</h3>
+                        <ul>
+                            <li><strong>Math Module</strong> - Mathematical operations</li>
+                            <li><strong>HTTP Module</strong> - HTTP client functionality for web requests</li>
+                            <li><strong>Time Module</strong> - Time operations, measurements, and duration handling</li>
+                        </ul>
+
+                        <h3>Built-in String Operations</h3>
+                        <p>String operations are handled through built-in operators:</p>
+                        <div class="code-block">
+                            <pre><code># String concatenation (built-in)
+string combined = "Hello" + " World";  # Returns "Hello World"
+
+# String literals
+string greeting = "Hello, Gem!";
+string empty = "";</code></pre>
+                        </div>
+
+                        <h3>Design Principles</h3>
+                        <ul>
+                            <li><strong>Type Safety</strong> - All functions are fully typed with compile-time checking</li>
+                            <li><strong>Immutability</strong> - Functions don't modify their inputs unless explicitly designed to</li>
+                            <li><strong>Null Safety</strong> - Functions handle nullable types safely</li>
+                            <li><strong>Consistency</strong> - Uniform naming and behavior across modules</li>
+                        </ul>
+
+                        <div class="info-box">
+                            <h4>📦 Module System</h4>
+                            <p>Use <code>require "module_name"</code> to import standard library modules.</p>
+                        </div>
+                    </section>
+
+                    <section id="importing" class="docs-section">
+                        <h2>Importing Modules</h2>
+                        <p>Learn how to import and use standard library modules in your Gem programs.</p>
+
+                        <h3>Basic Import Syntax</h3>
+                        <div class="code-block">
+                            <pre><code># Import math module
+require "math";
+
+# Import HTTP module
+require "http";
+
+# Use imported modules
+int sum = Math.add(10, 5);
+hash response = Http.get("https://api.example.com");</code></pre>
+                        </div>
+
+                        <h3>Module Availability</h3>
+                        <div class="info-box">
+                            <h4>📦 Standard Library Modules</h4>
+                            <ul>
+                                <li><code>"math"</code> - Mathematical operations</li>
+                                <li><code>"http"</code> - HTTP client functionality</li>
+                                <li><code>"time"</code> - Time operations and duration handling</li>
+                            </ul>
+                        </div>
+                    </section>
+
+                    <section id="math-module" class="docs-section">
+                        <h2>Math Module</h2>
+                        <p>The Math module provides mathematical operations and utility functions.</p>
+
+                        <h3>Importing the Math Module</h3>
+                        <div class="code-block">
+                            <pre><code>require "math";</code></pre>
+                        </div>
+
+                        <h3>Basic Arithmetic</h3>
+                        <div class="code-block">
+                            <pre><code># Basic operations
+int sum = Math.add(10, 5);           # Returns 15
+int difference = Math.subtract(10, 5); # Returns 5
+int product = Math.multiply(10, 5);   # Returns 50
+int quotient = Math.divide(10, 5);    # Returns 2
+int remainder = Math.modulo(10, 3);   # Returns 1</code></pre>
+                        </div>
+
+                        <h3>Power Operations</h3>
+                        <div class="code-block">
+                            <pre><code># Exponentiation
+int squared = Math.power(5, 2);      # Returns 25
+int cubed = Math.power(3, 3);        # Returns 27
+int power = Math.power(2, 8);        # Returns 256</code></pre>
+                        </div>
+
+                        <h3>Comparison and Selection</h3>
+                        <div class="code-block">
+                            <pre><code># Min/Max operations
+int minimum = Math.min(10, 5);       # Returns 5
+int maximum = Math.max(10, 5);       # Returns 10</code></pre>
+                        </div>
+
+                        <h3>Absolute Value</h3>
+                        <div class="code-block">
+                            <pre><code># Absolute value
+int abs1 = Math.abs(-5);             # Returns 5
+int abs2 = Math.abs(5);              # Returns 5
+int abs3 = Math.abs(0);              # Returns 0</code></pre>
+                        </div>
+
+                        <h3>Math Module Function Reference</h3>
+                        <div class="code-block">
+                            <pre><code># Complete Math module API
+Math.add(int a, int b) int              # Addition
+Math.subtract(int a, int b) int         # Subtraction
+Math.multiply(int a, int b) int         # Multiplication
+Math.divide(int a, int b) int           # Division
+Math.modulo(int a, int b) int           # Modulo operation
+Math.power(int base, int exp) int       # Exponentiation
+Math.abs(int x) int                     # Absolute value
+Math.min(int a, int b) int              # Minimum of two values
+Math.max(int a, int b) int              # Maximum of two values</code></pre>
+                        </div>
+                    </section>
+
+                    <section id="http-module" class="docs-section">
+                        <h2>HTTP Module</h2>
+                        <p>The HTTP module provides a comprehensive HTTP client for making web requests. It supports all major HTTP methods, custom headers, request data, and detailed response handling.</p>
+
+                        <h3>Importing the HTTP Module</h3>
+                        <div class="code-block">
+                            <pre><code>require "http";</code></pre>
+                        </div>
+
+                        <h3>Basic GET Request</h3>
+                        <div class="code-block">
+                            <pre><code># Simple GET request
+hash response = Http.get("https://api.example.com/data");
+
+# Check if request was successful
+bool success = response["success"] as bool;
+int status = response["status"] as int;
+string body = response["body"] as string;
+
+if (success)
+    puts "Request successful!";
+    puts "Status: " + status;
+    puts "Response: " + body;
+else
+    puts "Request failed with status: " + status;
+end</code></pre>
+                        </div>
+
+                        <h3>GET Request with Custom Headers</h3>
+                        <div class="code-block">
+                            <pre><code># GET request with custom headers
+hash headers = {};
+headers["Authorization"] = "Bearer your-token-here";
+headers["Content-Type"] = "application/json";
+headers["User-Agent"] = "MyApp/1.0";
+
+hash response = Http.get("https://api.example.com/protected", headers);
+
+# Access response details
+bool success = response["success"] as bool;
+int status = response["status"] as int;
+string body = response["body"] as string;
+int responseTime = response["response_time"] as int;</code></pre>
+                        </div>
+
+                        <h3>POST Request with Data</h3>
+                        <div class="code-block">
+                            <pre><code># POST request with form data
+hash data = {};
+data["name"] = "John Doe";
+data["email"] = "john@example.com";
+data["age"] = "30";
+
+hash response = Http.post("https://api.example.com/users", data);
+
+if (response["success"] as bool)
+    puts "User created successfully!";
+    puts "Response: " + (response["body"] as string);
+end</code></pre>
+                        </div>
+
+                        <h3>POST Request with JSON and Headers</h3>
+                        <div class="code-block">
+                            <pre><code># POST request with JSON data and custom headers
+hash headers = {};
+headers["Content-Type"] = "application/json";
+headers["Authorization"] = "Bearer token123";
+
+hash jsonData = {};
+jsonData["title"] = "New Post";
+jsonData["content"] = "This is the post content";
+jsonData["published"] = "true";
+
+hash response = Http.post("https://api.example.com/posts", jsonData, headers);
+
+# Check response
+bool success = response["success"] as bool;
+int status = response["status"] as int;
+
+if (success)
+    puts "Post created! Status: " + status;
+else
+    puts "Failed to create post. Status: " + status;
+end</code></pre>
+                        </div>
+
+                        <h3>PUT Request for Updates</h3>
+                        <div class="code-block">
+                            <pre><code># PUT request to update a resource
+hash updateData = {};
+updateData["name"] = "Jane Doe";
+updateData["email"] = "jane@example.com";
+
+hash headers = {};
+headers["Content-Type"] = "application/json";
+
+hash response = Http.put("https://api.example.com/users/123", updateData, headers);
+
+if (response["success"] as bool)
+    puts "User updated successfully!";
+    puts "Response time: " + (response["response_time"] as int) + "ms";
+end</code></pre>
+                        </div>
+
+                        <h3>DELETE Request</h3>
+                        <div class="code-block">
+                            <pre><code># DELETE request with authorization
+hash headers = {};
+headers["Authorization"] = "Bearer admin-token";
+
+hash response = Http.delete("https://api.example.com/users/123", headers);
+
+bool success = response["success"] as bool;
+int status = response["status"] as int;
+
+if (success)
+    puts "Resource deleted successfully!";
+else
+    puts "Failed to delete resource. Status: " + status;
+end</code></pre>
+                        </div>
+
+                        <h3>Error Handling</h3>
+                        <div class="code-block">
+                            <pre><code># Comprehensive error handling
+hash response = Http.get("https://invalid-url-example.com");
+
+bool success = response["success"] as bool;
+int status = response["status"] as int;
+
+if (!success)
+    if (status == 0)
+        puts "Network error or invalid URL";
+    elsif (status == 404)
+        puts "Resource not found";
+    elsif (status == 500)
+        puts "Server error";
+    else
+        puts "Request failed with status: " + status;
+    end
+else
+    puts "Request successful!";
+    string body = response["body"] as string;
+    puts "Response: " + body;
+end</code></pre>
+                        </div>
+
+                        <h3>HTTP Module Function Reference</h3>
+                        <div class="code-block">
+                            <pre><code># Complete HTTP module API
+
+# GET requests
+Http.get(string url) hash                           # Simple GET
+Http.get(string url, hash headers) hash             # GET with headers
+
+# POST requests  
+Http.post(string url, hash data) hash               # POST with data
+Http.post(string url, hash data, hash headers) hash # POST with data and headers
+
+# PUT requests
+Http.put(string url, hash data) hash                # PUT with data
+Http.put(string url, hash data, hash headers) hash  # PUT with data and headers
+
+# DELETE requests
+Http.delete(string url) hash                        # Simple DELETE
+Http.delete(string url, hash headers) hash          # DELETE with headers
+
+# Response hash structure:
+# {
+#   "success": bool,        # Whether request succeeded
+#   "status": int,          # HTTP status code (0 for network errors)
+#   "body": string,         # Response body content
+#   "response_time": int    # Response time in microseconds
+# }</code></pre>
+                        </div>
+
+                        <h3>Common HTTP Status Codes</h3>
+                        <div class="info-box">
+                            <h4>📡 HTTP Status Codes</h4>
+                            <ul>
+                                <li><code>200</code> - OK (Success)</li>
+                                <li><code>201</code> - Created</li>
+                                <li><code>400</code> - Bad Request</li>
+                                <li><code>401</code> - Unauthorized</li>
+                                <li><code>403</code> - Forbidden</li>
+                                <li><code>404</code> - Not Found</li>
+                                <li><code>500</code> - Internal Server Error</li>
+                                <li><code>0</code> - Network Error/Invalid URL</li>
+                            </ul>
+                        </div>
+                    </section>
+
+                    <section id="time-module" class="docs-section">
+                        <h2>Time Module</h2>
+                        <p>The Time module provides basic time-related functionality including current time access, sleep operations, and function timing.</p>
+
+                        <h3>Importing the Time Module</h3>
+                        <div class="code-block">
+                            <pre><code>require "time";</code></pre>
+                        </div>
+
+                        <h3>Current Time</h3>
+                        <div class="code-block">
+                            <pre><code># Get current time as floating-point timestamp
+puts "Current timestamp: #{Time.now()}";</code></pre>
+                        </div>
+
+                        <h3>Sleep Operations</h3>
+                        <div class="code-block">
+                            <pre><code># Sleep for a specified number of milliseconds
+puts "Starting operation...";
+Time.sleep(2000);  # Sleep for 2 seconds (2000 milliseconds)
+puts "Operation completed after delay";</code></pre>
+                        </div>
+
+                        <h3>Function Timing</h3>
+                        <div class="code-block">
+                            <pre><code># Measure execution time of a function
+def slowOperation() void
+    Time.sleep(1000);  # Sleep for 1 second (1000 milliseconds)
+    puts "Slow operation completed";
+end
+
+# Measure function execution
+Time.measure(slowOperation);</code></pre>
+                        </div>
+
+                        <h3>Timeout Operations</h3>
+                        <div class="code-block">
+                            <pre><code># Attempt to run function with timeout
+def quickOperation() void
+    puts "Quick operation";
+end
+
+def slowOperation() void
+    Time.sleep(5000);  # Sleep for 5 seconds (5000 milliseconds)
+    puts "This takes too long";
+end
+
+Time.timeout(quickOperation, 2);  # 2 second timeout
+Time.timeout(slowOperation, 2);   # 2 second timeout</code></pre>
+                        </div>
+
+                        <h3>Practical Time Examples</h3>
+                        <div class="code-block">
+                            <pre><code># Simple timing and sleep operations
+def timedWork() void
+    puts "Starting work...";
+    Time.sleep(1500);  # 1.5 seconds of work
+    puts "Work completed";
+end
+
+# Measure the work
+puts "Timing work operation:";
+Time.measure(timedWork);
+
+# Multiple sleep operations
+puts "Sleep sequence:";
+Time.sleep(500);   # 0.5 seconds
+puts "Step 1 complete";
+Time.sleep(1000);  # 1.0 seconds  
+puts "Step 2 complete";
+Time.sleep(750);   # 0.75 seconds
+puts "All steps complete";</code></pre>
+                        </div>
+                    </section>
                 </article>
             </div>
         </div>
@@ -743,8 +1318,8 @@ <h4>💡 Memory Safety Benefits</h4>
                 </div>
                 <div class="footer-links">
                     <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
-                    <a href="examples.html">Examples</a>
+                    <a href="docs.html">Documentation</a>
+                    <a href="changeblog.html">Changeblog</a>
                 </div>
             </div>
             <div class="footer-bottom">
diff --git a/docs/examples.html b/docs/examples.html
index 7a4fb36..0096a7b 100644
--- a/docs/examples.html
+++ b/docs/examples.html
@@ -19,8 +19,7 @@
             </div>
             <ul class="nav-menu">
                 <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
+                <li><a href="docs.html" class="nav-link">Docs</a></li>
                 <li><a href="examples.html" class="nav-link active">Examples</a></li>
                 <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
                 <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
@@ -720,7 +719,7 @@ <h3>Data Processing</h3>
                 </div>
                 <div class="footer-links">
                     <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
+                    <a href="docs.html">Documentation</a>
                     <a href="examples.html">Examples</a>
                 </div>
             </div>
diff --git a/docs/getting-started.html b/docs/getting-started.html
deleted file mode 100644
index c6459eb..0000000
--- a/docs/getting-started.html
+++ /dev/null
@@ -1,283 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Getting Started - Gem Programming Language</title>
-    <link rel="stylesheet" href="styles.css">
-    <link rel="stylesheet" href="docs.css">
-    <link rel="icon" type="image/svg+xml" href="favicon.svg">
-</head>
-<body>
-    <nav class="navbar">
-        <div class="nav-container">
-            <div class="nav-brand">
-                <a href="index.html" style="display: flex; align-items: center; gap: 0.5rem; text-decoration: none; color: inherit;">
-                    <span class="gem-icon">💎</span>
-                    <span class="brand-text">Gem</span>
-                </a>
-            </div>
-            <ul class="nav-menu">
-                <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link active">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
-                <li><a href="examples.html" class="nav-link">Examples</a></li>
-                <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
-                <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
-            </ul>
-        </div>
-    </nav>
-
-    <main class="docs-main">
-        <div class="container">
-            <div class="docs-layout">
-                <aside class="docs-sidebar">
-                    <nav class="docs-nav">
-                        <h3>Getting Started</h3>
-                        <ul>
-                            <li><a href="#installation">Installation</a></li>
-                            <li><a href="#first-program">Your First Program</a></li>
-                            <li><a href="#repl">Interactive REPL</a></li>
-                            <li><a href="#basic-concepts">Basic Concepts</a></li>
-                            <li><a href="#next-steps">Next Steps</a></li>
-                        </ul>
-                    </nav>
-                </aside>
-
-                <article class="docs-content">
-                    <header class="docs-header">
-                        <h1>Getting Started with Gem</h1>
-                        <p class="docs-subtitle">Learn how to install Gem and write your first program</p>
-                    </header>
-
-                    <section id="installation" class="docs-section">
-                        <h2>Installation</h2>
-                        <p>Gem is distributed as source code that you compile locally. This ensures optimal performance for your system and gives you access to the latest features.</p>
-
-                        <h3>Prerequisites</h3>
-                        <ul>
-                            <li>A C compiler (GCC, Clang, or MSVC)</li>
-                            <li>Make (on Unix-like systems)</li>
-                            <li>Git (to clone the repository)</li>
-                        </ul>
-
-                        <h3>Building from Source</h3>
-                        <div class="code-block">
-                            <pre><code># Clone the repository
-git clone https://github.com/SimuCorps/Gem.git
-cd Gem
-
-# Build Gem with standard library (recommended)
-make
-
-# Or build without standard library for minimal installation
-make no-stl
-
-# Install system-wide (optional)
-sudo make install</code></pre>
-                        </div>
-
-                        <p>This will create a <code>gemc</code> executable in the project directory. If you installed system-wide, you can run <code>gemc</code> from anywhere.</p>
-
-                        <div class="info-box">
-                            <h4>💡 Build Options</h4>
-                            <ul>
-                                <li><code>make</code> or <code>make gemc</code> - Full build with standard library</li>
-                                <li><code>make no-stl</code> or <code>make gemch</code> - Minimal build without STL</li>
-                                <li><code>make clean</code> - Remove build artifacts</li>
-                                <li><code>make test</code> - Run the test suite</li>
-                            </ul>
-                        </div>
-                    </section>
-
-                    <section id="first-program" class="docs-section">
-                        <h2>Your First Program</h2>
-                        <p>Let's write a simple "Hello, World!" program to verify your installation works correctly.</p>
-
-                        <h3>Create a File</h3>
-                        <p>Create a new file called <code>hello.gem</code>:</p>
-
-                        <div class="code-block">
-                            <pre><code># hello.gem - Your first Gem program
-puts "Hello, World!"
-
-# Variables with type safety
-string name = "Gem"
-int version = 1
-
-puts "Welcome to #{name} v#{version}!"
-
-# Functions
-def greet(string person) string
-    return "Hello, #{person}!"
-end
-
-puts greet("Developer")</code></pre>
-                        </div>
-
-                        <h3>Run the Program</h3>
-                        <div class="code-block">
-                            <pre><code># Run your program
-./gemc hello.gem</code></pre>
-                        </div>
-
-                        <p>You should see output like:</p>
-                        <div class="output-block">
-                            <pre>Hello, World!
-Welcome to Gem v1!
-Hello, Developer!</pre>
-                        </div>
-                    </section>
-
-                    <section id="repl" class="docs-section">
-                        <h2>Interactive REPL</h2>
-                        <p>Gem includes an interactive Read-Eval-Print Loop (REPL) that's perfect for experimenting with the language and testing small code snippets.</p>
-
-                        <h3>Starting the REPL</h3>
-                        <div class="code-block">
-                            <pre><code># Start the interactive shell
-./gemc</code></pre>
-                        </div>
-
-                        <p>You'll see a prompt where you can type Gem code:</p>
-                        <div class="output-block">
-                            <pre>> puts "Hello from REPL!"
-Hello from REPL!
-> int x = 42
-> puts x
-42
-> string! message = "Mutable string"
-> message = "Changed!"
-> puts message
-Changed!
-> </pre>
-                        </div>
-
-                        <div class="info-box">
-                            <h4>🎯 REPL Tips</h4>
-                            <ul>
-                                <li>Press <kbd>Ctrl+C</kbd> or <kbd>Ctrl+D</kbd> to exit</li>
-                                <li>Variables persist between statements</li>
-                                <li>Type checking works in real-time</li>
-                                <li>Great for learning and experimentation</li>
-                            </ul>
-                        </div>
-                    </section>
-
-                    <section id="basic-concepts" class="docs-section">
-                        <h2>Basic Concepts</h2>
-                        <p>Here are the fundamental concepts you need to understand to start programming in Gem:</p>
-
-                        <h3>Type Safety</h3>
-                        <p>Gem is statically typed, meaning all variables must have explicit types:</p>
-                        <div class="code-block">
-                            <pre><code># Basic types
-int age = 25
-string name = "Alice"
-bool isActive = true
-
-# Type errors are caught at compile time
-# age = "not a number"  # ❌ Error!</code></pre>
-                        </div>
-
-                        <h3>Mutability Control</h3>
-                        <p>Variables are immutable by default. Use <code>mut</code> to make them mutable (or <code>!</code> as syntactic sugar):</p>
-                        <div class="code-block">
-                            <pre><code># Immutable by default
-string message = "Hello"
-
-# Mutable with 'mut' keyword (recommended)
-mut string mutableMessage = "Hello"
-mutableMessage = "Changed!"
-
-# Mutable with '!' suffix (alternative)
-string! altMutableMessage = "Hello"
-altMutableMessage = "Changed!"</code></pre>
-                        </div>
-
-                        <h3>Nullability Safety</h3>
-                        <p>Use <code>?</code> to allow variables to be <code>nil</code>:</p>
-                        <div class="code-block">
-                            <pre><code># Non-nullable (default)
-string name = "Alice"
-# name = nil  # ❌ Error: Cannot assign nil
-
-# Nullable
-string? optionalName = nil  # ✅ Valid
-optionalName = "Bob"        # ✅ Valid
-optionalName = nil          # ✅ Valid</code></pre>
-                        </div>
-
-                        <h3>Memory Safety</h3>
-                        <p>Gem automatically manages memory with scope-based cleanup:</p>
-                        <div class="code-block">
-                            <pre><code># Objects are automatically cleaned up when scope ends
-begin
-    obj resource = SomeResource("data");
-    resource.process();
-    # resource is automatically cleaned up here
-end
-# resource is no longer accessible</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="next-steps" class="docs-section">
-                        <h2>Next Steps</h2>
-                        <p>Now that you have Gem installed and understand the basics, here's what to explore next:</p>
-
-                        <div class="next-steps-grid">
-                            <div class="next-step-card">
-                                <h3><a href="language-guide.html">Language Guide</a></h3>
-                                <p>Complete guide to Gem's syntax, features, and best practices.</p>
-                            </div>
-                            <div class="next-step-card">
-                                <h3><a href="type-system.html">Type System</a></h3>
-                                <p>Deep dive into Gem's enhanced type system with mutability and nullability.</p>
-                            </div>
-                            <div class="next-step-card">
-                                <h3><a href="examples.html">Examples</a></h3>
-                                <p>Real-world code examples and common patterns.</p>
-                            </div>
-                            <div class="next-step-card">
-                                <h3><a href="standard-library.html">Standard Library</a></h3>
-                                <p>Reference for built-in modules and functions.</p>
-                            </div>
-                        </div>
-
-                        <div class="info-box">
-                            <h4>🚀 Quick Reference</h4>
-                            <ul>
-                                <li><code>./gemc</code> - Start interactive REPL</li>
-                                <li><code>./gemc file.gem</code> - Run a Gem program</li>
-                                <li><code>make test</code> - Run the test suite</li>
-                                <li><code>make clean</code> - Clean build artifacts</li>
-                            </ul>
-                        </div>
-                    </section>
-                </article>
-            </div>
-        </div>
-    </main>
-
-    <footer class="footer">
-        <div class="container">
-            <div class="footer-content">
-                <div class="footer-brand">
-                    <span class="gem-icon">💎</span>
-                    <span>Gem Programming Language</span>
-                </div>
-                <div class="footer-links">
-                    <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
-                    <a href="examples.html">Examples</a>
-                </div>
-            </div>
-            <div class="footer-bottom">
-              <p>&copy; 2025 SimuCorps LLC</p>
-            </div>
-        </div>
-    </footer>
-
-    <script src="script.js"></script>
-</body>
-</html> 
\ No newline at end of file
diff --git a/docs/index.html b/docs/index.html
index 8654f9f..08b8701 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -16,9 +16,8 @@
                 <span class="version">v1.3.0</span>
             </div>
             <ul class="nav-menu">
-                <li><a href="index.html" class="nav-link active">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
+                <li><a href="index.html" class="nav-link">Home</a></li>
+                <li><a href="docs.html" class="nav-link">Docs</a></li>
                 <li><a href="examples.html" class="nav-link">Examples</a></li>
                 <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
                 <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
@@ -139,6 +138,21 @@ <h3>Modern Features</h3>
                         <h3>Beautiful Syntax</h3>
                         <p>Clean, expressive syntax that's genuinely pleasant to read and write. Code that's not only safe and fast, but beautiful.</p>
                     </div>
+                    <div class="feature-card">
+                        <div class="feature-icon">📚</div>
+                        <h3><a href="docs.html">Documentation</a></h3>
+                        <p>Complete guide covering installation, language features, and standard library</p>
+                    </div>
+                    <div class="feature-card">
+                        <div class="feature-icon">💡</div>
+                        <h3><a href="examples.html">Examples</a></h3>
+                        <p>Real-world examples and code samples to get you started</p>
+                    </div>
+                    <div class="feature-card">
+                        <div class="feature-icon">📖</div>
+                        <h3><a href="changeblog.html">Changeblog</a></h3>
+                        <p>Learn about Gem's evolution and latest features</p>
+                    </div>
                 </div>
             </div>
         </section>
@@ -203,38 +217,6 @@ <h3>🎯 Design Philosophy</h3>
             </div>
         </section>
 
-        <section id="docs" class="documentation">
-            <div class="container">
-                <h2 class="section-title">Documentation</h2>
-                <div class="docs-grid">
-                    <div class="doc-card">
-                        <h3><a href="getting-started.html">Getting Started</a></h3>
-                        <p>Install Gem, write your first program, and learn the basics of the language.</p>
-                    </div>
-                    <div class="doc-card">
-                        <h3><a href="language-guide.html">Language Guide</a></h3>
-                        <p>Complete guide to Gem's syntax, type system, and language features.</p>
-                    </div>
-                    <div class="doc-card">
-                        <h3><a href="type-system.html">Type System</a></h3>
-                        <p>Deep dive into Gem's enhanced type system with mutability and nullability control.</p>
-                    </div>
-                    <div class="doc-card">
-                        <h3><a href="memory-safety.html">Memory Safety</a></h3>
-                        <p>Learn how Gem prevents memory errors with scope-based management and borrow checking.</p>
-                    </div>
-                    <div class="doc-card">
-                        <h3><a href="standard-library.html">Standard Library</a></h3>
-                        <p>Reference for Gem's built-in modules and functions.</p>
-                    </div>
-                    <div class="doc-card">
-                        <h3><a href="examples.html">Examples</a></h3>
-                        <p>Real-world examples and code snippets to help you learn Gem.</p>
-                    </div>
-                </div>
-            </div>
-        </section>
-
         <section id="examples" class="examples">
             <div class="container">
                 <h2 class="section-title">Code Examples</h2>
@@ -300,7 +282,7 @@ <h3>Functions & Classes</h3>
                 </div>
                 <div class="footer-links">
                     <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
+                    <a href="docs.html">Documentation</a>
                     <a href="examples.html">Examples</a>
                 </div>
             </div>
diff --git a/docs/memory-safety.html b/docs/memory-safety.html
deleted file mode 100644
index e32015b..0000000
--- a/docs/memory-safety.html
+++ /dev/null
@@ -1,518 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Memory Safety - Gem Programming Language</title>
-    <link rel="stylesheet" href="styles.css">
-    <link rel="stylesheet" href="docs.css">
-    <link rel="icon" type="image/svg+xml" href="favicon.svg">
-</head>
-<body>
-    <nav class="navbar">
-        <div class="nav-container">
-            <div class="nav-brand">
-                <a href="index.html" style="display: flex; align-items: center; gap: 0.5rem; text-decoration: none; color: inherit;">
-                    <span class="gem-icon">💎</span>
-                    <span class="brand-text">Gem</span>
-                </a>
-            </div>
-            <ul class="nav-menu">
-                <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
-                <li><a href="examples.html" class="nav-link">Examples</a></li>
-                <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
-                <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
-            </ul>
-        </div>
-    </nav>
-
-    <main class="docs-main">
-        <div class="container">
-            <div class="docs-layout">
-                <aside class="docs-sidebar">
-                    <nav class="docs-nav">
-                        <h3>Memory Safety</h3>
-                        <ul>
-                            <li><a href="#overview">Overview</a></li>
-                            <li><a href="#scope-based">Scope-Based Management</a></li>
-                            <li><a href="#borrow-checking">Borrow Checking</a></li>
-                            <li><a href="#automatic-cleanup">Automatic Cleanup</a></li>
-                            <li><a href="#safety-guarantees">Safety Guarantees</a></li>
-                            <li><a href="#patterns">Common Patterns</a></li>
-                            <li><a href="#best-practices">Best Practices</a></li>
-                        </ul>
-                    </nav>
-                </aside>
-
-                <article class="docs-content">
-                    <header class="docs-header">
-                        <h1>Memory Safety in Gem</h1>
-                        <p class="docs-subtitle">Learn how Gem prevents memory errors with scope-based management and borrow checking</p>
-                    </header>
-
-                    <section id="overview" class="docs-section">
-                        <h2>Memory Safety Overview</h2>
-                        <p>Gem provides automatic memory management that eliminates entire classes of bugs common in systems programming. The language ensures memory safety without the complexity of manual memory management or the unpredictability of garbage collection.</p>
-
-                        <h3>Key Benefits</h3>
-                        <ul>
-                            <li><strong>No Memory Leaks</strong> - Objects are automatically cleaned up when they go out of scope</li>
-                            <li><strong>No Use-After-Free</strong> - Compile-time checks prevent accessing dropped objects</li>
-                            <li><strong>No Double-Free</strong> - Objects can only be dropped once</li>
-                            <li><strong>No Null Pointer Dereferences</strong> - Combined with the type system for complete safety</li>
-                            <li><strong>Predictable Performance</strong> - No garbage collection pauses</li>
-                            <li><strong>Zero Runtime Cost</strong> - Safety checks happen at compile time</li>
-                        </ul>
-
-                        <div class="info-box">
-                            <h4>🛡️ Safety Without Complexity</h4>
-                            <p>Gem's memory safety model provides strong guarantees with simple syntax. You get the safety benefits without needing to understand complex ownership rules or lifetime annotations.</p>
-                        </div>
-                    </section>
-
-                    <section id="scope-based" class="docs-section">
-                        <h2>Scope-Based Memory Management</h2>
-                        <p>Gem uses scope-based memory management where objects are automatically cleaned up when they go out of scope. This provides deterministic cleanup without manual intervention.</p>
-
-                        <h3>Basic Scope Rules</h3>
-                        <div class="code-block">
-                            <pre><code># Objects are created and destroyed within their scope
-def processData() void
-    obj resource = FileHandle("data.txt");
-    resource.read();
-    resource.process();
-    # resource is automatically cleaned up here
-end
-# resource is no longer accessible outside the function</code></pre>
-                        </div>
-
-                        <h3>Block Scopes</h3>
-                        <div class="code-block">
-                            <pre><code># Nested scopes provide fine-grained control
-def complexProcessing() void
-    obj mainResource = MainResource();
-    
-    begin
-        obj tempResource = TempResource();
-        mainResource.useWith(tempResource);
-        # tempResource is cleaned up here
-    end
-    
-    mainResource.finalize();
-    # mainResource is cleaned up when function ends
-end</code></pre>
-                        </div>
-
-                        <h3>Conditional Scopes</h3>
-                        <div class="code-block">
-                            <pre><code># Objects in conditional blocks are properly managed
-def conditionalProcessing(bool useCache) void
-    if (useCache)
-        obj cache = CacheManager();
-        cache.load();
-        # cache is cleaned up when if block ends
-    else
-        obj directProcessor = DirectProcessor();
-        directProcessor.process();
-        # directProcessor is cleaned up when else block ends
-    end
-end</code></pre>
-                        </div>
-
-                        <h3>Loop Scopes</h3>
-                        <div class="code-block">
-                            <pre><code># Objects created in loops are managed per iteration (recommended syntax)
-def processFiles() void
-    for (mut int i = 0; i < 10; i = i + 1)
-        obj file = FileHandle("file#{i}.txt");
-        file.process();
-        # file is cleaned up at end of each iteration
-    end
-end
-
-# Alternative syntax with '!' suffix
-def processFilesAlt() void
-    for (int! i = 0; i < 10; i = i + 1)
-        obj file = FileHandle("file#{i}.txt");
-        file.process();
-        # file is cleaned up at end of each iteration
-    end
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="borrow-checking" class="docs-section">
-                        <h2>Borrow Checking</h2>
-                        <p>Gem's borrow checker ensures that objects cannot be used after they've been dropped, preventing use-after-free errors at compile time.</p>
-
-                        <h3>Basic Borrow Rules</h3>
-                        <div class="code-block">
-                            <pre><code># Objects can be used while in scope
-def safeBorrowing() void
-                obj resource = SomeResource("data");
-    
-    if (resource.isValid())
-        resource.process();  # ✅ Safe: resource is in scope
-    end
-    
-    # resource is cleaned up here
-end</code></pre>
-                        </div>
-
-                        <h3>Preventing Use-After-Drop</h3>
-                        <div class="code-block">
-                            <pre><code># Compiler prevents use after potential drop
-def borrowExample() void
-    obj resource = SomeResource("data");
-    
-    begin
-        resource.process();  # ✅ Safe: resource is accessible
-    end
-    
-    # resource.process();  # ❌ Compile error: use after potential drop
-end</code></pre>
-                        </div>
-
-                        <h3>Function Parameter Borrowing</h3>
-                        <div class="code-block">
-                            <pre><code># Functions can safely borrow objects
-def processResource(obj resource) void
-    resource.validate();
-    resource.process();
-    # resource is not dropped here - caller owns it
-end
-
-def main() void
-    obj myResource = SomeResource("data");
-    processResource(myResource);  # Borrow myResource
-    myResource.finalize();        # ✅ Safe: still owned by main
-    # myResource is cleaned up here
-end</code></pre>
-                        </div>
-
-                        <h3>Return Value Ownership</h3>
-                        <div class="code-block">
-                            <pre><code># Functions can transfer ownership through return values
-def createResource(string name) obj
-    obj resource = SomeResource(name);
-    resource.initialize();
-    return resource;  # Ownership transferred to caller
-end
-
-def main() void
-    obj myResource = createResource("data");
-    myResource.process();
-    # myResource is cleaned up here
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="automatic-cleanup" class="docs-section">
-                        <h2>Automatic Cleanup</h2>
-                        <p>Gem automatically handles resource cleanup, ensuring that objects are properly destroyed when they go out of scope.</p>
-
-                        <h3>Deterministic Destruction</h3>
-                        <div class="code-block">
-                            <pre><code># Objects are destroyed in reverse order of creation
-def resourceManagement() void
-    obj first = FirstResource();
-    obj second = SecondResource();
-    obj third = ThirdResource();
-    
-    # Cleanup order: third, second, first
-    # This ensures proper dependency management
-end</code></pre>
-                        </div>
-
-                        <h3>Exception Safety</h3>
-                        <div class="code-block">
-                            <pre><code># Resources are cleaned up even if errors occur
-def safeProcessing() void
-    obj resource = CriticalResource();
-    
-    # Even if this operation fails, resource is still cleaned up
-    resource.riskyOperation();
-    
-    # resource is guaranteed to be cleaned up
-end</code></pre>
-                        </div>
-
-                        <h3>Class Destructors</h3>
-                        <div class="code-block">
-                            <pre><code># Classes can define cleanup behavior
-class FileManager
-    def init(string filename) void
-        this.filename = filename;
-        this.handle = openFile(filename);
-    end
-    
-    def destroy() void
-        # Called automatically when object goes out of scope
-        closeFile(this.handle);
-        puts "File " + this.filename + " closed";
-    end
-    
-    def process() void
-        # Use the file handle
-        readFromFile(this.handle);
-    end
-end
-
-# Usage
-def processFile() void
-    obj manager = FileManager("data.txt");
-    manager.process();
-    # destroy() is called automatically here
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="safety-guarantees" class="docs-section">
-                        <h2>Safety Guarantees</h2>
-                        <p>Gem's memory safety system provides strong compile-time guarantees that eliminate entire classes of runtime errors.</p>
-
-                        <h3>Guaranteed Safety Properties</h3>
-                        <ul>
-                            <li><strong>Memory Safety</strong> - No buffer overflows, use-after-free, or double-free errors</li>
-                            <li><strong>Type Safety</strong> - No type confusion or invalid casts</li>
-                            <li><strong>Null Safety</strong> - No null pointer dereferences (when combined with type system)</li>
-                            <li><strong>Resource Safety</strong> - Automatic cleanup of files, network connections, etc.</li>
-                            <li><strong>Thread Safety</strong> - Immutable data is inherently thread-safe</li>
-                        </ul>
-
-                        <h3>Compile-Time Verification</h3>
-                        <div class="code-block">
-                            <pre><code># These errors are caught at compile time, not runtime:
-
-def memoryErrors() void
-    obj resource = SomeResource();
-    
-    begin
-        # resource.use();  # ✅ Valid: resource is accessible
-    end
-    
-    # resource.use();    # ❌ Compile error: use after potential drop
-    # delete resource;   # ❌ Compile error: manual delete not allowed
-    # resource = nil;    # ❌ Compile error: cannot nullify object
-end</code></pre>
-                        </div>
-
-                        <h3>No Runtime Overhead</h3>
-                        <div class="info-box">
-                            <h4>⚡ Zero-Cost Abstractions</h4>
-                            <p>All safety checks happen at compile time. The generated code has no runtime overhead for memory safety - it's as fast as manually managed C code but completely safe.</p>
-                        </div>
-                    </section>
-
-                    <section id="patterns" class="docs-section">
-                        <h2>Common Memory Safety Patterns</h2>
-                        <p>Learn common patterns for safe and efficient memory management in Gem.</p>
-
-                        <h3>RAII (Resource Acquisition Is Initialization)</h3>
-                        <div class="code-block">
-                            <pre><code># Resources are acquired in constructors and released in destructors
-class DatabaseConnection
-    def init(string connectionString) void
-        this.connection = connect(connectionString);
-        puts "Database connected";
-    end
-    
-    def destroy() void
-        disconnect(this.connection);
-        puts "Database disconnected";
-    end
-    
-    def query(string sql) string
-        return executeQuery(this.connection, sql);
-    end
-end
-
-# Usage - connection is automatically managed
-def databaseOperation() void
-    obj db = DatabaseConnection("localhost:5432");
-    string result = db.query("SELECT * FROM users");
-    puts result;
-    # Database automatically disconnected here
-end</code></pre>
-                        </div>
-
-                        <h3>Scoped Resource Management</h3>
-                        <div class="code-block">
-                            <pre><code># Use scopes to control resource lifetimes precisely
-def processWithTempFiles() void
-    obj mainFile = FileHandle("main.txt");
-    
-    # Create temporary files in a nested scope
-    begin
-        obj tempFile1 = FileHandle("temp1.txt");
-        obj tempFile2 = FileHandle("temp2.txt");
-        
-        # Process with temporary files
-        processFiles(mainFile, tempFile1, tempFile2);
-        
-        # Temporary files are cleaned up here
-    end
-    
-    # Continue with main file only
-    mainFile.finalize();
-    # Main file cleaned up here
-end</code></pre>
-                        </div>
-
-                        <h3>Safe Factory Patterns</h3>
-                        <div class="code-block">
-                            <pre><code># Factory functions safely transfer ownership
-class ResourceFactory
-    def createResource(string type) obj?
-        if (type == "file")
-            return FileResource("data.txt");
-        else if (type == "network")
-            return NetworkResource("api.example.com");
-        else
-            return nil;  # Safe failure mode
-        end
-    end
-end
-
-def useFactory() void
-    obj factory = ResourceFactory();
-    obj? resource = factory.createResource("file");
-    
-    if (resource != nil)
-        resource.process();
-        # resource is cleaned up here
-    end
-end</code></pre>
-                        </div>
-
-                        <h3>Safe Collection Management</h3>
-                        <div class="code-block">
-                            <pre><code># Collections safely manage their contents
-class ResourcePool
-    def init() void
-        # Initialize empty pool
-    end
-    
-    def addResource(obj resource) void
-        # Add resource to internal collection
-        # Pool takes ownership
-    end
-    
-    def processAll() void
-        # Process all resources in the pool
-    end
-    
-    def destroy() void
-        # All resources in pool are automatically cleaned up
-    end
-end
-
-def poolExample() void
-    obj pool = ResourcePool();
-    
-    # Add resources to pool
-    pool.addResource(FileResource("file1.txt"));
-    pool.addResource(FileResource("file2.txt"));
-    
-    pool.processAll();
-    # All resources cleaned up when pool is destroyed
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="best-practices" class="docs-section">
-                        <h2>Best Practices</h2>
-                        <p>Follow these best practices to write safe and efficient Gem code.</p>
-
-                        <h3>Scope Management</h3>
-                        <ul>
-                            <li><strong>Keep Scopes Small</strong> - Create objects as close to their use as possible</li>
-                            <li><strong>Use Nested Scopes</strong> - Use <code>begin...end</code> blocks for fine-grained control</li>
-                            <li><strong>Avoid Long-Lived Objects</strong> - Prefer creating objects when needed rather than keeping them around</li>
-                        </ul>
-
-                        <h3>Resource Management</h3>
-                        <div class="code-block">
-                            <pre><code># Good: Resources are scoped appropriately
-def goodResourceManagement() void
-    begin
-        obj tempResource = TempResource();
-        tempResource.process();
-        # Cleaned up immediately after use
-    end
-    
-    obj mainResource = MainResource();
-    mainResource.process();
-    # Cleaned up at function end
-end
-
-# Avoid: Unnecessarily long-lived resources
-def avoidThis() void
-    obj tempResource = TempResource();  # Created too early
-    obj mainResource = MainResource();
-    
-    # ... lots of code that doesn't use tempResource ...
-    
-    tempResource.process();  # Used much later
-    mainResource.process();
-    # Both cleaned up at end (tempResource lived too long)
-end</code></pre>
-                        </div>
-
-                        <h3>Error Handling</h3>
-                        <div class="code-block">
-                            <pre><code># Use nullable returns for safe error handling
-def safeFileOperation(string filename) bool
-    obj? file = tryOpenFile(filename);
-    if (file == nil)
-        return false;  # Safe failure
-    end
-    
-    file.process();
-    return true;
-    # file is automatically cleaned up
-end</code></pre>
-                        </div>
-
-                        <h3>Performance Tips</h3>
-                        <ul>
-                            <li><strong>Minimize Object Creation</strong> - Create objects only when necessary</li>
-                            <li><strong>Use Immutable Data</strong> - Immutable objects are more efficient and safer</li>
-                            <li><strong>Prefer Stack Allocation</strong> - Gem's scope-based model is optimized for stack allocation</li>
-                            <li><strong>Avoid Circular References</strong> - Design object relationships to avoid cycles</li>
-                        </ul>
-
-                        <div class="info-box">
-                            <h4>🎯 Memory Safety Philosophy</h4>
-                            <p>Gem's memory safety isn't just about preventing crashes - it's about making your code more predictable, maintainable, and performant. Safe code is often simpler code.</p>
-                        </div>
-                    </section>
-                </article>
-            </div>
-        </div>
-    </main>
-
-    <footer class="footer">
-        <div class="container">
-            <div class="footer-content">
-                <div class="footer-brand">
-                    <span class="gem-icon">💎</span>
-                    <span>Gem Programming Language</span>
-                </div>
-                <div class="footer-links">
-                    <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
-                    <a href="examples.html">Examples</a>
-                </div>
-            </div>
-            <div class="footer-bottom">
-                <p>&copy; 2025 SimuCorps LLC</p>
-            </div>
-        </div>
-    </footer>
-
-    <script src="script.js"></script>
-</body>
-</html> 
\ No newline at end of file
diff --git a/docs/standard-library.html b/docs/standard-library.html
deleted file mode 100644
index 2d94f8f..0000000
--- a/docs/standard-library.html
+++ /dev/null
@@ -1,482 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Standard Library - Gem Programming Language</title>
-    <link rel="stylesheet" href="styles.css">
-    <link rel="stylesheet" href="docs.css">
-    <link rel="icon" type="image/svg+xml" href="favicon.svg">
-</head>
-<body>
-    <nav class="navbar">
-        <div class="nav-container">
-            <div class="nav-brand">
-                <a href="index.html" style="display: flex; align-items: center; gap: 0.5rem; text-decoration: none; color: inherit;">
-                    <span class="gem-icon">💎</span>
-                    <span class="brand-text">Gem</span>
-                </a>
-            </div>
-            <ul class="nav-menu">
-                <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
-                <li><a href="examples.html" class="nav-link">Examples</a></li>
-                <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
-                <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
-            </ul>
-        </div>
-    </nav>
-
-    <main class="docs-main">
-        <div class="container">
-            <div class="docs-layout">
-                <aside class="docs-sidebar">
-                    <nav class="docs-nav">
-                        <h3>Standard Library</h3>
-                        <ul>
-                            <li><a href="#overview">Overview</a></li>
-                            <li><a href="#importing">Importing Modules</a></li>
-                            <li><a href="#math-module">Math Module</a></li>
-                            <li><a href="#http-module">HTTP Module</a></li>
-                            <li><a href="#time-module">Time Module</a></li>
-                        </ul>
-                    </nav>
-                </aside>
-
-                <article class="docs-content">
-                    <header class="docs-header">
-                        <h1>Gem Standard Library</h1>
-                        <p class="docs-subtitle">Reference for Gem's built-in modules and functions</p>
-                    </header>
-
-                    <section id="overview" class="docs-section">
-                        <h2>Standard Library Overview</h2>
-                        <p>Gem comes with a standard library that provides essential functionality for common programming tasks. The standard library is designed to be lightweight, efficient, and type-safe.</p>
-
-                        <h3>Available Modules</h3>
-                        <ul>
-                            <li><strong>Math Module</strong> - Mathematical operations</li>
-                            <li><strong>HTTP Module</strong> - HTTP client functionality for web requests</li>
-                            <li><strong>Time Module</strong> - Time operations, measurements, and duration handling</li>
-                            <li><strong>Core Functions</strong> - Built-in functions available without imports</li>
-                        </ul>
-
-                        <h3>Built-in String Operations</h3>
-                        <p>String operations are handled through built-in operators:</p>
-                        <div class="code-block">
-                            <pre><code># String concatenation (built-in)
-string combined = "Hello" + " World";  # Returns "Hello World"
-
-# String literals
-string greeting = "Hello, Gem!";
-string empty = "";</code></pre>
-                        </div>
-
-                        <h3>Design Principles</h3>
-                        <ul>
-                            <li><strong>Type Safety</strong> - All functions are fully typed with compile-time checking</li>
-                            <li><strong>Immutability</strong> - Functions don't modify their inputs unless explicitly designed to</li>
-                            <li><strong>Null Safety</strong> - Functions handle nullable types safely</li>
-                            <li><strong>Consistency</strong> - Uniform naming and behavior across modules</li>
-                        </ul>
-
-                        <div class="info-box">
-                            <h4>📦 Module System</h4>
-                            <p>Use <code>require "module_name"</code> to import standard library modules.</p>
-                        </div>
-                    </section>
-
-                    <section id="importing" class="docs-section">
-                        <h2>Importing Modules</h2>
-                        <p>Learn how to import and use standard library modules in your Gem programs.</p>
-
-                        <h3>Basic Import Syntax</h3>
-                        <div class="code-block">
-                            <pre><code># Import math module
-require "math";
-
-# Import HTTP module
-require "http";
-
-# Use imported modules
-int sum = Math.add(10, 5);
-hash response = Http.get("https://api.example.com");</code></pre>
-                        </div>
-
-                        <h3>Module Availability</h3>
-                        <div class="info-box">
-                            <h4>📦 Standard Library Modules</h4>
-                            <ul>
-                                <li><code>"math"</code> - Mathematical operations</li>
-                                <li><code>"http"</code> - HTTP client functionality</li>
-                                <li><code>"time"</code> - Time operations and duration handling</li>
-                            </ul>
-                        </div>
-                    </section>
-
-                    <section id="math-module" class="docs-section">
-                        <h2>Math Module</h2>
-                        <p>The Math module provides mathematical operations and utility functions.</p>
-
-                        <h3>Importing the Math Module</h3>
-                        <div class="code-block">
-                            <pre><code>require "math";</code></pre>
-                        </div>
-
-                        <h3>Basic Arithmetic</h3>
-                        <div class="code-block">
-                            <pre><code># Basic operations
-int sum = Math.add(10, 5);           # Returns 15
-int difference = Math.subtract(10, 5); # Returns 5
-int product = Math.multiply(10, 5);   # Returns 50
-int quotient = Math.divide(10, 5);    # Returns 2
-int remainder = Math.modulo(10, 3);   # Returns 1</code></pre>
-                        </div>
-
-                        <h3>Power Operations</h3>
-                        <div class="code-block">
-                            <pre><code># Exponentiation
-int squared = Math.power(5, 2);      # Returns 25
-int cubed = Math.power(3, 3);        # Returns 27
-int power = Math.power(2, 8);        # Returns 256</code></pre>
-                        </div>
-
-                        <h3>Comparison and Selection</h3>
-                        <div class="code-block">
-                            <pre><code># Min/Max operations
-int minimum = Math.min(10, 5);       # Returns 5
-int maximum = Math.max(10, 5);       # Returns 10</code></pre>
-                        </div>
-
-                        <h3>Absolute Value</h3>
-                        <div class="code-block">
-                            <pre><code># Absolute value
-int abs1 = Math.abs(-5);             # Returns 5
-int abs2 = Math.abs(5);              # Returns 5
-int abs3 = Math.abs(0);              # Returns 0</code></pre>
-                        </div>
-
-                        <h3>Math Module Function Reference</h3>
-                        <div class="code-block">
-                            <pre><code># Complete Math module API
-Math.add(int a, int b) int              # Addition
-Math.subtract(int a, int b) int         # Subtraction
-Math.multiply(int a, int b) int         # Multiplication
-Math.divide(int a, int b) int           # Division
-Math.modulo(int a, int b) int           # Modulo operation
-Math.power(int base, int exp) int       # Exponentiation
-Math.abs(int x) int                     # Absolute value
-Math.min(int a, int b) int              # Minimum of two values
-Math.max(int a, int b) int              # Maximum of two values</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="http-module" class="docs-section">
-                        <h2>HTTP Module</h2>
-                        <p>The HTTP module provides a comprehensive HTTP client for making web requests. It supports all major HTTP methods, custom headers, request data, and detailed response handling.</p>
-
-                        <h3>Importing the HTTP Module</h3>
-                        <div class="code-block">
-                            <pre><code>require "http";</code></pre>
-                        </div>
-
-                        <h3>Basic GET Request</h3>
-                        <div class="code-block">
-                            <pre><code># Simple GET request
-hash response = Http.get("https://api.example.com/data");
-
-# Check if request was successful
-bool success = response["success"] as bool;
-int status = response["status"] as int;
-string body = response["body"] as string;
-
-if (success)
-    puts "Request successful!";
-    puts "Status: " + status;
-    puts "Response: " + body;
-else
-    puts "Request failed with status: " + status;
-end</code></pre>
-                        </div>
-
-                        <h3>GET Request with Custom Headers</h3>
-                        <div class="code-block">
-                            <pre><code># GET request with custom headers
-hash headers = {};
-headers["Authorization"] = "Bearer your-token-here";
-headers["Content-Type"] = "application/json";
-headers["User-Agent"] = "MyApp/1.0";
-
-hash response = Http.get("https://api.example.com/protected", headers);
-
-# Access response details
-bool success = response["success"] as bool;
-int status = response["status"] as int;
-string body = response["body"] as string;
-int responseTime = response["response_time"] as int;</code></pre>
-                        </div>
-
-                        <h3>POST Request with Data</h3>
-                        <div class="code-block">
-                            <pre><code># POST request with form data
-hash data = {};
-data["name"] = "John Doe";
-data["email"] = "john@example.com";
-data["age"] = "30";
-
-hash response = Http.post("https://api.example.com/users", data);
-
-if (response["success"] as bool)
-    puts "User created successfully!";
-    puts "Response: " + (response["body"] as string);
-end</code></pre>
-                        </div>
-
-                        <h3>POST Request with JSON and Headers</h3>
-                        <div class="code-block">
-                            <pre><code># POST request with JSON data and custom headers
-hash headers = {};
-headers["Content-Type"] = "application/json";
-headers["Authorization"] = "Bearer token123";
-
-hash jsonData = {};
-jsonData["title"] = "New Post";
-jsonData["content"] = "This is the post content";
-jsonData["published"] = "true";
-
-hash response = Http.post("https://api.example.com/posts", jsonData, headers);
-
-# Check response
-bool success = response["success"] as bool;
-int status = response["status"] as int;
-
-if (success)
-    puts "Post created! Status: " + status;
-else
-    puts "Failed to create post. Status: " + status;
-end</code></pre>
-                        </div>
-
-                        <h3>PUT Request for Updates</h3>
-                        <div class="code-block">
-                            <pre><code># PUT request to update a resource
-hash updateData = {};
-updateData["name"] = "Jane Doe";
-updateData["email"] = "jane@example.com";
-
-hash headers = {};
-headers["Content-Type"] = "application/json";
-
-hash response = Http.put("https://api.example.com/users/123", updateData, headers);
-
-if (response["success"] as bool)
-    puts "User updated successfully!";
-    puts "Response time: " + (response["response_time"] as int) + "ms";
-end</code></pre>
-                        </div>
-
-                        <h3>DELETE Request</h3>
-                        <div class="code-block">
-                            <pre><code># DELETE request with authorization
-hash headers = {};
-headers["Authorization"] = "Bearer admin-token";
-
-hash response = Http.delete("https://api.example.com/users/123", headers);
-
-bool success = response["success"] as bool;
-int status = response["status"] as int;
-
-if (success)
-    puts "Resource deleted successfully!";
-else
-    puts "Failed to delete resource. Status: " + status;
-end</code></pre>
-                        </div>
-
-                        <h3>Error Handling</h3>
-                        <div class="code-block">
-                            <pre><code># Comprehensive error handling
-hash response = Http.get("https://invalid-url-example.com");
-
-bool success = response["success"] as bool;
-int status = response["status"] as int;
-
-if (!success)
-    if (status == 0)
-        puts "Network error or invalid URL";
-    elsif (status == 404)
-        puts "Resource not found";
-    elsif (status == 500)
-        puts "Server error";
-    else
-        puts "Request failed with status: " + status;
-    end
-else
-    puts "Request successful!";
-    string body = response["body"] as string;
-    puts "Response: " + body;
-end</code></pre>
-                        </div>
-
-                        <h3>Performance Monitoring</h3>
-                        <div class="code-block">
-                            <pre><code># Monitor request performance
-hash response = Http.get("https://api.example.com/data");
-
-int responseTime = response["response_time"] as int;
-bool success = response["success"] as bool;
-
-puts "Request completed in " + responseTime + " microseconds";
-
-if (responseTime > 1000000)  # 1 second in microseconds
-    puts "Warning: Slow response detected";
-end</code></pre>
-                        </div>
-
-                        <h3>HTTP Module Function Reference</h3>
-                        <div class="code-block">
-                            <pre><code># Complete HTTP module API
-
-# GET requests
-Http.get(string url) hash                           # Simple GET
-Http.get(string url, hash headers) hash             # GET with headers
-
-# POST requests  
-Http.post(string url, hash data) hash               # POST with data
-Http.post(string url, hash data, hash headers) hash # POST with data and headers
-
-# PUT requests
-Http.put(string url, hash data) hash                # PUT with data
-Http.put(string url, hash data, hash headers) hash  # PUT with data and headers
-
-# DELETE requests
-Http.delete(string url) hash                        # Simple DELETE
-Http.delete(string url, hash headers) hash          # DELETE with headers
-
-# Response hash structure:
-# {
-#   "success": bool,        # Whether request succeeded
-#   "status": int,          # HTTP status code (0 for network errors)
-#   "body": string,         # Response body content
-#   "response_time": int    # Response time in microseconds
-# }</code></pre>
-                        </div>
-
-                        <h3>Common HTTP Status Codes</h3>
-                        <div class="info-box">
-                            <h4>📡 HTTP Status Codes</h4>
-                            <ul>
-                                <li><code>200</code> - OK (Success)</li>
-                                <li><code>201</code> - Created</li>
-                                <li><code>400</code> - Bad Request</li>
-                                <li><code>401</code> - Unauthorized</li>
-                                <li><code>403</code> - Forbidden</li>
-                                <li><code>404</code> - Not Found</li>
-                                <li><code>500</code> - Internal Server Error</li>
-                                <li><code>0</code> - Network Error/Invalid URL</li>
-                            </ul>
-                        </div>
-                    </section>
-
-                    <section id="time-module" class="docs-section">
-                        <h2>Time Module</h2>
-                        <p>The Time module provides basic time-related functionality including current time access, sleep operations, and function timing.</p>
-
-                        <h3>Importing the Time Module</h3>
-                        <div class="code-block">
-                            <pre><code>require "time";</code></pre>
-                        </div>
-
-                        <h3>Current Time</h3>
-                        <div class="code-block">
-                            <pre><code># Get current time as floating-point timestamp
-puts "Current timestamp: #{Time.now()}";</code></pre>
-                        </div>
-
-                        <h3>Sleep Operations</h3>
-                        <div class="code-block">
-                            <pre><code># Sleep for a specified number of milliseconds
-puts "Starting operation...";
-Time.sleep(2000);  # Sleep for 2 seconds (2000 milliseconds)
-puts "Operation completed after delay";</code></pre>
-                        </div>
-
-                        <h3>Function Timing</h3>
-                        <div class="code-block">
-                            <pre><code># Measure execution time of a function
-def slowOperation() void
-    Time.sleep(1000);  # Sleep for 1 second (1000 milliseconds)
-    puts "Slow operation completed";
-end
-
-# Measure function execution
-Time.measure(slowOperation);</code></pre>
-                        </div>
-
-                        <h3>Timeout Operations</h3>
-                        <div class="code-block">
-                            <pre><code># Attempt to run function with timeout
-def quickOperation() void
-    puts "Quick operation";
-end
-
-def slowOperation() void
-    Time.sleep(5000);  # Sleep for 5 seconds (5000 milliseconds)
-    puts "This takes too long";
-end
-
-Time.timeout(quickOperation, 2);  # 2 second timeout
-Time.timeout(slowOperation, 2);   # 2 second timeout</code></pre>
-                        </div>
-
-                        <h3>Practical Time Examples</h3>
-                        <div class="code-block">
-                            <pre><code># Simple timing and sleep operations
-def timedWork() void
-    puts "Starting work...";
-    Time.sleep(1500);  # 1.5 seconds of work
-    puts "Work completed";
-end
-
-# Measure the work
-puts "Timing work operation:";
-Time.measure(timedWork);
-
-# Multiple sleep operations
-puts "Sleep sequence:";
-Time.sleep(500);   # 0.5 seconds
-puts "Step 1 complete";
-Time.sleep(1000);  # 1.0 seconds  
-puts "Step 2 complete";
-Time.sleep(750);   # 0.75 seconds
-puts "All steps complete";</code></pre>
-                        </div>
-                    </section>
-                </article>
-            </div>
-        </div>
-    </main>
-
-    <footer class="footer">
-        <div class="container">
-            <div class="footer-content">
-                <div class="footer-brand">
-                    <span class="gem-icon">💎</span>
-                    <span>Gem Programming Language</span>
-                </div>
-                <div class="footer-links">
-                    <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
-                    <a href="examples.html">Examples</a>
-                </div>
-            </div>
-            <div class="footer-bottom">
-                <p>&copy; 2025 SimuCorps LLC</p>
-            </div>
-        </div>
-    </footer>
-
-    <script src="script.js"></script>
-</body>
-</html> 
\ No newline at end of file
diff --git a/docs/type-system.html b/docs/type-system.html
deleted file mode 100644
index 918fab0..0000000
--- a/docs/type-system.html
+++ /dev/null
@@ -1,603 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Type System - Gem Programming Language</title>
-    <link rel="stylesheet" href="styles.css">
-    <link rel="stylesheet" href="docs.css">
-    <link rel="icon" type="image/svg+xml" href="favicon.svg">
-</head>
-<body>
-    <nav class="navbar">
-        <div class="nav-container">
-            <div class="nav-brand">
-                <a href="index.html" style="display: flex; align-items: center; gap: 0.5rem; text-decoration: none; color: inherit;">
-                    <span class="gem-icon">💎</span>
-                    <span class="brand-text">Gem</span>
-                </a>
-            </div>
-            <ul class="nav-menu">
-                <li><a href="index.html" class="nav-link">Home</a></li>
-                <li><a href="getting-started.html" class="nav-link">Getting Started</a></li>
-                <li><a href="language-guide.html" class="nav-link">Language Guide</a></li>
-                <li><a href="examples.html" class="nav-link">Examples</a></li>
-                <li><a href="changeblog.html" class="nav-link">Changeblog</a></li>
-                <li><a href="https://github.com/SimuCorps/Gem" class="nav-link" target="_blank">GitHub</a></li>
-            </ul>
-        </div>
-    </nav>
-
-    <main class="docs-main">
-        <div class="container">
-            <div class="docs-layout">
-                <aside class="docs-sidebar">
-                    <nav class="docs-nav">
-                        <h3>Type System</h3>
-                        <ul>
-                            <li><a href="#overview">Overview</a></li>
-                            <li><a href="#basic-types">Basic Types</a></li>
-                            <li><a href="#mutability">Mutability Control</a></li>
-                            <li><a href="#nullability">Nullability Safety</a></li>
-                            <li><a href="#combined">Combined Modifiers</a></li>
-                            <li><a href="#type-checking">Type Checking</a></li>
-                            <li><a href="#advanced">Advanced Features</a></li>
-                        </ul>
-                    </nav>
-                </aside>
-
-                <article class="docs-content">
-                    <header class="docs-header">
-                        <h1>Gem Type System</h1>
-                        <p class="docs-subtitle">Deep dive into Gem's enhanced type system with mutability and nullability control</p>
-                    </header>
-
-                    <section id="overview" class="docs-section">
-                        <h2>Type System Overview</h2>
-                        <p>Gem's type system is designed to prevent common programming errors while maintaining elegance and expressiveness. It provides compile-time safety without sacrificing readability.</p>
-
-                        <h3>Core Principles</h3>
-                        <ul>
-                            <li><strong>Static Typing</strong> - All types are known at compile time</li>
-                            <li><strong>Explicit Types</strong> - Variables must have declared types</li>
-                            <li><strong>Immutable by Default</strong> - Variables cannot be reassigned unless explicitly marked mutable</li>
-                            <li><strong>Null Safety</strong> - Null pointer exceptions are prevented by design</li>
-                            <li><strong>Zero Runtime Cost</strong> - Type safety checks happen at compile time</li>
-                        </ul>
-
-                        <div class="info-box">
-                            <h4>🎯 Design Philosophy</h4>
-                            <p>Gem's type system provides developer happiness with compile-time guarantees, without syntactic complexity.</p>
-                        </div>
-                    </section>
-
-                    <section id="basic-types" class="docs-section">
-                        <h2>Basic Types</h2>
-                        <p>Gem provides a small set of fundamental types that cover most programming needs.</p>
-
-                        <h3>Primitive Types</h3>
-                        <div class="code-block">
-                            <pre><code># Integer type
-int age = 25;
-int population = 1000000;
-int negative = -42;
-
-# String type
-string name = "Alice";
-string message = "Hello, World!";
-string empty = "";
-
-# Boolean type
-bool isActive = true;
-bool isComplete = false;
-
-# Hash type (key-value data structure)
-hash! userInfo = {"name": "Bob", "age": 30};
-hash readonlyData = {"version": "1.0", "stable": true};
-
-# Special types
-void        # Used for functions that don't return a value
-func        # Function type for first-class functions
-obj         # Object type for class instances</code></pre>
-                        </div>
-
-                        <h3>Type Declarations</h3>
-                        <div class="code-block">
-                            <pre><code># Basic syntax: type name = value;
-int count = 0;
-string greeting = "Hello";
-bool flag = true;
-
-# All variables must be initialized
-# int uninitialized;  # ❌ Error: Variables must be initialized
-
-# Type must match the assigned value
-# int number = "text";  # ❌ Error: Type mismatch</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="mutability" class="docs-section">
-                        <h2>Mutability Control</h2>
-                        <p>One of Gem's most powerful features is its explicit mutability control. Variables are immutable by default, preventing accidental modifications and making code more predictable.</p>
-
-                        <h3>Immutable Variables (Default)</h3>
-                        <div class="code-block">
-                            <pre><code># Variables are immutable by default
-string name = "Alice";
-int age = 25;
-bool isActive = true;
-
-# Attempting to modify immutable variables causes compile errors
-# name = "Bob";        # ❌ Error: Cannot assign to immutable variable
-# age = 26;           # ❌ Error: Cannot assign to immutable variable
-# isActive = false;   # ❌ Error: Cannot assign to immutable variable</code></pre>
-                        </div>
-
-                        <h3>Mutable Variables</h3>
-                        <p>To make variables mutable, use the <code>mut</code> keyword (recommended) or the <code>!</code> suffix (syntactic sugar):</p>
-
-                        <div class="code-block">
-                            <pre><code># Recommended syntax with 'mut' keyword
-mut string name = "Alice";
-mut int counter = 0;
-mut bool flag = false;
-
-# Alternative syntax with '!' suffix (syntactic sugar)
-string! altName = "Bob";
-int! altCounter = 0;
-bool! altFlag = false;
-
-# Mutable variables can be reassigned
-name = "Bob";                    # ✅ Valid: Variable is mutable
-counter = counter + 1;           # ✅ Valid: Variable is mutable
-flag = !flag;                    # ✅ Valid: Variable is mutable</code></pre>
-                        </div>
-
-                        <h3>Function Parameters</h3>
-                        <div class="code-block">
-                            <pre><code># Function parameters are immutable by default
-def processText(string text) string
-    # text = "modified";  # ❌ Error: Cannot modify immutable parameter
-    return "Processed: " + text;
-end
-
-# Mutable parameters (recommended syntax)
-def incrementCounter(mut int counter) void
-    counter = counter + 1;  # ✅ Valid: Parameter is mutable
-end
-
-# Mutable parameters (alternative syntax)
-def incrementCounterAlt(int! counter) void
-    counter = counter + 1;  # ✅ Valid: Parameter is mutable
-end
-
-# Mixed parameter types
-def processData(string data, mut int counter, bool flag) string
-    # data = "new";      # ❌ Error: data is immutable
-    counter = counter + 1; # ✅ Valid: counter is mutable
-    # flag = !flag;      # ❌ Error: flag is immutable
-    return data + " processed";
-end</code></pre>
-                        </div>
-
-                        <h3>Benefits of Immutability</h3>
-                        <ul>
-                            <li><strong>Prevents Bugs</strong> - Accidental modifications are caught at compile time</li>
-                            <li><strong>Easier Reasoning</strong> - Values don't change unexpectedly</li>
-                            <li><strong>Thread Safety</strong> - Immutable data is inherently thread-safe</li>
-                            <li><strong>Functional Style</strong> - Encourages functional programming patterns</li>
-                        </ul>
-                    </section>
-
-                    <section id="nullability" class="docs-section">
-                        <h2>Nullability Safety</h2>
-                        <p>Gem eliminates null pointer exceptions through its nullability system. Variables cannot be null unless explicitly marked as nullable.</p>
-
-                        <h3>Non-Nullable Types (Default)</h3>
-                        <div class="code-block">
-                            <pre><code># Variables are non-nullable by default
-string name = "Alice";
-int age = 25;
-obj person = Person("Bob");
-
-# Cannot assign nil to non-nullable variables
-# name = nil;    # ❌ Error: Cannot assign nil to non-nullable variable
-# age = nil;     # ❌ Error: Cannot assign nil to non-nullable variable
-# person = nil;  # ❌ Error: Cannot assign nil to non-nullable variable</code></pre>
-                        </div>
-
-                        <h3>Nullable Types</h3>
-                        <div class="code-block">
-                            <pre><code># Use ? suffix to allow nil values
-string? optionalName = nil;
-int? optionalAge = nil;
-obj? optionalPerson = nil;
-
-# Nullable variables can be assigned both values and nil
-optionalName = "Alice";     # ✅ Valid
-optionalName = nil;         # ✅ Valid
-
-optionalAge = 25;           # ✅ Valid
-optionalAge = nil;          # ✅ Valid</code></pre>
-                        </div>
-
-                        <h3>Safe Null Checking</h3>
-                        <div class="code-block">
-                            <pre><code># Must check for nil before using nullable values
-def greetOptional(string? name) string
-    if (name != nil)
-        return "Hello, " + name;  # Safe: name is guaranteed non-nil here
-    else
-        return "Hello, stranger!";
-    end
-end
-
-# Using nullable values
-string? userName = getUserName();
-if (userName != nil)
-    puts "Welcome, " + userName;
-else
-    puts "Please log in";
-end</code></pre>
-                        </div>
-
-                        <h3>Nullable Function Returns</h3>
-                        <div class="code-block">
-                            <pre><code># Functions can return nullable types for error handling
-def divide(int x, int y) int?
-    if (y == 0)
-        return nil;  # Return nil for division by zero
-    else
-        return x / y;
-    end
-end
-
-# Safe usage of nullable returns
-int? result = divide(10, 2);
-if (result != nil)
-    puts "Result: " + result;
-else
-    puts "Division by zero!";
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="combined" class="docs-section">
-                        <h2>Combined Modifiers</h2>
-                        <p>Gem allows combining mutability and nullability modifiers for maximum flexibility.</p>
-
-                        <h3>Mutable and Nullable (?)</h3>
-                        <p>Variables can be both mutable and nullable using either syntax:</p>
-
-                        <div class="code-block">
-                            <pre><code># Variables that are both mutable and nullable (recommended)
-mut string? mutableOptional = nil;
-mut int? counter = 0;
-mut obj? currentUser = nil;
-
-# Alternative syntax with '?!' suffix
-string?! altMutableOptional = nil;
-int?! altCounter = 0;
-obj?! altCurrentUser = nil;
-
-# Both syntaxes work identically
-mutableOptional = "Hello";      # ✅ Valid
-mutableOptional = nil;          # ✅ Valid
-mutableOptional = "World";      # ✅ Valid</code></pre>
-                        </div>
-
-                        <h3>All Modifier Combinations</h3>
-                        <div class="code-block">
-                            <pre><code># All possible type modifier combinations (recommended syntax)
-string name = "Alice";              # Immutable, non-nullable
-mut string mutableName = "Bob";     # Mutable, non-nullable
-string? optionalName = nil;         # Immutable, nullable
-mut string? flexibleName = nil;     # Mutable, nullable
-
-# Alternative syntax with suffixes
-string! altMutableName = "Charlie"; # Mutable, non-nullable (alternative)
-string?! altFlexibleName = nil;     # Mutable, nullable (alternative)
-
-# Usage patterns
-def processUser(mut string? currentUser) void
-    if (currentUser == nil)
-        currentUser = getDefaultUser();  # Can assign because mutable
-    end
-    
-    if (currentUser != nil)
-        currentUser.process();           # Safe because checked
-    end
-end</code></pre>
-                        </div>
-
-                        <h3>Function Parameters with Modifiers</h3>
-                        <div class="code-block">
-                            <pre><code># Functions with various parameter types (recommended syntax)
-def complexFunction(
-    string data,               # Immutable, non-nullable
-    mut string buffer,         # Mutable, non-nullable
-    string? optional,          # Immutable, nullable
-    mut string? flexible       # Mutable, nullable
-) string
-    # Process each parameter according to its type
-    if (optional != nil)
-        buffer = buffer + optional;
-    end
-    
-    if (flexible == nil)
-        flexible = "default";
-    end
-    
-    return buffer + data;
-end
-
-# Alternative syntax with suffixes
-def complexFunctionAlt(
-    string data,               # Immutable, non-nullable
-    string! buffer,            # Mutable, non-nullable (alternative)
-    string? optional,          # Immutable, nullable
-    string?! flexible          # Mutable, nullable (alternative)
-) string
-    # Same functionality with alternative syntax
-    if (optional != nil)
-        buffer = buffer + optional;
-    end
-    
-    if (flexible == nil)
-        flexible = "default";
-    end
-    
-    return buffer + data;
-end</code></pre>
-                        </div>
-
-                        <h3>Complete Example</h3>
-                        <div class="code-block">
-                            <pre><code># Different variable types with recommended syntax
-string name = "Alice";              # Immutable, non-nullable
-mut string mutableName = "Bob";     # Mutable, non-nullable
-string? optionalName = nil;         # Immutable, nullable
-mut string? flexibleName = nil;     # Mutable, nullable
-
-# Alternative syntax with suffixes
-string! altMutableName = "Charlie"; # Mutable, non-nullable (alternative)
-string?! altFlexibleName = nil;     # Mutable, nullable (alternative)
-
-# Function using mutable nullable parameter
-def processUser(mut string? currentUser) void
-    currentUser = getDefaultUser();  # Can assign because mutable
-    if (currentUser != nil)
-        puts "Processing: " + currentUser;
-    end
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="type-checking" class="docs-section">
-                        <h2>Compile-Time Type Checking</h2>
-                        <p>Gem performs comprehensive type checking at compile time, catching errors before your code runs.</p>
-
-                        <h3>Type Mismatch Detection</h3>
-                        <div class="code-block">
-                            <pre><code># Type mismatches are caught at compile time
-int age = 25;
-string name = "Alice";
-
-# These would cause compile errors:
-# age = "twenty-five";    # ❌ Error: Cannot assign string to int
-# name = 42;              # ❌ Error: Cannot assign int to string
-# age = name;             # ❌ Error: Cannot assign string to int</code></pre>
-                        </div>
-
-                        <h3>Function Type Checking</h3>
-                        <div class="code-block">
-                            <pre><code># Function signatures are strictly enforced
-def greet(string name, int age) string
-    return "Hello #{name}, age #{age}";
-end
-
-# Correct usage
-string greeting = greet("Alice", 25);
-
-# These would cause compile errors:
-# greet(25, "Alice");           # ❌ Error: Wrong argument types
-# greet("Alice");               # ❌ Error: Missing argument
-# greet("Alice", 25, true);     # ❌ Error: Too many arguments
-# int result = greet("Alice", 25); # ❌ Error: Wrong return type</code></pre>
-                        </div>
-
-                        <h3>Mutability Checking</h3>
-                        <div class="code-block">
-                            <pre><code># Mutability violations are caught at compile time
-string immutable = "Hello";
-string! mutable = "World";
-
-# These would cause compile errors:
-# immutable = "Hi";             # ❌ Error: Cannot modify immutable
-# immutable = mutable;          # ❌ Error: Cannot modify immutable
-
-# Valid operations
-mutable = "Hi";                 # ✅ Valid: mutable variable
-mutable = immutable;            # ✅ Valid: reading immutable is fine</code></pre>
-                        </div>
-
-                        <h3>Nullability Checking</h3>
-                        <div class="code-block">
-                            <pre><code># Null safety violations are caught at compile time
-string name = "Alice";
-string? optionalName = nil;
-
-# These would cause compile errors:
-# name = nil;                   # ❌ Error: Cannot assign nil to non-nullable
-# puts optionalName;            # ❌ Error: Must check for nil first
-
-# Safe operations
-if (optionalName != nil)
-    puts optionalName;          # ✅ Valid: nil check performed
-end</code></pre>
-                        </div>
-                    </section>
-
-                    <section id="advanced" class="docs-section">
-                        <h2>Advanced Type Features</h2>
-                        <p>Gem's type system includes advanced features for complex programming scenarios.</p>
-
-                        <h3>Function Types</h3>
-                        <div class="code-block">
-                            <pre><code># Functions are first-class values with types
-def add(int x, int y) int
-    return x + y;
-end
-
-def multiply(int x, int y) int
-    return x * y;
-end
-
-# Functions can be passed as parameters
-def calculate(int x, int y, func operation) int
-    return operation(x, y);
-end
-
-# Usage
-int sum = calculate(5, 3, add);        # 8
-int product = calculate(5, 3, multiply); # 15</code></pre>
-                        </div>
-
-                        <h3>Object Types</h3>
-                        <div class="code-block">
-                            <pre><code># Classes define object types
-class Person
-    def init(string name, int age) void
-        this.name = name;
-        this.age = age;
-    end
-    
-    def greet() string
-        return "Hello, I'm " + this.name;
-    end
-end
-
-# Object variables have the obj type
-obj person = Person("Alice", 25);
-obj? optionalPerson = nil;
-
-# Type checking applies to objects
-# person = "not an object";     # ❌ Error: Type mismatch</code></pre>
-                        </div>
-
-                        <h3>Type Safety in Practice</h3>
-                        <div class="code-block">
-                            <pre><code># Real-world example: User management system
-class User
-    def init(string name, string? email) void
-        this.name = name;
-        this.email = email;
-    end
-    
-    def hasEmail() bool
-        return this.email != nil;
-    end
-    
-    def getDisplayName() string
-        if (this.email != nil)
-            return this.name + " (" + this.email + ")";
-        else
-            return this.name;
-        end
-    end
-end
-
-# Type-safe user management
-obj?! currentUser = nil;
-
-def login(string username, string? email) bool
-    if (username != "")
-        currentUser = User(username, email);
-        return true;
-    else
-        return false;
-    end
-end
-
-def logout() void
-    currentUser = nil;
-end
-
-def getCurrentUserName() string?
-    if (currentUser != nil)
-        return currentUser.name;
-    else
-        return nil;
-    end
-end</code></pre>
-                        </div>
-
-                        <h3>Type Coercion</h3>
-                        <p>Gem provides explicit type coercion using the <code>as</code> keyword.</p>
-                        
-                        <div class="code-block">
-                            <pre><code># Explicit type conversions with 'as' keyword
-int number = 42;
-string numberStr = number as string;        # "42"
-
-string numericStr = "123";
-int parsed = numericStr as int;             # 123
-
-bool isActive = true;
-string activeStr = isActive as string;     # "true"
-
-# Only false and nil are falsey
-int zero = 0;
-bool zeroIsTruthy = zero as bool;          # true
-
-string empty = "";
-bool emptyIsTruthy = empty as bool;        # true
-
-bool stillFalse = false as bool;           # false
-bool nilIsFalse = nil as bool;             # false
-
-# Hash value coercion
-hash! userData = {"name": "Alice", "age": 25, "score": 0};
-string name = userData["name"] as string;
-int age = userData["age"] as int;
-bool scoreActive = userData["score"] as bool;  # true (0 is truthy!)</code></pre>
-                        </div>
-
-                        <div class="info-box">
-                            <h4>💡 Type System Benefits</h4>
-                            <ul>
-                                <li><strong>Eliminates Runtime Errors</strong> - Null pointer exceptions and type errors are impossible</li>
-                                <li><strong>Better IDE Support</strong> - Accurate autocomplete and refactoring tools</li>
-                                <li><strong>Self-Documenting Code</strong> - Types serve as inline documentation</li>
-                                <li><strong>Fearless Refactoring</strong> - Type checker catches breaking changes</li>
-                                <li><strong>Performance</strong> - No runtime type checking overhead</li>
-                            </ul>
-                        </div>
-                    </section>
-                </article>
-            </div>
-        </div>
-    </main>
-
-    <footer class="footer">
-        <div class="container">
-            <div class="footer-content">
-                <div class="footer-brand">
-                    <span class="gem-icon">💎</span>
-                    <span>Gem Programming Language</span>
-                </div>
-                <div class="footer-links">
-                    <a href="https://github.com/SimuCorps/Gem" target="_blank">GitHub</a>
-                    <a href="getting-started.html">Documentation</a>
-                    <a href="examples.html">Examples</a>
-                </div>
-            </div>
-            <div class="footer-bottom">
-                <p>&copy; 2025 SimuCorps LLC</p>
-            </div>
-        </div>
-    </footer>
-
-    <script src="script.js"></script>
-</body>
-</html> 
\ No newline at end of file

From 3e77d7447d3a27922f8a62f36328b7dba25d53a4 Mon Sep 17 00:00:00 2001
From: Zebulun McNeill <zeb.mcn@gmail.com>
Date: Fri, 30 May 2025 19:09:01 -0500
Subject: [PATCH 2/2] sidebar condense, better interactivity

---
 docs/docs.css  | 149 ++++++++++++++++++++++++++++++++++++++++++++++---
 docs/docs.html |  74 ++++++++++++++++--------
 docs/script.js |  74 +++++++++++++++++++++++-
 3 files changed, 265 insertions(+), 32 deletions(-)

diff --git a/docs/docs.css b/docs/docs.css
index 683707d..34f9d98 100644
--- a/docs/docs.css
+++ b/docs/docs.css
@@ -20,6 +20,27 @@
     border-radius: var(--border-radius);
     padding: 1.5rem;
     border: 1px solid var(--border-color);
+    max-height: calc(100vh - 8rem);
+    overflow-y: auto;
+    scrollbar-width: thin;
+    scrollbar-color: var(--border-color) transparent;
+}
+
+.docs-sidebar::-webkit-scrollbar {
+    width: 6px;
+}
+
+.docs-sidebar::-webkit-scrollbar-track {
+    background: transparent;
+}
+
+.docs-sidebar::-webkit-scrollbar-thumb {
+    background: var(--border-color);
+    border-radius: 3px;
+}
+
+.docs-sidebar::-webkit-scrollbar-thumb:hover {
+    background: var(--text-secondary);
 }
 
 .docs-nav h3 {
@@ -31,31 +52,133 @@
     border-bottom: 1px solid var(--border-color);
 }
 
-.docs-nav ul {
+/* Navigation sections */
+.nav-section {
+    margin-bottom: 0.75rem;
+}
+
+.nav-section-toggle {
+    width: 100%;
+    background: none;
+    border: none;
+    padding: 0.75rem;
+    text-align: left;
+    font-size: 0.9rem;
+    font-weight: 600;
+    color: var(--text-primary);
+    cursor: pointer;
+    border-radius: 0.375rem;
+    transition: all 0.2s ease;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+}
+
+.nav-section-toggle:hover {
+    background: var(--bg-tertiary);
+}
+
+.nav-section-toggle.active {
+    background: var(--primary-color);
+    color: white;
+}
+
+.toggle-icon {
+    font-size: 0.75rem;
+    transition: transform 0.2s ease;
+    width: 12px;
+    text-align: center;
+}
+
+.nav-section-toggle.active .toggle-icon {
+    transform: rotate(0deg);
+}
+
+.nav-section-content {
     list-style: none;
     margin: 0;
     padding: 0;
+    overflow: hidden;
+    transition: max-height 0.3s ease, opacity 0.2s ease;
+    max-height: 500px;
+    opacity: 1;
 }
 
-.docs-nav li {
-    margin-bottom: 0.5rem;
+.nav-section-content.collapsed {
+    max-height: 0;
+    opacity: 0;
+}
+
+.nav-section-content li {
+    margin-bottom: 0.25rem;
 }
 
-.docs-nav a {
+.nav-section-content a {
     color: var(--text-secondary);
     text-decoration: none;
-    font-size: 0.9rem;
-    padding: 0.5rem 0.75rem;
+    font-size: 0.85rem;
+    padding: 0.5rem 0.75rem 0.5rem 1.5rem;
     border-radius: 0.25rem;
     display: block;
     transition: all 0.2s ease;
+    position: relative;
 }
 
-.docs-nav a:hover {
+.nav-section-content a:before {
+    content: '';
+    position: absolute;
+    left: 0.75rem;
+    top: 50%;
+    transform: translateY(-50%);
+    width: 4px;
+    height: 4px;
+    background: var(--text-secondary);
+    border-radius: 50%;
+    opacity: 0.5;
+}
+
+.nav-section-content a:hover {
     background: var(--primary-color);
     color: white;
 }
 
+.nav-section-content a:hover:before {
+    background: white;
+    opacity: 1;
+}
+
+.nav-section-content a.active {
+    background: var(--accent-color);
+    color: white;
+    font-weight: 500;
+}
+
+.nav-section-content a.active:before {
+    background: white;
+    opacity: 1;
+}
+
+/* Copy button for code blocks */
+.copy-button {
+    position: absolute;
+    top: 0.75rem;
+    right: 0.75rem;
+    background: rgba(255, 255, 255, 0.1);
+    border: 1px solid rgba(255, 255, 255, 0.2);
+    border-radius: 0.25rem;
+    padding: 0.5rem;
+    color: #e2e8f0;
+    cursor: pointer;
+    font-size: 0.875rem;
+    transition: all 0.2s ease;
+    z-index: 10;
+}
+
+.copy-button:hover {
+    background: rgba(255, 255, 255, 0.2);
+    border-color: rgba(255, 255, 255, 0.3);
+}
+
 /* Content */
 .docs-content {
     max-width: none;
@@ -280,6 +403,18 @@ kbd {
         position: static;
         order: 2;
         margin-top: 2rem;
+        max-height: none;
+        overflow-y: visible;
+    }
+    
+    .nav-section-toggle {
+        padding: 1rem;
+        font-size: 1rem;
+    }
+    
+    .nav-section-content a {
+        padding: 0.75rem 1rem 0.75rem 2rem;
+        font-size: 0.9rem;
     }
     
     .docs-content {
diff --git a/docs/docs.html b/docs/docs.html
index 25e792d..640bd14 100644
--- a/docs/docs.html
+++ b/docs/docs.html
@@ -33,29 +33,57 @@
                 <aside class="docs-sidebar">
                     <nav class="docs-nav">
                         <h3>Documentation</h3>
-                        <ul>
-                            <li><a href="#getting-started">Getting Started</a></li>
-                            <li><a href="#installation">Installation</a></li>
-                            <li><a href="#first-program">Your First Program</a></li>
-                            <li><a href="#repl">Interactive REPL</a></li>
-                            <li><a href="#basic-concepts">Basic Concepts</a></li>
-                            <li><a href="#overview">Language Overview</a></li>
-                            <li><a href="#syntax">Syntax</a></li>
-                            <li><a href="#types">Type System</a></li>
-                            <li><a href="#hashes">Hashes</a></li>
-                            <li><a href="#type-coercion">Type Coercion</a></li>
-                            <li><a href="#variables">Variables</a></li>
-                            <li><a href="#functions">Functions</a></li>
-                            <li><a href="#classes">Classes</a></li>
-                            <li><a href="#control-flow">Control Flow</a></li>
-                            <li><a href="#modules">Modules</a></li>
-                            <li><a href="#memory">Memory Safety</a></li>
-                            <li><a href="#standard-library">Standard Library</a></li>
-                            <li><a href="#importing">Importing Modules</a></li>
-                            <li><a href="#math-module">Math Module</a></li>
-                            <li><a href="#http-module">HTTP Module</a></li>
-                            <li><a href="#time-module">Time Module</a></li>
-                        </ul>
+                        
+                        <!-- Getting Started Section -->
+                        <div class="nav-section">
+                            <button class="nav-section-toggle active" data-section="getting-started" aria-expanded="true" aria-controls="getting-started-content">
+                                <span class="toggle-icon">▼</span>
+                                Getting Started
+                            </button>
+                            <ul class="nav-section-content" id="getting-started-content">
+                                <li><a href="#getting-started">Overview</a></li>
+                                <li><a href="#installation">Installation</a></li>
+                                <li><a href="#first-program">Your First Program</a></li>
+                                <li><a href="#repl">Interactive REPL</a></li>
+                                <li><a href="#basic-concepts">Basic Concepts</a></li>
+                            </ul>
+                        </div>
+
+                        <!-- Language Guide Section -->
+                        <div class="nav-section">
+                            <button class="nav-section-toggle" data-section="language" aria-expanded="false" aria-controls="language-content">
+                                <span class="toggle-icon">▶</span>
+                                Language Guide
+                            </button>
+                            <ul class="nav-section-content collapsed" id="language-content">
+                                <li><a href="#overview">Language Overview</a></li>
+                                <li><a href="#syntax">Syntax</a></li>
+                                <li><a href="#types">Type System</a></li>
+                                <li><a href="#hashes">Hashes</a></li>
+                                <li><a href="#type-coercion">Type Coercion</a></li>
+                                <li><a href="#variables">Variables</a></li>
+                                <li><a href="#functions">Functions</a></li>
+                                <li><a href="#classes">Classes</a></li>
+                                <li><a href="#control-flow">Control Flow</a></li>
+                                <li><a href="#modules">Modules</a></li>
+                                <li><a href="#memory">Memory Safety</a></li>
+                            </ul>
+                        </div>
+
+                        <!-- Standard Library Section -->
+                        <div class="nav-section">
+                            <button class="nav-section-toggle" data-section="stdlib" aria-expanded="false" aria-controls="stdlib-content">
+                                <span class="toggle-icon">▶</span>
+                                Standard Library
+                            </button>
+                            <ul class="nav-section-content collapsed" id="stdlib-content">
+                                <li><a href="#standard-library">Overview</a></li>
+                                <li><a href="#importing">Importing Modules</a></li>
+                                <li><a href="#math-module">Math Module</a></li>
+                                <li><a href="#http-module">HTTP Module</a></li>
+                                <li><a href="#time-module">Time Module</a></li>
+                            </ul>
+                        </div>
                     </nav>
                 </aside>
 
diff --git a/docs/script.js b/docs/script.js
index 3a48802..19df010 100644
--- a/docs/script.js
+++ b/docs/script.js
@@ -1,7 +1,41 @@
 // Smooth scrolling for navigation links
 document.addEventListener('DOMContentLoaded', function() {
+    // Handle collapsible sidebar sections
+    const sectionToggles = document.querySelectorAll('.nav-section-toggle');
+    
+    sectionToggles.forEach(toggle => {
+        toggle.addEventListener('click', function() {
+            const content = this.nextElementSibling;
+            const icon = this.querySelector('.toggle-icon');
+            const isActive = this.classList.contains('active');
+            
+            if (isActive) {
+                // Collapse this section
+                this.classList.remove('active');
+                this.setAttribute('aria-expanded', 'false');
+                content.classList.add('collapsed');
+                icon.textContent = '▶';
+            } else {
+                // Expand this section and collapse others
+                sectionToggles.forEach(otherToggle => {
+                    if (otherToggle !== this) {
+                        otherToggle.classList.remove('active');
+                        otherToggle.setAttribute('aria-expanded', 'false');
+                        otherToggle.nextElementSibling.classList.add('collapsed');
+                        otherToggle.querySelector('.toggle-icon').textContent = '▶';
+                    }
+                });
+                
+                this.classList.add('active');
+                this.setAttribute('aria-expanded', 'true');
+                content.classList.remove('collapsed');
+                icon.textContent = '▼';
+            }
+        });
+    });
+
     // Handle navigation link clicks
-    const navLinks = document.querySelectorAll('.nav-link[href^="#"]');
+    const navLinks = document.querySelectorAll('.nav-link[href^="#"], .nav-section-content a[href^="#"]');
     
     navLinks.forEach(link => {
         link.addEventListener('click', function(e) {
@@ -38,7 +72,43 @@ document.addEventListener('DOMContentLoaded', function() {
             }
         });
         
-        navLinks.forEach(link => {
+        // Update active state for sidebar links
+        const sidebarLinks = document.querySelectorAll('.nav-section-content a');
+        sidebarLinks.forEach(link => {
+            link.classList.remove('active');
+            if (link.getAttribute('href') === `#${current}`) {
+                link.classList.add('active');
+                
+                // Auto-expand the section containing the active link
+                const parentSection = link.closest('.nav-section');
+                if (parentSection) {
+                    const toggle = parentSection.querySelector('.nav-section-toggle');
+                    const content = parentSection.querySelector('.nav-section-content');
+                    
+                    if (!toggle.classList.contains('active')) {
+                        // Collapse other sections
+                        sectionToggles.forEach(otherToggle => {
+                            if (otherToggle !== toggle) {
+                                otherToggle.classList.remove('active');
+                                otherToggle.setAttribute('aria-expanded', 'false');
+                                otherToggle.nextElementSibling.classList.add('collapsed');
+                                otherToggle.querySelector('.toggle-icon').textContent = '▶';
+                            }
+                        });
+                        
+                        // Expand current section
+                        toggle.classList.add('active');
+                        toggle.setAttribute('aria-expanded', 'true');
+                        content.classList.remove('collapsed');
+                        toggle.querySelector('.toggle-icon').textContent = '▼';
+                    }
+                }
+            }
+        });
+        
+        // Also update main nav links
+        const mainNavLinks = document.querySelectorAll('.nav-link[href^="#"]');
+        mainNavLinks.forEach(link => {
             link.classList.remove('active');
             if (link.getAttribute('href') === `#${current}`) {
                 link.classList.add('active');
