save

Signed-off-by: Nikola Hristov <Nikola@PlayForm.Cloud>

Author: NikolaRHristov

README.md

@@ -1,31 +1,67 @@
-<table><tr>
-<td colspan="1"> <h3 align="center"> <picture>
+<table>
+<tr>
+<td align="left" valign="middle">
+<h3 align="left"> SideCar</h3>
+</td>
+<td align="left" valign="middle">
+<h3 align="left">
+ ⚙️ 
+</h3>
+</td>
+<td align="left" valign="middle">
+<h3 align="left">+</h3>
+</td>
+<td align="left" valign="middle">
+<h3 align="left">
+<a href="https://Editor.Land" target="_blank">
+<picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://PlayForm.Cloud/Dark/Image/GitHub/Land.svg">
 <source media="(prefers-color-scheme: light)" srcset="https://PlayForm.Cloud/Image/GitHub/Land.svg">
 <img width="28" alt="Land Logo" src="https://PlayForm.Cloud/Image/GitHub/Land.svg">
-</picture> </h3> </td> <td colspan="3" valign="top"> <h3 align="center"> Sidecar Runtimes ⚙️
-</h3> </td>
-</tr></table>
+</picture>
+</a>
+</h3>
+</td>
+<td align="left" valign="middle">
+<h3 align="left">
+<a href="https://Editor.Land" target="_blank">
+Land
+</a>
+</h3>
+</td>
+<td align="left" valign="middle">
+<h3 align="left">🏞️</h3>
+</td>
+</tr>
+</table>
 
 ---
 
-# **Sidecar Runtimes** ⚙️ Pre-Compiled Native Dependencies
+# **SideCar** ⚙️ Pre-Compiled Native Dependencies for Land 🏞️
+
+Welcome to **SideCar**, the central repository for all pre-compiled,
+platform-specific sidecar binaries required by the **Land Code Editor**
+ecosystem. A "sidecar" is an external, standalone executable that runs alongside
+the main `Mountain` application to provide specialized functionality, such as
+the `Cocoon` extension host which runs on Node.js.
 
-This directory serves as the central repository for all pre-compiled,
-platform-specific sidecar binaries required by the Land Code Editor ecosystem. A
-"sidecar" is an external, standalone executable that runs alongside the main
-`Mountain` application to provide specialized functionality, such as the
-`Cocoon` extension host which runs on Node.js.
+**SideCar** is engineered to:
 
-## Purpose and Structure
+1. **Provide Portable Runtimes**: Vendored Node.js and other runtimes eliminate
+   user dependency requirements.
+2. **Enable Deterministic Builds**: Organized by target triple for build-time
+   binary selection.
+3. **Support Multiple Platforms**: Comprehensive matrix for macOS, Linux, and
+   Windows on x86_64 and aarch64 architectures.
+4. **Automate Download Management**: Automated fetching, caching, and Git LFS
+   management of runtime binaries.
+
+---
 
-To create a truly portable and self-contained application, we cannot rely on the
-user having pre-installed runtimes like Node.js. Instead, we "vendor" these
-runtimes by downloading their official, standalone distributions and storing
-them here.
+## Directory Structure 📁
 
-The directory is organized to allow for deterministic selection by our build
-system:
+The SideCar directory is organized to allow for deterministic selection by the
+build system:
 
 ```
 SideCar/
@@ -48,22 +84,9 @@ SideCar/
 
 The
 [`Download`](https://github.com/CodeEditorLand/SideCar/tree/Current/Source/Download.rs)
-Rust binary in this directory is responsible for populating this structure. It
-fetches the official distributions for various sidecars and platforms and
-organizes them according to the convention above.
-
-The download tool provides:
-
-- **Concurrent Downloads**: Parallel downloading of multiple binaries using
-  Tokio
-- **Intelligent Caching**: Maintains a [`Cache.json`](Cache.json) file to track
-  downloaded versions
-- **Version Resolution**: Automatically resolves major versions to latest patch
-  from nodejs.org
-- **Git LFS Management**: Automatically updates
-  [`.gitattributes`](.gitattributes) for large binary tracking
-- **Platform Matrix**: Supports multiple target triples (x86_64, aarch64 for
-  macOS, Linux, Windows)
+Rust binary is responsible for populating this structure. It fetches the
+official distributions for various sidecars and platforms and organizes them
+according to the convention above.
 
 During the application build, the main `Build.rs` orchestrator uses this
 repository as a source. Based on build flags (e.g., `--node-version=22`), it
@@ -74,15 +97,15 @@ bundling into the final application installer.
 
 ## Key Features 🔐
 
-- **Concurrent Downloads:** Parallel downloading of multiple runtime binaries
+- **Concurrent Downloads**: Parallel downloading of multiple runtime binaries
   using Tokio for maximum throughput.
-- **Intelligent Caching:** Maintains a `Cache.json` file to track downloaded
+- **Intelligent Caching**: Maintains a `Cache.json` file to track downloaded
   versions and avoid redundant downloads.
-- **Version Resolution:** Automatically resolves major versions to latest patch
+- **Version Resolution**: Automatically resolves major versions to latest patch
   from nodejs.org and other sources.
-- **Git LFS Management:** Automatic `.gitattributes` updates for large binary
+- **Git LFS Management**: Automatic `.gitattributes` updates for large binary
   tracking in Git LFS.
-- **Platform Matrix:** Comprehensive support for x86_64 and aarch64
+- **Platform Matrix**: Comprehensive support for x86_64 and aarch64
   architectures across macOS, Linux, and Windows.
 
 ---
@@ -97,7 +120,7 @@ bundling into the final application installer.
 
 ---
 
-## `SideCar` in the Land Ecosystem ⚙️ + 🏞️
+## `SideCar` in the Land Ecosystem ⚙️ + 🏞️
 
 | Component         | Role & Key Responsibilities                                           |
 | :---------------- | :-------------------------------------------------------------------- |
@@ -127,7 +150,7 @@ cargo build --release
 - `serde`/`serde_json`: Cache.json serialization
 - `git2`: Git LFS management
 
-### Usage Pattern
+### Usage Pattern 🚀
 
 The SideCar directory is populated once during project setup:
 
@@ -174,7 +197,7 @@ NodeJSOrg["nodejs.org"]:::external
 OtherRuntimes["Other Runtime Sources"]:::external
 end
 
-subgraph "SideCar ⚙️ (Download Tool)"
+subgraph "SideCar ⚙️  (Download Tool)"
 DownloadBin["Download Binary"]:::sidecar
 CacheJSON["Cache.json"]:::sidecar
 GitLFS[".gitattributes (LFS)"]:::sidecar
@@ -199,9 +222,8 @@ DownloadBin --> TargetTriple
 
 ---
 
-## Deep Dive & Component Breakdown 🔬
+## Deep Dive & Component Breakdown 🔬 To understand how `SideCar`'s download tool works, see the following source
 
-To understand how `SideCar`'s download tool works, see the following source
 files:
 
 - **[`Source/Download.rs`](https://github.com/CodeEditorLand/SideCar/tree/Current/Source/Download.rs)** -
@@ -220,7 +242,7 @@ nodejs.org, and automatic Git LFS management for tracking large binary files.
 | **Related Directory**:
 [`Binary`](https://github.com/CodeEditorLand/Mountain/tree/Current/Binary/README.md)
 
-## License ⚖️
+## License ⚖️
 
 This project is released into the public domain under the **Creative Commons CC0
 Universal** license. You are free to use, modify, distribute, and build upon