Stillpoint-Software · bfarmer67 · Apr 13, 2026 · Apr 13, 2026 · Apr 13, 2026
diff --git a/.github/workflows/deploy-gh-pages.yml b/.github/workflows/deploy-gh-pages.yml
@@ -33,7 +33,7 @@ jobs:
       - name: Build with Jekyll
         uses: actions/jekyll-build-pages@v1
         with:
-          source: ./docs
+          source: ./docs/site
           destination: ./_site
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3

diff --git a/.gitignore b/.gitignore
@@ -403,4 +403,12 @@ FodyWeavers.xsd
 CLAUDE.md
 
 
-.nuget/
+.nuget/
+# Jekyll / GitHub Pages local build
+_site/
+.jekyll-cache/
+.jekyll-metadata
+.sass-cache/
+vendor/
+.bundle/
+docs/site/Gemfile.lock
diff --git a/Hyperbee.XS.slnx b/Hyperbee.XS.slnx
@@ -5,7 +5,7 @@
     <File Path="LICENSE" />
     <File Path="README.md" />
     <File Path="version.json" />
-    <Project Path="docs/docs.shproj" />
+    <Project Path="docs/site/docs.shproj" />
   </Folder>
   <Folder Name="/Solution Items/.github/" />
   <Folder Name="/Solution Items/.github/workflows/">

diff --git a/docs/.todo.md b/docs/.todo.md
diff --git a/docs/site/Gemfile b/docs/site/Gemfile
@@ -0,0 +1,13 @@
+source "https://rubygems.org"
+
+gem "jekyll", "~> 4.3"
+gem "just-the-docs"
+
+group :jekyll_plugins do
+  gem "jekyll-remote-theme"
+  gem "jekyll-include-cache"
+  gem "jekyll-seo-tag"
+  gem "jekyll-relative-links"
+end
+
+gem "webrick", "~> 1.8"
diff --git a/docs/_config.yml → docs/site/_config.yml b/docs/_config.yml → docs/site/_config.yml
diff --git a/docs/cli/cli.md → docs/site/cli/cli.md b/docs/cli/cli.md → docs/site/cli/cli.md
diff --git a/docs/cli/compile.md → docs/site/cli/compile.md b/docs/cli/compile.md → docs/site/cli/compile.md
diff --git a/docs/cli/repl.md → docs/site/cli/repl.md b/docs/cli/repl.md → docs/site/cli/repl.md
diff --git a/docs/cli/run.md → docs/site/cli/run.md b/docs/cli/run.md → docs/site/cli/run.md
diff --git a/docs/debugging.md → docs/site/debugging.md b/docs/debugging.md → docs/site/debugging.md
diff --git a/docs/docs.projitems → docs/site/docs.projitems b/docs/docs.projitems → docs/site/docs.projitems
diff --git a/docs/docs.shproj → docs/site/docs.shproj b/docs/docs.shproj → docs/site/docs.shproj
diff --git a/docs/examples.md → docs/site/examples.md b/docs/examples.md → docs/site/examples.md
diff --git a/docs/extensions.md → docs/site/extensions.md b/docs/extensions.md → docs/site/extensions.md
diff --git a/docs/index.md → docs/site/index.md b/docs/index.md → docs/site/index.md
@@ -120,13 +120,13 @@ performance improvements and enabling dynamic updates without application restar
 complete C# programs. XS is a lightweight parsing engine optimized for expression tree generation and execution.  
 
 #### **Why Use XS Instead of Roslyn for Runtime Execution?** 
-- Enhances Expressions – XS simplifies expression tree creation and management, enabling developers to focus on code, not AST syntax. 
-- Lower Overhead – XS generates and executes expression trees directly, avoiding Roslyn's full compilation pipeline and reducing startup costs.  
-- Optimized for Dynamic Execution – Ideal for rule engines, embedded scripting, and DSLs, where Roslyn's full compilation step is unnecessary.  
-- Expression Tree Native – XS treats code as data, enabling runtime introspection, transformation, and optimization before execution.  
-- Extensible by Design – XS allows custom language constructs, control flow features, and operators, making it an ideal fit for domain-specific scripting.  
+- Enhances Expressions - XS simplifies expression tree creation and management, enabling developers to focus on code, not AST syntax. 
+- Lower Overhead - XS generates and executes expression trees directly, avoiding Roslyn's full compilation pipeline and reducing startup costs.  
+- Optimized for Dynamic Execution - Ideal for rule engines, embedded scripting, and DSLs, where Roslyn's full compilation step is unnecessary.  
+- Expression Tree Native - XS treats code as data, enabling runtime introspection, transformation, and optimization before execution.  
+- Extensible by Design - XS allows custom language constructs, control flow features, and operators, making it an ideal fit for domain-specific scripting.  
 
-XS is **not a Roslyn replacement**—it serves a different purpose: **fast, lightweight, and embeddable runtime execution 
+XS is **not a Roslyn replacement**--it serves a different purpose: **fast, lightweight, and embeddable runtime execution 
 without full compiler overhead**. If you need to compile and analyze full C# programs, Roslyn is the right tool. If 
 you need a small, efficient, and customizable scripting language for runtime execution, or you want to easily generate expression 
 trees, XS is a solid choice.
@@ -169,7 +169,7 @@ Example Extensions:
 
 #### **Debugging**:
 
-XS supports `debug();` statements and line level debugging, allowing users to create debug callbacks and set breakpoints. 
+XS supports `debug();` statements and line level debugging, allowing users to create debug callbacks and set breakpoints. 
 This feature automates a process that is laborious when using manual expression trees.
 
 ```

diff --git a/docs/interactive.md → docs/site/interactive.md b/docs/interactive.md → docs/site/interactive.md
diff --git a/docs/language/async-await.md → docs/site/language/async-await.md b/docs/language/async-await.md → docs/site/language/async-await.md
diff --git a/docs/language/casting.md → docs/site/language/casting.md b/docs/language/casting.md → docs/site/language/casting.md
diff --git a/docs/language/conditionals.md → docs/site/language/conditionals.md b/docs/language/conditionals.md → docs/site/language/conditionals.md
diff --git a/docs/language/config.md → docs/site/language/config.md b/docs/language/config.md → docs/site/language/config.md
diff --git a/docs/language/for.md → docs/site/language/for.md b/docs/language/for.md → docs/site/language/for.md
diff --git a/docs/language/foreach.md → docs/site/language/foreach.md b/docs/language/foreach.md → docs/site/language/foreach.md
diff --git a/docs/language/generics.md → docs/site/language/generics.md b/docs/language/generics.md → docs/site/language/generics.md
diff --git a/docs/language/inject.md → docs/site/language/inject.md b/docs/language/inject.md → docs/site/language/inject.md
diff --git a/docs/language/lambdas.md → docs/site/language/lambdas.md b/docs/language/lambdas.md → docs/site/language/lambdas.md
diff --git a/docs/language/language.md → docs/site/language/language.md b/docs/language/language.md → docs/site/language/language.md
diff --git a/docs/language/loop.md → docs/site/language/loop.md b/docs/language/loop.md → docs/site/language/loop.md
diff --git a/docs/language/method-calls.md → docs/site/language/method-calls.md b/docs/language/method-calls.md → docs/site/language/method-calls.md
diff --git a/docs/language/operators.md → docs/site/language/operators.md b/docs/language/operators.md → docs/site/language/operators.md
diff --git a/docs/language/package-directive.md → docs/site/language/package-directive.md b/docs/language/package-directive.md → docs/site/language/package-directive.md
diff --git a/docs/language/string-interpolation.md → docs/site/language/string-interpolation.md b/docs/language/string-interpolation.md → docs/site/language/string-interpolation.md
diff --git a/docs/language/switch.md → docs/site/language/switch.md b/docs/language/switch.md → docs/site/language/switch.md
diff --git a/docs/language/try-catch-finally.md → docs/site/language/try-catch-finally.md b/docs/language/try-catch-finally.md → docs/site/language/try-catch-finally.md
diff --git a/docs/language/tuples.md → docs/site/language/tuples.md b/docs/language/tuples.md → docs/site/language/tuples.md
diff --git a/docs/language/type-system.md → docs/site/language/type-system.md b/docs/language/type-system.md → docs/site/language/type-system.md
@@ -25,6 +25,6 @@ nav_order: 19
 ## **Type Promotion Rules**
 
 1. Arithmetic operations promote types:  
-   `int` → `float` → `double` → `decimal`.
+   `int` -> `float` -> `double` -> `decimal`.
 2. Null-coalescing (`??`) resolves to the type of the non-null operand.
 3. Conditional expressions (`if-else`) return the common compatible type.
diff --git a/docs/language/using-directive.md → docs/site/language/using-directive.md b/docs/language/using-directive.md → docs/site/language/using-directive.md
diff --git a/docs/language/using-statement.md → docs/site/language/using-statement.md b/docs/language/using-statement.md → docs/site/language/using-statement.md
diff --git a/docs/language/variables.md → docs/site/language/variables.md b/docs/language/variables.md → docs/site/language/variables.md
@@ -1,4 +1,4 @@
----
+---
 layout: default
 title: Variables
 parent: Language

diff --git a/docs/language/while.md → docs/site/language/while.md b/docs/language/while.md → docs/site/language/while.md
diff --git a/docs/language/yield.md → docs/site/language/yield.md b/docs/language/yield.md → docs/site/language/yield.md