docs: add blocks documentation and improve syntax guide

- Add blocks.md with syntax and examples
- Update navigation and remove Next Steps sections

Author: decipher3114

docs/.vitepress/config.mts

@@ -24,6 +24,7 @@ export default defineConfig({
                 items: [
                     { text: "Overview", link: "/syntax-guide/overview" },
                     { text: "Literals", link: "/syntax-guide/literals" },
+                    { text: "Blocks", link: "/syntax-guide/blocks" },
                     { text: "Collections", link: "/syntax-guide/collections" },
                     { text: "Operations", link: "/syntax-guide/operations" },
                     { text: "Functions", link: "/syntax-guide/functions" },

docs/introduction/what-is-resl.md

@@ -21,7 +21,7 @@ RESL is designed to bring programming capabilities to config files, eliminating
 
 - **🔄 Dynamic Configuration**: Variables, functions, and computed values
 - **📝 Familiar Syntax**: Combines the best of JSON, JavaScript, and functional programming
-- **🏗️ Flexible Structure**: Any expression can be top-level, not just objects
+- **🏗️ Flexible Structure**: Any expression can be top-level
 - **📊 Rich Data Types**: Strings, numbers, booleans, lists, and maps
 - **⚡ Powerful Operations**: Binary operations, conditionals, transformations, and more
 
@@ -35,6 +35,14 @@ RESL is ideal for:
 - **Data Generation**: Test data, mock configurations, templated content
 - **API Responses**: Dynamic JSON generation with computed fields
 
+## 🔍 How is RESL Different from a Programming Language?
+
+- Programming languages offer extensive capabilities, often beyond what is needed for configuration.
+- RESL is intentionally restrictive, focusing solely on configuration and serialization tasks.
+- RESL files store data in a structured yet flexible format, designed for clarity and simplicity.
+- During runtime evaluation, RESL processes and computes the data to produce the desired output.
+- This design minimizes the risk of arbitrary code execution, ensuring safer and more predictable behavior.
+
 ## 💡 Philosophy
 
 RESL follows the principle that configuration should be:

docs/introduction/why-resl.md

@@ -21,7 +21,7 @@ RESL addresses the fundamental limitations of traditional configuration formats
 
 **RESL Solutions:**
 
-JSON: Repetitive and verbose
+**Step 1:** RESL can replicate JSON exactly as-is
 
 ```json
 {
@@ -32,19 +32,46 @@ JSON: Repetitive and verbose
 }
 ```
 
-RESL: Variables and computed values
+```resl
+[
+    "services": [
+        [ "name": "auth", "image": "app/auth:v1.2.0", "port": 8080 ],
+        [ "name": "api", "image": "app/api:v1.2.0", "port": 8081 ]
+    ]
+]
+```
+
+**Step 2:** Then enhance with variables to eliminate repetition
+
+```resl
+{
+    version = "v1.2.0";
+    base_port = 8080;
+
+    [
+        "services": [
+            [ "name": "auth", "image": concat("app/auth:", version), "port": base_port ],
+            [ "name": "api", "image": concat("app/api:", version), "port": base_port + 1 ]
+        ]
+    ]
+}
+```
+
+**Step 3:** Add computed values and loops for ultimate flexibility
 
 ```resl
 {
     version = "v1.2.0";
     base_port = 8080;
     services = ["auth", "api"];
 
-    ["services": services > (i, name): [
-        "name": name,
-        "image": concat("app/", name, ":", version),
-        "port": base_port + i
-    ]]
+    [
+        "services": services > (i, name): [
+            "name": name,
+            "image": concat("app/", name, ":", version),
+            "port": base_port + i
+        ]
+    ]
 }
 ```
 
@@ -86,17 +113,17 @@ RESL: Variables and computed values
 
 Variables and computed values eliminate repetition, typically reducing config file sizes by 30-50% compared to JSON.
 
-**Before (JSON - 156 characters):**
+**Step 1: Direct JSON equivalent (RESL - 156 characters):**
 
-```json
-{
-  "db": { "host": "localhost", "port": 5432 },
-  "cache": { "host": "localhost", "port": 6379 },
+```resl
+[
+  "db": [ "host": "localhost", "port": 5432 ],
+  "cache": ["host": "localhost", "port": 6379 ],
   "url": "http://localhost:8080"
-}
+]
 ```
 
-**After (RESL - 98 characters):**
+**Step 2: Enhanced with variables (RESL - 98 characters):**
 
 ```resl
 {host="localhost";["db":["host":host,"port":5432],"cache":["host":host,"port":6379],"url":concat("http://",host,":8080")]}